Formulaires Sécurisés avec mail.fcgi

mail.fcgi est une simple application d'envoi de courrier électronique, utile pour ajouter à votre site web un formulaire similaire au notre. mail.fcgi garde les adresses électroniques dans une base de données interne, vous n'avez donc pas à les publier dans votre source HTML. mail.fcgi permet également de faire suivre des champs de données arbitraires simplement en ajoutant les contrôles à votre HTML.

Sécurité et confidentialité

Pour autant que l'adresse de destination est hébergés sur un de nos serveurs, le message sera livré de façon sécurisée (sans aucun transit par des réseaux potentiellement non-sécurisés). Si le service SSL est disponible pour votre plan d'hébergement, on recommande d'appeller mail.fcgi via https://, pour que le message soit transmit sécuritairement du client à la destination finale.

Installation de mail.fcgi

Depuis votre shell, installez l'application comme suit:

  $ cp -R /var/www/mail.fcgi ~/www/my-mailer

Les fichiers source HTML (extension *.htm) se trouvent dans le répertoire html/. Les fichiers de patron principaux se trouvent dans html/m4/ et ont l'extension *.m4. Si vous êtes familiers avec XSLT, vous pouvez ajouter des feuilles de style XSLT dans html/xsl/. Après avoir modifié ces fichiers à l'aide de votre éditeur texte, n'oubliez pas d'exécuter make dans html/ afin de regénérer les documents (le code HTML final est généré par m4 et xsltproc). N'éditez pas les fichiers *.html.*, car ils sont générés automatiquement pour diverses langues et encodages.

  $ cd html
  $ $EDITOR *.htm
  $ make

Pour insérer des nouveaux champs d'information (dont le contenu sera ajouté à la fin du courrier), il suffit de créer un formulaire HTML avec un nom qui commence par "f_". Par exemple, pour ajouter un champs « Num. de commande », vous rajouteriez à default.html le code suivant:

    Num. de commande: <input type=text name="f_NumCommande">

Par la même méthode, vous pouvez insérer des en-têtes de type "X-Foo" au courrier final. Cela peut être pratique lorsque le récipient utilise la classification de courrier:

  Send to department:
  <select name="x_Department">
    <option value="Technical Department">
    <option value="Billing Department">
    <option value="Department of Apocalyptic Affairs">
  </select>

Configurer les récipients

Le fichier etc/recipients spécifie les adresses électroniques pour la livraison. Ouvrez ce fichiers dans votre éditeur texte favori.

  #
  # Format:
  # (key):(language):(email-address):(description)
  #
  sales-en:en:sales@my-domain:Sales department
  sales-fr:fr:sales@my-domain:Département des ventes
  tech-en:en:tech@my-domain:Technical department
  tech-fr:fr:tech@my-domain:Département technique

Les champs sont:

Une clé utilisée par mail.fcgi pour décrire un récipient. Utilisez n'importe quel mot de votre choix.
Un code de langue. Vous pouvez avoir plusieurs enregistrements pour la même clé, avec différentes langues.
Adresse électronique du récipient.
Une quelconque description affichée par mail.fcgi (lorsque utilisé sans arguments).

Vous pouvez entrer des caractères avec des accents, mais assurez vous que votre éditeur texte est en mode UTF-8.