<page xmlns="http://projectmallard.org/1.0/"
      type="topic" id="misc-ezt" xml:lang="fr">

<info>
  <revision docversion="0.1" date="2013-07-06" status="draft"/>
  <credit type="author">
    <name>Frédéric Péters</name>
    <email>fpeters@entrouvert.com</email>
  </credit>

</info>

<title>Mécanique de template</title>

<p>
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.
</p>

<example>
<code>
Bienvenue [session_user_display_name],

Toute l'équipe de [site_name] vous remercie de votre inscription
et vous souhaite une agréable visite.
</code>
</example>

<p>
À l'usage, les contenus proposés entre crochets seront substitués, pour donner
le résultat suivant :
</p>

<example>
<code>
Bienvenue <var>Lætitia</var>,

Toute l'équipe de <var>Quizz du jour</var> vous remercie de votre inscription
et vous souhaite une agréable visite.
</code>
</example>

<p>
Il est également possible d'afficher du contenu de manière conditionnelle,
en utilisant la syntaxe <code>[if-any variable]...[end]</code> ou
<code>[if-any variable]...[else]...[end]</code> pour vérifier la présence
d'une valeur dans <var>variable</var>.
</p>

<example>
<code>
Pour rappel, voici les renseignements que vous nous avez fournis :

[if-any form_var_regime_alimentaire]
 - Régime alimentaire : [form_var_regime_alimentaire]
[else]
 - Aucun régime alimentaire précisé.
[end]
</code>
</example>

<p>
Pour tester non pas la présence d'une valeur mais le contenu de celle-ci, la
syntaxe est <code>[is variable valeur]...[end]</code>, avec également la
possibilité d'un <code>[else]</code>.
</p>

<example>
<code>
Pour toute information complémentaire, n'hésitez pas à nous contacter au
numéro [is form_var_pays "France"]0800 123 456[else]+33 1 1234 5678[end].
</code>
</example>

<note><p>
Pour plus d'informations, il existe une
<link href="https://github.com/gstein/ezt/blob/wiki/Syntax.md#directives">référence
détaillée</link> sur le système de template (en anglais).
</p></note>

</page>
