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

<info>
  <link type="guide" xref="index" group="form-contact"/>
  <desc>Activation et configuration du formulaire de contact par courriel</desc>
  <revision pkgversion="20120605" version="1.0" date="10-06-2012" status="final"/>
  <credit type="author">
    <name>Thomas Noël</name>
    <email>tnoël@entrouvert.com</email>
  </credit>
  <credit type="maintainer">
    <name>Pierre Cros</name>
    <email>pcros@entrouvert.com</email>
  </credit>
</info>

<title>Formulaire de contact</title>

<p>
UnivNautes permet d'afficher un formulaire de contact permettant notamment aux
utilisateurs de signaler leurs soucis de connexion. Les informations saisies
dans ce formulaire seront envoyées par courriel à une adresse configurable.
</p>

<p>Le formulaire est accessible sur l'URL <code>https://nom-du-portail/mail</code>.</p>

<figure>
  <title>Formulaire de contact</title>
    <desc>Les choix du champ «votre soucis» sont configurables</desc>
    <media type="image" mime="image/png" src="figures/form-contact.png" >
    </media>
</figure>

<section id="activation-config">
  <title>Activation et configuration du formulaire</title>
  <p>L'activation se fait via des options présentes dans l'onglet «UnivNautes
  UI» de la page «Services / Captive Portal» :</p>

  <terms>

  <item>
  <title>Possible subjects</title>
  <p>Liste des choix possibles pour le champ «Votre soucis» du formulaire.
  Saisir un choix par ligne. Le texte de ce choix formera le sujet du courriel
  envoyé.</p>
  </item>

  <item>
  <title>Recipient</title>
  <p>Adresse électronique qui recevra les courriels. Si ce champ est vide, le
  formulaire ne sera pas activé.</p>
  </item>

  <item>
  <title>Host</title>
  <p>Nom du serveur SMTP qui sera contacté pour l'envoi du message. Si ce champ
  est vide, le formulaire ne sera pas activé.</p>
  </item>

  <item>
  <title>Port</title>
  <p>Port TCP utilisé pour la communication avec le serveur. Par défaut il
  s'agit du port 587 (<em>submission</em>).</p>
  </item>

  <item>
  <title>User</title>
  <p>Si le serveur SMTP nécessite une authentification, indiquer le nom de l'utilisateur ici. Si ce champ est vide, l'authentification ne sera pas utilisée.</p>
  </item>

  <item>
  <title>Password</title>
  <p>Mot de passe de l'utilisateur pour authentification.</p>
  </item>

  <item>
  <title>Use TLS</title>
  <p>Indique que la communication avec le serveur SMTP doit être chiffrée avec
  TLS. En général cette case doit être cochée si l'authentification est
  utilisée.</p>
  </item>

  </terms>

</section>

<section id="verification">
<title>Vérification du bon fonctionnement</title>
<p>Le bon fonctionnement est directement visible, il suffit de se rendre sur la page <code>https://nom-du-portail/mail</code>.</p>
<p>Si le mail n'arrive pas à destination, vérifiez les paramètres de connexion
(notamment le port est 587 par défaut, il se peut que le SMTP ne soit joignable
que par le port 25). Vérifiez aussi qu'aucun pare-feu ne bloque la
communication, y compris cela intégré à UnivNautes au cas où vous l'avez
modifié.</p>
</section>

</page>
