Liste et rôle des balises de template du plugin HomePageMode2 :

  • L'attribut zone :

    Ceci n'est pas à proprement parler une balise, mais un attribut pouvant être ajouté aux balises de la liste des balises du plugin.
    Il est en directe corrélation avec les zones que vous auriez pu spécifier pour les balises que vous avez éditées avec le plugin.
    Exemple : vous avez édité une balise <tpl:Entries> pour homepagemode.html et lors de son paramétrage vous avez spécifié la zone 1. Maintenant, dans ce fichier, la boucle matérialisée par le code suivant sera affectée par ces mêmes paramètres :

      <tpl:Entries zone="1">
    <!-- ici reste du code de la boucle -->
    </tpl:Entries>
  • Titre et description d'un template :

    Les balises de cette serie sont utilisables à n'importe quel endroit du template. Elle peuvent par exemple servir à faire un message d'accueil ou d'introduction pour la page.

    • <tpl:IfTplIntro> </tpl:IfTplIntro>

      Test si il existe un titre ou une description pour le template en cour.

    • <tpl:IfTplIntroTitle> </tpl:IfTplIntroTitle>

      Test si il existe un titre pour le template en cours.

    • <tpl:IfTplIntroDesc> </tpl:IfTplIntroDesc>

      Test si il existe une description pour le template en cours.

    • {{tpl:TplIntroTitle}}

      Affiche le titre du template en cours.

    • {{tpl:TplIntroDesc}}

      Affiche la description du template en cours.

    On retrouve ces balises dans le fichier homepagemode.html, c'est le bloc de code suivant :

      <tpl:IfTplIntro>
    <div class="post intro homepagemode">
    <tpl:IfTplIntroTitle>
    <h2 class="post-title">{{tpl:TplIntroTitle encode_html="1"}}</h2>
    </tpl:IfTplIntroTitle>
    <tpl:IfTplIntroDesc>
    <div class="post-content">{{tpl:TplIntroDesc}}</div>
    </tpl:IfTplIntroDesc>
    </div>
    </tpl:IfTplIntro>
  • Titre et description d'un tag :

    Cette série de balises est utilisable dans le contexte d'une balise de template ( de type bloc ).
    Elles servent  à afficher le titre et la description que vous auriez éventuellement assignés à une balise, de zone déterminée et pour le template en cours.

    • <tpl:IfTagTitleOrDesc> </tpl:IfTagTitleOrDesc>

      Test si il existe un titre ou une description pour la balise de template en cours.

    • <tpl:IfTagTitle> </tpl:IfTagTitle>

      Test si il existe un titre pour la balise de template en cours.

    • <tpl:IfTagDesc> </tpl:IfTagDesc>

      Test si il existe une description pour la balise de template en cours.

    • {{tpl:TagTitle}}

      Affiche le titre de la balise de template en cours.

    • {{tpl:TagDesc}}

      Affiche la description de la balise de template en cours.

    • <tpl:IfTagZoneId> </tpl:IfTagZoneId>

      Test si il existe un identifiant pour la balise de template en cours.

    • {{tpl:TagZoneId}}

      Affiche l'identifiant de la balise de template en cours.
      A noter que cet identifiant est constitué de la concaténation du nom de la balise avec l'identifiant numérique de son attribut zone, par exemple, pour une balise <tpl:Entries zone="1">, l'identifiant sera Entries1.

    L'exemple suivant montre comment utiliser ces balises dans une boucle de billets :

      <tpl:Entries zone="1">

    <tpl:EntriesHeader>

    <tpl:IfTagTitleOrDesc>
    <div class="post zone {{tpl:TagZoneId}}">
    <tpl:IfTagTitle>
    <h2 class="post-title">{{tpl:TagTitle encode_html="1"}}</h2>
    </tpl:IfTagTitle>
    <tpl:IfTagDesc>
    <div class="post-content">{{tpl:TagDesc}}</div>
    </tpl:IfTagDesc>
    </div>
    </tpl:IfTagTitleOrDesc>

    </tpl:EntriesHeader>

    </tpl:Entries>
  • Zones context :

    • <tpl:IfZonesContext tag="TagName" zone="n"> </tpl:IfZonesContext>

      Cette balise possède deux attributs obligatoires : tag qui prend pour valeur la balise qu'elle encadre, et zone qui prend pour valeur l'identifiant numérique de la zone de la balise encadrée.
      Pour expliquer son rôle, un exemple sera plus simple à comprendre :

        <tpl:IfZonesContext tag="Entries" zone="1">
      <tpl:Entries zone="1">
      <!-- ici reste du code de la boucle -->
      </tpl:Entries>
      </tpl:IfZonesContext>

      Sur cet exemple, la balise permet de déterminer si l'on entre ou pas dans la boucle. On n'y entre en fait que si la zone 1 a bien été paramétrée dans l'admin du plugin pour le tag <tpl:Entries>, sinon la boucle sera ignorée.

  • Pagination vers les billets :

    • {{tpl:BlogFirstPageURL}}

      Affiche l'url de la page/1 du blog. Utilisable uniquement sur le fichier homepagemode.html. Cette balise est présente dans le fichier une première fois dans la partie head du template avec ce code :

      <link rel="Start" href="{{tpl:BlogFirstPageURL}}" title="{{tpl:lang Entries}}" />
      et une deuxième fois vers la fin de celui-ci, sur cette ligne de code :
      <p class="pagination"><a href="{{tpl:BlogFirstPageURL}}">{{tpl:lang Entries}} &#187;</a></p>

      C'est le lien Billets » que vous voyez apparaitre sur votre nouvelle page d'accueil si vous avez activé le mode du plugin, et qui permet de faire la jonction avec la première page du flux normal des billets du blog. La page ainsi liée est en fait votre ancienne page d'accueil qui est desservie par le template home.html.
      Ces deux lignes de code peuvent être supprimées si vous ne voulez plus utiliser et afficher ce mode.