← Retour à la documentation

Référence de la syntaxe Templite

Templite est le moteur de gabarits de <TextField>, et il est petit exprès. Pas de langage à part à apprendre. Chaque balise est compilée directement en PHP, et le fichier compilé est mis en cache : l'analyse a lieu une fois par modification, pas à chaque requête.

Une variable s'affiche entre accolades : {title}. Un flux se parcourt avec une clause « in » : {item in $articles} ... {end}. « item » est un préfixe de votre choix, qui évite les conflits avec d'autres boucles de la page ; dans la boucle, chaque champ devient {item_title}, {item_date}, etc. Chaque élément reçoit aussi automatiquement {item_id}, sa position dans le flux en partant de zéro.

Les conditions s'écrivent comme du PHP : {if $count > 3} ... {elseif $count == 0} ... {else} ... {end}. La condition est vraiment évaluée en PHP : toute expression valable dans un if classique fonctionne, appels de fonctions compris.

Il reste deux balises. {include 'themes/mytheme/header'} insère un autre gabarit : c'est comme ça qu'un en-tête et un pied de page se partagent entre les pages. Et {?n'importe quel php} passe en PHP brut dans les rares cas où une balise ne suffit pas, par exemple un calcul ponctuel que vous ne voulez pas déplacer dans un fichier contrôleur juste pour afficher une valeur.

Tout est compilé en simple fichier .php dans core/tmp/ : vous pouvez ouvrir un gabarit compilé et voir exactement ce que sont devenues vos balises. Quand une boucle fait des siennes, c'est souvent le plus rapide : oubliez la théorie et lisez le foreach généré.

Pour les attributs HTML et tout texte saisi par un visiteur, utilisez plutôt {=title} : la valeur est alors échappée pour le HTML.