Comment configurer FormMail ?
ATTENTION ! : cette fonctionnalité a été désactivée car elle est aujourd'hui obsolète. Il est possible d'utiliser à la place n'importe quel outil externe d'envoi d'e-mails via formulaire, comme par exemple MailThisTo, FormsPark ou MailSlurp
Configuration du Formulaire :
L'action de votre formulaire doit pointer vers ce script, et la méthode doit être POST ou GET en lettres majuscules. La version 1.5 de FormMail offre de nombreux nouveaux moyens de coder votre formulaire pour adapter la page HTML résultante et la manière dont les scripts fonctionnent. Voici une liste des champs de formulaire que vous pouvez utiliser et la façon de les implémenter.
Adresse vers le CGI FormMail : /cgi-sys/form-mail.cgi
Champs de formulaire nécessaires :
Il n'y a qu'un seul champ que vous devez avoir dans votre formulaire pour que FormMail fonctionne correctement. C'est le champ recipient.
Champ : recipient
- Description : Ce champ de formulaire vous permet de spécifier à qui vous souhaitez envoyer par e-mail les résultats de votre formulaire. Vous voudrez probablement configurer cette option comme un champ de formulaire caché avec une valeur égale à votre adresse électronique.
- Syntaxe :
<input type=hidden name="recipient" value="email@your.host.com" />
Champs de formulaire optionnels :
Champ : subject
- Description : Le champ subject vous permettra de spécifier le sujet que vous souhaitez voir apparaître dans l'e-mail qui vous est envoyé lorsque quelqu'un remplit le formulaire. Si vous ne souhaitez pas activer cette option, le script enverra le message avec un sujet par défaut : WWW Form Submission.
- Syntaxe :
Pour indiquer le sujet :
<input type=hidden name="subject" value="Your Subject" />
Pour permettre à l'utilisateur de choisir le sujet :<input type=text name="subject" />
Champ : email
- Description : Ce champ de formulaire permettra à l'utilisateur de spécifier son adresse e-mail. Si vous souhaitez pouvoir envoyer des réponses par e-mail à l'utilisateur, il est fortement recommandé d'inclure ce champ de formulaire et de le laisser remplir. Ce champ sera indiqué dans le champ From : du message que vous recevez. Si vous souhaitez vérifier la syntaxe de l'adresse e-mail pour obliger à ce qu'elle soit valide, vous devez ajouter ce nom de champ aux champs 'required'.
- Syntaxe :
<input type=text name="email" />
Champ : realname
- Description : Le champ de formulaire realname permettra à l'utilisateur d'entrer son vrai nom. Ce champ est utile à des fins d'identification et sera également inclus dans la ligne From : de votre en-tête de message.
- Syntaxe :
<input type=text name="realname" />
Champ : redirect
- Description : Si vous souhaitez rediriger l'utilisateur vers une URL différente, plutôt que de lui faire voir la réponse par défaut du formulaire rempli, vous pouvez utiliser cette variable cachée pour l'envoyer vers une page HTML préalablement créée.
- Syntaxe :
Pour choisir l'adresse URL vers laquelle ils seront redirigés :
<input type=hidden name="redirect" value="http://your.host.com/to/file.html" />
Pour permettre à l'utilisateur de spécifier une URL à laquelle accéder une fois le formulaire rempli :<input type=text name="redirect" />
Champ : required
- Version : 1.3 & supérieures
- Description : Vous pouvez exiger que certains champs du formulaire soient remplis avant que l'utilisateur ne puisse soumettre le formulaire avec succès. Il vous suffit d'indiquer dans ce champ tous les champs que vous souhaitez rendre obligatoires. Si les champs obligatoires ne sont pas remplis, il sera notifié à l'utilisateur qu'il doit les remplir, et un lien le ramènera au formulaire qu'il était en train de remplir. Pour utiliser une page d'erreur personnalisée, voir
missing_fields_redirect - Syntaxe : Si vous souhaitez que les champs email et téléphone soient obligatoires, de sorte que vous puissiez les contacter lorsque vous recevez l'e-mail, utilisez une syntaxe comme :
<input type=hidden name="required" value="email,phone" />
Champ : env_report
- Version : 1.3 & supérieures
- Description : Vous permet d'avoir des variables d'environnement incluses dans le message e-mail que vous recevez après qu'un utilisateur a rempli le formulaire. C'est utile si vous souhaitez connaître le navigateur qu'ils utilisent, depuis quel domaine ils ont accédé ou tout autre attribut associé aux variables d'environnement. Voici une courte liste de variables d'environnement valides et qui peuvent être utiles : - REMOTE_HOST Envoie le nom d'hôte de la question. - REMOTE_ADDR Envoie l'adresse IP du host distant de la question. - REMOTE_USER Si le serveur utilise l'authentification et que le script est protégé, il s'agit du nom d'utilisateur avec lequel ils se sont authentifiés. Habituellement, il n'est pas affiché. - HTTP_USER_AGENT Le navigateur que l'utilisateur utilise pour envoyer le formulaire. Il y en a d'autres, mais ce sont quelques-unes des plus utiles. Pour plus d'informations sur les variables d'environnement, voir : Environment_Variables
- Syntaxe : Si vous souhaitez trouver le host distant et le navigateur qui envoient le formulaire, vous devez indiquer ce qui suit :
<input type=hidden name="env_report" value="REMOTE_HOST, HTTP_USER_AGENT" />
Champ : sort
- Version : 1.4 & supérieures
- Description : Ce champ vous permet de choisir l'ordre dans lequel vous souhaitez que vos variables apparaissent dans l'e-mail généré par FormMail. Vous pouvez obtenir les champs triés alphabétiquement ou définir l'ordre dans lequel vous souhaitez que les champs apparaissent dans votre message e-mail. En laissant ce champ vide, l'ordre sera simplement l'ordre dans lequel les navigateurs envoient les informations au script (habituellement c'est le même ordre dans lequel ils apparaissent dans le formulaire). Pour établir un ordre pour les champs, la phrase "order:" doit être incluse en tant que première partie de la valeur du champ choisi, puis continuer avec les noms des champs que vous souhaitez lister dans le message e-mail, séparés par des virgules. La version 1.6 permet un peu plus de flexibilité pour lister les champs à trier, en permettant d'inclure des espaces et des retours à la ligne dans le champ sans interférer dans l'ordre. Cela est utile lorsqu'il y a de nombreux champs de formulaire et qu'il faut insérer une ligne de séparation.
- Syntaxe : Pour trier alphabétiquement :
<input type=hidden name="sort" value="alphabetic" />Pour trier par un ensemble de champs :<input type=hidden name="sort" value="order:name1,name2, name3,etc..." />
Champ : print_config
- Version : 1.5 & supérieures
- Description : print_config vous permet de spécifier les variables de configuration que vous souhaitez voir imprimées dans votre message e-mail. Par défaut, aucun champ de configuration n'est imprimé dans l'e-mail. C'est ainsi parce que les champs de formulaire importants tels que l'email, le sujet, etc., sont inclus dans l'en-tête du message. Cependant, certains utilisateurs ont demandé cette option afin qu'ils puissent avoir ces champs imprimés dans le corps du message. Les champs de configuration que vous pouvez faire imprimer se trouveront dans l'attribut value de la balise d'entrée, séparés par des virgules.
- Syntaxe : Si vous souhaitez imprimer les champs email et sujet dans le corps du message, vous devez utiliser la balise de formulaire suivante :
<input type=hidden name="print_config" value="email,subject" />
Champ : print_blank_fields
- Version : 1.6
- Description :
print_blank_fieldsvous permet d'assurer que tous les champs de formulaire sont imprimés dans le HTML de retour, à moins qu'ils n'aient été remplis. Par défaut, FormMail laisse cette propriété sur off, de sorte que les champs de formulaire non utilisés ne sont pas envoyés. - Syntaxe : Si vous souhaitez imprimer tous les champs vides :
<input type=hidden name="print_blank_fields" value="1" />
Champ : title
- Version : 1.3 & supérieures
- Description : Ce champ de formulaire vous permet de spécifier le titre et l'en-tête qui apparaîtront dans la page de résultat si vous ne spécifiez pas une URL dans le champ redirect.
- Syntaxe : Si vous souhaitez un titre de 'Feedback Form Results' :
<input type=hidden name="title" value="Feedback Form Results" />
Champ : return_link_url
- Version : 1.3 & supérieures
- Description : Ce champ vous permet de spécifier une URL qui apparaîtra, tout comme return_link_title, dans la page de rapport suivante. Ce champ ne sera pas utilisé si vous avez indiqué le champ redirect, mais il est utile si vous permettez à l'utilisateur de recevoir le rapport sur la page suivante, et que vous souhaitez offrir un moyen de revenir à la page principale.
- Syntaxe :
<input type=hidden name="return_link_url" value="http://your.host.com/main.html" />
Champ : return_link_title
- Version : 1.3 & supérieures
- Description : C'est le titre qui sera utilisé pour renvoyer l'utilisateur à la page que vous spécifiez avec return_link_url. Les deux champs seront affichés dans la page du formulaire résultante comme :
return_link_title - Syntaxe :
<input type=hidden name="return_link_title" value="Back to Main Page" />
Champ : missing_fields_redirect
- Version : 1.6
- Description : Ce champ de formulaire vous permet de spécifier une URL vers laquelle les utilisateurs seront redirigés s'il y a des champs obligatoires qui n'ont pas été remplis. Ainsi, vous pouvez personnaliser une page d'erreur plutôt que d'afficher la page par défaut.
- Syntaxe :
<input type=hidden name="missing_fields_redirect" value="http://your.host.com/error.html" />
Champ : background
- Version : 1.3 & supérieures
- Description : Ce champ de formulaire vous permet de spécifier une image de fond qui apparaîtra si vous n'avez pas le champ redirect. Cette image apparaîtra comme un fond à la page des résultats du formulaire.
- Syntaxe :
<input type=hidden name="background" value="http://your.host.com/image.gif" />
Champ : bgcolor
- Version : 1.3 & supérieures
- Description : Ce champ de formulaire vous permet de spécifier un bgcolor pour la page des résultats du formulaire de la même manière que vous spécifiez une image de fond. Ce champ ne fonctionnera pas si le champ redirect a été indiqué.
- Syntaxe : Pour un fond blanc :
<input type=hidden name="bgcolor" value="#FFFFFF" />
Champ : text_color
- Version : 1.3 & supérieures
- Description : Ce champ fonctionne de la même manière que bgcolor, et change la couleur du texte.
- Syntaxe : Pour une couleur de texte noire :
<input type=hidden name="text_color" value="#000000" />
Champ : link_color
- Version : 1.3 & supérieures
- Description : Change la couleur des liens dans la page de résultats. Fonctionne de la même manière que text_color. Ne sera pas utilisé si le champ redirect est défini.
- Syntaxe : Pour une couleur de lien rouge :
<input type=hidden name="link_color" value="#FF0000" />
Champ : vlink_color
- Version : 1.3 & supérieures
- Description : Change la couleur des liens visités dans la page de résultats. Fonctionne comme le link_color. Ne sera pas utilisé si le champ redirect est défini.
- Syntaxe : Pour un lien visité de couleur bleue :
<input type=hidden name="vlink_color" value="#0000FF" />
Champ : alink_color
- Version : 1.4 & supérieures
- Description : Change la couleur des liens actifs dans la page de résultats. Fonctionne comme le link_color. Ne sera pas utilisé si le champ redirect est défini.
- Syntaxe : Pour un lien actif de couleur bleue :
<input type=hidden name="alink_color" value="#0000FF" />
Tout autre champ de formulaire apparaissant dans votre script vous sera renvoyé et affiché sur la page des résultats si vous n'avez pas l'ensemble de champs redirigé. Il n'y a pas de limite aux autres champs de formulaire que vous pouvez utiliser avec ce formulaire, sauf les limites imposées par les navigateurs et par vos propres serveurs.
Code d'exemple :
<html>
<head>
<title>Formulaire d'exemple</title>
</head>
<body>
<form action="/cgi-sys/form-mail.cgi" method="post">
<p style="text-align: center;">
Nom : <input name="nombre" size="20" /><br />
Entreprise : <input name="empresa" size="20" />
</p>
<input type="submit" value="Envoyer" name="B1" />
<input type="hidden" value="direccion@destino.com" name="recipient" />
<input type="hidden" value="http://www.dominio.com/formok.htm" name="redirect" />
<input type="hidden" value="Formulario enviado por WEB" name="subject" />
</form>
</body>
</html>