Les gabarits HTML de page et de module

Une page sur Meabilis est composée de HTML et de CSS. Nous appellerons gabarit la partie HTML de ces pages. Ceci est un guide d'introduction aux notions de "tokens" et de "section" Meabilis dans les gabarits.

Les gabarits de page sont accessibles via l'interface d'administration, rubrique personnalisation avancée du thème. Un seul gabarit est, la plupart du temps, proposé pour chaque type de page (page web, page agenda, page produit : pour en savoir plus sur les types de page, lisez le guide "Qu'est-ce qu'un type de page").

TOKENS

A ces gabarits de page, généralement au format HTML5, viennent s'ajouter des mots-clefs que nous appellerons « tokens ». Ces tokens, spécialement créés pour l'outil de création de site Meabilis vont permettre d’interagir de manière dynamique avec le contenu du site (données de la page, textes, modules). Par exemple, grâce au token "pagesMetaTitle" entouré de doubles crochets, nous pourrons remplir la balise <title> de notre page.

Syntaxe :
(Les tokens peuvent prendre des options, mais ce sera l'objet d'un prochain guide)

Voici quelques tokens qui peuvent vous être utiles dans un gabarit de page :

• pagesMetaDescription : meta-description de la page
• pagesMetaKeywords : meta-mots clefs de la page
• pagesCssClasses : classes CSS de la page
• pagesLastUpdate : date de dernière mise à jour de la page
• parentLabel: nom de la page parente
  

Sachez que chaque module comporte ses propres tokens (menus, lecteur de flux, galerie, etc.). Leurs gabarits sont aussi modifiables via l'interface d'administration.
Quelques exemples :

• mediaLabel : Libellé d'un média, utilisable dans un gabarit de galerie
•  thumbs/x/ : le chemin vers le fichier média, dans un module de galerie
  
• pagesUrl, adresse d'une page, utilisable à l'intérieur d'une balise <loop> dans un gabarit de module menu
  

Les modules sont affichés grâce aux sections Meabilis.

SECTION

Les mots clé « mbSection » rencontrés dans un gabarit permettent de définir les « espaces à modules ». Généralement un thème Meabilis contient les sections suivantes :

• header : {mbSection name="header"}, l'entête de page
• colSub : {mbSection name="colSub"}, la colonne secondaire
• colMain : {mbSection name="colMain"}, la colonne principale
• footer : {mbSection name="footer"}, le pied de page

C'est dans ces aires que vous pourrez ajouter, supprimer et organiser les modules de votre page via la partie édition de votre site. La suppression ou la modification de ces aires n'est toutefois pas conseillée.

 

Commentaires