Les tags de travail XML génériques ne sont propres ni aux rangées de contenu, ni aux modèles de pages : vous pouvez les employer indistinctement dans l'un et l'autre.
Afficher le contenu du tag si la condition est remplie :
<atm-if what="condition"> ... </atm-if>
- condition : Condition à remplir pour afficher le contenu du tag. L'usage courant est de valider la présence d'une valeur non nulle. Cette condition peut aussi prendre toutes les formes valides d'une condition PHP (voir : Les structures de contrôle en PHP). La condition sera remplie si la valeur existe ou bien n'est pas nulle ou bien n'est pas égale à faux (false).
Un attribut name (facultatif) peut être ajouté si vous souhaitez exécuter la condition contraire (else) à l'aide d'un tag atm-else (voir ci-dessous). Cet attribut ne peut contenir que des caractères alphanumériques (a-zA-Z0-9_.-).
<atm-else for="if-name"> ... </atm-else>
- for : nom alphanumériques du tag atm-if de référence. Le contenu de ce tag ne sera affiché que si la condition du tag atm-if de référence n'est pas remplie.
Un attribut what (facultatif) peut-être ajouté si vous souhaitez ajouter une condition supplémentaire pour afficher le contenu de ce tag. L'usage courant est de valider la présence d'une valeur non nulle. Cette condition peut aussi prendre toutes les formes valides d'une condition PHP (voir : Les structures de contrôle en PHP). La condition sera remplie si la valeur existe ou bien n'est pas nulle ou bien n'est pas égale à faux (false).
Assigner une valeur à une variable :
<atm-setvar vartype="type" varname="name" value="varValue" />
- type : Type de la variable à assigner : request, session ou var.
- name : Nom de la variable à assigner. Attention, réassigner une variable existante supprimera l'ancienne valeur.
- varValue : valeur à assigner à la variable.
Créer un tag XHTML ouvrant ou fermant
Dans certains cas de figures, il peut être intéressant de pouvoir créer un tag XHTML ouvrant ou fermant à l'intérieur d'un autre tag (une condition par exemple). Or ce cas de figure casse la syntaxe XML. Dans ce cas, vous pouvez employer les deux tags suivants :
<atm-start-tag tag="tagName" />
- tag : Nom du tag ouvrant à afficher.
- Vous pouvez ajouter ensuite autant d'attributs supplémentaires que vous le souhaitez, ils seront tous ajoutés au tag généré.
<atm-end-tag tag="tagName" />
- tag : Nom du tag fermant à afficher.
Exemple :
Votre rangée comporte le code suivant :
<atm-if what="condition1">
<atm-start-tag tag="div" class="class1" />
</atm-if>
<atm-if what="condition2">
<atm-start-tag tag="div" class="class2" />
</atm-if>
... du contenu XHTML ...
<atm-tag-end tag="div" />
Si la condition 1 est remplie, vous obtiendrez le code suivant :
<div class="class1">
... du contenu XHTML ...
</div>
Titre de la page courante :
<atm-title />
Valeurs de la page courante :
<atm-page name="dataName" />
- dataName : Nom de la valeur de la page à afficher. Les valeurs suivantes sont supportées :
- id : identifiant de la page courante.
- url : adresse de la page courante.
- title : titre de la page courante (équivalent du tag <atm-title />).
- linktitle : titre du lien vers la page courante.
- codename : nom de code de la page courante (si il existe).
- keywords, description, category, author, replyto, copyright, language, robots, pragma, refresh, metas : Méta-données de la page courante.
Valeurs du site courant :
<atm-website name="dataName" />
- dataName : Nom de la valeur du site à afficher. Les valeurs suivantes sont supportées :
- root : identifiant de la page racine du site courant.
- domain : nom de domaine du site courant.
- title : titre du site courant.
- codename : nom de code du site courant.
- keywords, description, category, author, replyto, copyright, language, robots, favicon, metas : Méta-données du site courant.
Affichage dans l'administration :
<atm-admin> ... </atm-admin>
Le contenu de ce tag ne sera visible que si on se trouve dans l'administration d'Automne.
<atm-noadmin> ... </atm-noadmin>
Le contenu de ce tag ne sera pas visible si on se trouve dans l'administration d'Automne.
Affichage dans l'édition de page :
<atm-edit> ... </atm-edit>
Le contenu de ce tag ne sera visible que si on se trouve en cours d'édition de la page, dans l'administration d'Automne.
<atm-noedit> ... </atm-noedit>
Le contenu de ce tag ne sera pas visible si on se trouve en cours d'édition de la page, dans l'administration d'Automne.