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

<info>
  <link type="guide" xref="admin-administrateurs"/>
  <desc>Permet le paramétrage de l'application par les administrateurs.</desc>
  <revision pkgversion="1.0" version="1.0" date="2012-04-30" status="final"/>
  <credit type="author">
    <name>Pierre Cros</name>
    <email>pcros@entrouvert.com</email>
  </credit>
</info>

<title>Paramétrage de l'application</title>

<p>Les administrateurs gèrent les paramètres du site tels que les modèles de mail et la liste des types d'offres.</p>

<section id="modeles-mails">
  <title>Modèles de mail</title>

<figure>
  <title>Exemple de contenu d'un email</title>
  <desc>Les variables entre [] sont remplacées par leur valeur pour chaque destinaire du courriel.</desc>
  <media type="image" mime="image/png" src="figures/modifier-modele-email.png" >
  </media>
</figure>

  <p>Les modèles de mail peuvent être édités dans la liste des modèles en cliquant sur le nom du modèle. Cela permet de définir :</p>
  <list>
    <item><p>Le nom</p></item>
    <item><p>Le sujet du mail</p></item>
    <item><p>Le contenu du mail</p></item>
  </list>
  <p>Le contenu se présente sous la forme d'un texte de ce type :</p>
  <code>
  Vous venez d'inscrire votre email {{email}} sur {{host}}.

  Il est nécessaire de confirmer cet email pour que votre
  compte soit créé.

  Pour cela veuillez entrez le code {{ jeton }} sur la page
  Web suivante:

    {{ confirmation_url }}

  ou bien recopiez le lien suivant dans la barre d'adresse
  de votre navigateur:

    {{ jeton_url }}
  </code>
  
  <p>Le texte contient des variables, identifiables parcequ'elles débutent par deux accolades ouvrantes et se terminent par deux accolades fermantes. Ces variables sont remplacées, dans le mail envoyé, par la valeur adéquate. Les variables que l'on peut utiliser dans les modèles de mail sont les suivantes :</p>
<list>
  <item><p>{{email}} : adresse courriel de l'utilisateur.</p></item>
  <item><p>{{host}} : site de l'application logement.</p></item>
  <item><p>{{jeton}} : code permettant l'inscription lors de la création d'un compte.</p></item>
  <item><p>{{confirmation_url}} : URL permettant à l'utilisateur d'entrer son jeton.</p></item>
  <item><p>{{jeton_url}} : URL permettant à l'utilisateur de créer directement son compte.</p></item>
  <item><p>{{base_url}} : URL de base de l'application.</p></item>
  <item><p>{{message}} : message laissé par un étudiant à un propriétaire.</p></item>
  <item><p>{{annonce.prix_par_mois}} : loyer mensuel d'une annonce.</p></item>
  <item><p>{{annonce.type}} : type de l'annonce.</p></item>
  <item><p>{{annonce.ville}}: ville de l'annonce.</p></item>
  <item><p>{{raison}} : motif du rejet d'une annonce.</p></item>

</list>

</section>

<section id="liste-type-offre">
  <title>Liste des types d'offres</title>
  <p>La liste des types disponibles pour typer une annonce peut-être éditée par l'administrateur. Après avoir cliqué sur « types d'offres », il peut supprimer les types disponibles, en ajouter avec le bouton prévu à cet effet, ou les éditer en cliquant sur leur nom.</p>

<figure>
  <title>Types d'offres</title>
  <media type="image" mime="image/png" src="figures/types-offres.png" >
  </media>
</figure>

</section>

<section id="liste-type-offre">
  <title>Liste des types de prestations</title>
  <p>La liste des prestations disponibles pour une annonce peut-être éditée par l'administrateur. Après avoir cliqué sur « types de prestations », il peut supprimer les types disponibles, en ajouter avec le bouton prévu à cet effet, ou les éditer en cliquant sur leur nom.</p>

<figure>
  <title>Types d'offres</title>
  <media type="image" mime="image/png" src="figures/types-prestations.png" >
  </media>
</figure>

</section>

</page>
