Mécanique de gabarits

De nombreux éléments permettent l’utilisation d’un système simple permettant de générer du contenu variant suivant certaines données. L’exemple le plus simple peut être le contenu d’un courriel, dans lequel l’utilisateur se voit souhaiter la bienvenue.

Bienvenue {{session_user_display_name}},

Toute l’équipe de {{site_name}} vous remercie de votre inscription
et vous souhaite une agréable visite.

À l’usage, les contenus proposés entre crochets seront substitués, pour donner le résultat suivant :

Bienvenue Lætitia,

Toute l’équipe de Quizz du jour vous remercie de votre inscription
et vous souhaite une agréable visite.

Il est également possible d’afficher du contenu de manière conditionnelle, en utilisant la syntaxe {% if variable %}...{% endif %} ou {% if variable %}...{% else %}...{% endif %} pour vérifier la présence d’une valeur dans variable.

Pour rappel, voici les renseignements que vous nous avez fournis :

{% if form_var_regime_alimentaire %}
 - Régime alimentaire : {{form_var_regime_alimentaire}}
{% else %}
 - Aucun régime alimentaire précisé.
{% endif %}

Pour tester non pas la présence d’une valeur mais le contenu de celle-ci, la syntaxe est {% if variable == valeur %}...{% endif %}, avec également la possibilité d’un {% else %}.

Pour toute information complémentaire, n’hésitez pas à nous contacter au
numéro {% if form_var_pays == "France" %}0800 123 456{% else %}+33 1 1234 5678{% endif %}.

Pour plus d’informations la syntaxe utilisée est celle des gabarits Django, il en existe une documentation détaillée en ligne.

Précemment un autre langage de description des gabarits était utilisé (EZT), caractérisé par l’utilisation de crochets (ex: [form_var_email]), il est toujours disponible mais désormais déconseillé; pour mémoire sa référence détaillée (en anglais) est toujours en ligne.