Cette partie explique comment ajouter une rangée de positions de modules au famework Gantry et au template Gantry que vous utilisez.

 

 

Visionnez ce screencast rapide sur les Positions de Module pour obtenir un aperçu de leur fonctionnement au sein de Joomla et du framework Gantry.

 

 

Etape 1: Être prêt !

Déterminez le nom de la position et de l'emplacement de votre template dans lequel vous souhaitez que votre nouvelle position de "ligne de modules" apparaîsse. Dans notre exemple, nous allons utiliser "exemple".

Etape 2: Ajouter une position à index.php

Ouvrez le fichier index.php dans votre template et allez à l'endroit où vous souhaitez ajouter votre nouvelle position de "ligne de modules". En utilisant $gantry Nous allons faire un appel à l'objet à l'aide de la fonction displayModules(positionname,modulelayouttype,modulechromelayout); Cet appel aura besoin d'être affiché (fonction echo).

Exemple:

    <div id="rt-exempleposition">
    <?php echo $gantry->displayModules('exemple','standard','standard'); ?>
    <div class="clear"></div>
    </div>

La position s'affichera maintenant dès que nous aurons configuré la partie Gantry de le reconnaître. D'ici-là, il ne fonctionnera pas correctement.

Etape 3: Ajouter une position au Framework Gantry

Ouvrez templateDetails.xml et descendez jusqu'au balises "positions" où les positions de Gantry par défaut sont répertoriées. En dessous, nous devrons ajouter nos positions de "ligne de modules" de a à f comme dans l'exemple ci-dessous:

    <position>exemple-a</position>
    <position>exemple-b</position>
    <position>exemple-c</position>
    <position>exemple-d</position>
    <position>exemple-e</position>
    <position>exemple-f</position>

Ensuite, ouvrez template-options.xml et descendez jusqu'à la ligne qui dit:

<fieldset name="layouts" label="LAYOUTS">

C'est là que nous ajoutons notre nouveau curseur de position pour nos layouts. Nous devons ajouter le bloc xml suivant pour le faire apparaîttre dans le Gestionnaire des templates.

    <fields name="exemple" type="position" label="Example" description="LAYOUT_POS_DESC">
    <field name="layout" type="positions" default="3,3,3,3" label="">
    <schemas>1,2,3,4,5,6</schemas>
    <words>2,3,4,5,6,7,8,9,10</words>
    </field>
    <field name="showall" type="toggle" default="0" label="FORCE_POS"/>
    <field name="showmax" type="showmax" default="6" label="POS_COUNT"/>
    </fields>

 

  • name - nom de la position
  • type - doit toujours être "position"
  • default - layout par défaut pour la ligne de module : toute combinaison de 12 séparés par des virgules.
  • label - Etiquette dans Template Manager pour ce module.
  • description - Description de l'utilisation de cette zone.

Etape 4: Assigner les Modules

Les nouvelles positions devraient être maintenant disponibles dans le gestionnaire de modules et des modules peuvent désormais y être affectés. Une fois assignés, ils apparaîtront sur votre template comme tout autre module de Gantry.