<page xmlns="http://projectmallard.org/1.0/"
      type="guide" style="task"
      id="admin-mail" xml:lang="fr">

<info>
 <link type="guide" xref="admin-admin"/>
  <desc>Définition des modèles des courriels envoyés aux utilisateurs depuis l'application.</desc>
</info>

<title>Modèles des courriels</title>

<p>Les courriels personnalisés expédiés aux utilisateurs depuis l'application sont paramétrables. Pour pouvoir définir leur canevas ou en créer un nouveau il faut cliquer sur « Notifications par mail ».</p>

<figure>
  <title>Liste des modèles de courriels</title>
  <media type="image" mime="image/png" src="figures/liste-courriels.png" >
  </media>
</figure>

<p>Un clic sur le nom d'un modèle permet de l'éditer.</p>

<figure>
  <title>Édition d'un modèle de courriel</title>
  <media type="image" mime="image/png" src="figures/edition-courriel.png" >
  </media>
</figure>

<p>Le modèle comprend les éléments suivants :</p>
<list>
  <item><p>Action : l'action qui va déclenccher automatiquement l'envoi du courriel.</p></item>
  <item><p>Destinaire du mail : qui va recevoir le mail.</p></item>
  <item><p>Template du sujet : ce qui va apparaître dans le sujet du mail reçu par l'utilisateur.</p></item>
  <item><p>Template du corps du mail : ce qui va apparaître dans le corps du mail reçu par l'utilisateur.</p></item>
</list>


<p><em style="strong">Modifier</em> : Un clic sur l'ID du courriel permet de le modifier.</p>
<p><em style="strong">Ajouter</em> : Un clic sur le bouton « Ajouter Notification par mail » permet de créer un nouveau modèle.</p>
<p><em style="strong">Supprimer</em> : Après sélection du modèle grâce à la case à cocher, choisir « Supprimer les Notifications par mail sélectionnées » dans la liste déroulante en bas à gauche de l'écran permet de le supprimer.</p>

<section>
  <title>Variables dans les templates</title>
  <p>En dessous de chaque modèle de mail figure une « Aide pour les templates » qui liste l'ensemble des variables utilisables dans le sujet ou dans le corps du mail. Ces variables sont remplacées dans le message envoyé par une valeur relative à l'utilisateur ou à la demande concernée. Par exemple le template :</p>
<code>« Bonjour <em style="strong">{{actor}}</em>, nous avons bien reçu la demande <em style="strong">{{request.id}}</em> »</code>
<p> enverra à l'utilisation Pierre Dupont qui a fait la demande 226 :</p>
<code>Bonjour <em style="strong">Pierre Dupont</em>, nous avons bien reçu la demande <em style="strong">226</em></code>
</section>

</page>
