Variables de template

par Ea Lun 25 Mar 2013 - 1:13

Variables de template

Ce tutoriel donne des informations sur l'utilisation des variables dans le cadre de la modification de template.

Type de structure

Il y a deux différents types de structure pour l'utilisation des variables dans les templates.

Structure d'affichage :

Code:: {NOM_DE_LA_VARIABLE}

Cette structure est remplacée par la valeur de la variable.

Structure de boucle :

Code::  contenu

Cette structure est remplacée par son contenu pour chaque valeur de la variable.

Attribut de valeur

Dans une structure de boucle, la valeur sur laquelle on boucle et ses attributs éventuels sont utilisables dans le contenu de la boucle.
Un attribut peut être utilisé dans :

une structure de boucle en utilisant directement le nom de l'attribut, la structure sera remplacée pour chaque valeur de l'attribut qui sera utilisable dans le contenu de la boucle.
une structure d'affichage en utilisant le nom de l'attribut préfixé des noms des attributs parents et de la variable séparés par des caractères point.

Par exemple les valeurs de la variable variable_ligne pourraient avoir un attribut attribut_case dont les valeurs ont elles-mêmes un attribut MESSAGE

On aurait alors par exemple quelque chose de ce genre pour afficher le tableau :

Code:: <table>  <tr>  <td>{variable_ligne.attribut_case.MESSAGE}</td>  </tr>  </table>

Vous pouvez voir par ici les templates et les variables qu'on peut y utiliser.

Signification d'une variable

Il y a plusieurs moyens de trouver la signification d'une variable.

Par son nom :
Le nom de la variable est très souvent en anglais. Le traduire peut souvent aider à deviner ce que la variable représente, vous pouvez par exemple chercher la signification d'un mot anglais sur ce site.

Dans le nommage des variables, il y a également quelques constances utiles à connaitre :

L_ en début d'une variable indique que la variable en question est une ligne de texte traduite dans la langue dans laquelle le visiteur parcours le forum.
U_ en début d'une variable d'affichage indique que la variable en question est une adresse url.
switch_ en début du nom d'une variable indique que le contenu sera affiché une ou zéro fois ( souvent en fonction de la valeur d'une option dans le panneau d'administration ).

Par sa page :
Toutes les variables de template sont listées ici.

Pour une partie de ces variables, une description qui pourrait vous suffire est disponible sur la page de la variable.

Par test :
Dans le cas où les deux moyens précédents n'ont pas suffit, il est possible :

d'éditer le template
de mettre des délimiteurs (ex : AAAAA) avant la variable et (ex : BBBBB) après
d'enregistrer et publier le template
d'aller voir ce qu'il y a entre AAAAA et BBBBB sur le forum

Si vous trouvez quelque chose d'intéressant qui n'est pas sur la page de la variable, n'hésitez pas à l'ajouter à sa description.