Eclydre Web Manager > Développeur > Les gabarits > Gabarit de type contenus

Gabarit de type contenus

Le gabarit de type contenus est le gabarit qui se charge d'afficher les contenus contribués dans l'outil d'administration d'ewm. Ce gabarit est sélectionné soit au niveau d'une rubrique, soit au niveau d'une page et s'applique de façon récursive. Ainsi toutes les sous rubriques et les pages auront le même gabarit de contenus à moins qu'il ne soit redéfini à un moment donné dans l'arborescence. Le gabarit de type contenus est chargé par le gabarit de type page lors de la génération des pages par tt_content. Son contenu remplace le marker  #[CONTENT]# du gabarit de type page.

Création du fichier HTML

Le gabarit de type contenus est un fichier HTML contenant un certain nombre de markers sous la forme #[MON_MARKER]#. Un marker dans le gabarit de type contenus sera remplacé à la génération des pages soit par le contenu généré par un fichier php situé dans l'un des dossiers marker/ de l'ewm, soit par le contenu d'une zone définie dans l'admin, zone qui portera le même nom que le marker (voir ci-après).
Les gabarits de type contenus doivent être stockés dans le dossier template/ ou dans un sous dossier de template/.

Exemple : html du gabarit de type contenus content.html du site d'ewm

<!-- CONTENT -->

<div class="wrapper1">
#[WRAPPER1]#
</div>
<div class="wrapper2">
#[SSMENU]#
#[WRAPPER2]#
</div>

Création du gabarit de type contenus dans l'admin

voir le média:Création du gabarit de type contenus dans l'admin
  1. Sélectionner le menu administration > gabarits dans l'admin ewm.
  2. Créer un nouvel enregistrement.
Une fois le formulaire rempli et enregistré il reste à appliquer ce gabarit à une rubrique (et donc à ces sous rubriques et ces pages) ou à une page du site et à l'associer à un gabarit de type page.

Détails du formulaire

voir le média:Détails du formulaire
nom nom du gabarit de type contenus
ce nom est utilisé dans les listes déroulantes des entêtes de rubrique et de page
fichier le nom du fichier html
ce fichier doit se trouver dans le dossier template/ ou dans un sous dossier de template/ ; dans le cas où  le fichier html se trouve dans un sous dossier de template/ il faut dans ce champ indiquer le path vers le fichier à partir du dossier template/ (exemple : mon_dossier/content.html)
type contenus
css
l'éventuelle feuille de style associée au gabarit de contenus
le path absolu doit être donné dans le champ (exemple #[CONFIG{data=absolute_path}]#template/css/styles.css)
cette feuille de style sera chargée à la place du marker #[CONTENT_CSS]# qui devra être présent dans le gabarit de type page (dans le cas ou le header html des pages se trouve dans ce gabarit) ou dans le gabarit de type contenus (dans le cas ou le gabarit de type page ne sert qu'à charger les gabarits de type contenus et que le header html se trouve dans ces derniers)
 zones contenus
ce sont les zones qui seront visibles dans le formulaire d'édition d'une page par les contributeurs.
à chacune de ces zones correspond un marker dans le gabarit html
à la génération des pages par tt_content.php ce marker sera alors remplacé par les contenus saisis dans le formulaire page, dans la zone correspondante

Détails du formulaire gabarit > zones de contenus

voir le média:Détails du formulaire gabarit > zones de contenus
position les flèches permettent de modifier l'ordre des zones dans le formulaire d'édition d'une page de l'admin
code ce code correspond au marker du gabarit html
ainsi les contenus saisis dans zone qui porte le code WRAPPER1 remplaceront le marker #[WRAPPER1]# inséré dans le gabarit html
ce code sert également à nommer la zone dans le formulaire d'édition d'une page : un code équivalent est créé dans l'administration des textes d'interface
accès concurrent coché, les contenus de la zone dans le formulaire d'édition d'une page ne s'affichent plus sous forme de blocs empilés mais sous forme de liste.
ce mode est particulièrement recommandé pour des zones avec un nombre important de contenus.
max. item permet de limiter le nombre de contenus pouvant être insérés dans une zone
wrap item
l'html ajouté autour de chaque contenu à la génération des pages par tt_content.php
exemple : <div class='item'>#[ITEM]#</div>
(voir la partie concernant les wrap de types de contenus)
wrap all
l'html ajouté autour de la zone complète à la génération des pages par tt_content.php
exemple : <div class='item'>#[ITEMS]#</div>
(voir la partie concernant les wrap de types de contenus)
types valides
les types de contenus que le contributeur pourra insérer dans cette zone sur le formulaire d'édition d'une page
cette liste ordonnée correspond à la liste type présente dans chaque bloc
(voir la partie concernant les types de contenus)