Pour utiliser Formmail, vous avez besoin de créer un formulaire sur une de vos pages sur la Toile.

La ligne d'action du formulaire devrait être

<FORM ACTION = "http://votre-domaine/cgi-sys/FormMail.cgi" METHOD = "POST">

formmail.cgi fera tout le travail de programmation pour vous. Vous changez le comportement de Formmail en utilisant des champs cachés dans votre formulaire.

--------------------------------------------------------------------------------

Il y a seulement un champ obligatoire sur votre formulaire pour que FormMail puisse fonctionner comme il faut. C'est le champ du déstinataire.

Champ: recipient

Description: Ce champ du formulaire vous permet de spécifier à qui vous souhaitez envoyer le formulaire de résultats. Il est fort probable que vous voudrez configurez cette option comme un formulaire avec un champ caché d'une valeur égale à celle de votre courrier électronique.

Syntaxe:

<input type=hidden name="recipient" value="anyname@yourdomain.com,othername@yourdomain.com">

--------------------------------------------------------------------------------

Champs facultatifs du Formulaire:

--------------------------------------------------------------------------------

Champ: subject

Description: Le champ de l'objet vous permettra de spécifier l'objet que vous souhaitez voir apparaître dans le courrier électronique qui vous est envoyé une fois que ce formulaire a été rempli. Si vous avez activé cette option, alors le script passera par défaut à un message objet: WWW Form Submission

Syntaxe:

Si vous voulez choisir quel est l'objet:
<input type=hidden name="subject" value="Your Subject">

Pour permettre à l'utilisateur de choisir un Objet:
<input type=text name="subject">

--------------------------------------------------------------------------------

Champ: email

Description: Ce champ du formulaire permettra à l'utilisateur de spécifier leur adresse électronique de réponse. Si vous voulez pouvoir répondre au courrier électronique de votre utilisateur, je vous recommande fortement d'inclure ce champ du formulaire et de leur permettre de le remplir.. Cela sera mis dans le champ De: du message que vous recevez.

Syntaxe: <input type=text name="email">

--------------------------------------------------------------------------------

Champ: realname

Description: Le champ du formulaire au vrai nom permettra à l'utilisateur de mettre son vrai nom. Ce champ est utile pour des raisons d'identification et sera aussi placé dans la ligne De: de l'en-tête du message

Syntaxe: <input type=text name="realname">

--------------------------------------------------------------------------------

Champ: sort

Description: Ce champ vous permet de choisir dans quel ordre vous souhaitez que les variables apparaissent dans le courrier électronique qui est créé par FormMail. Vous pouvez choisir de classer les champs par ordre alphabétique ou specifier un ordre particulier concernant l'apparition des champs dans votre message électronique. En ne remplissant pas ce champ, la commande passera simplement pas défaut à la commande dans laquelle les navigateurs envoient l'information au script (ce qui n'est pas toujours la même que celle que l'on trouve sur le bon de commande) Lorque vous triez en suivant un ordre défini de champs, vous devriez inclure la phrase 'ordre': comme première partie de votre valeur pour le champ de classement et puis suivez cela avec les champs de noms que vous souhaiter enumérer dans votre message électronique, séparés par des virgules.

Syntaxe:

Pour classer par ordre alphabétique: <input type=hidden name="sort" value="alphabetic">

Pour classer par un champ de commande défini: <input type=hidden name="sort" value="order:name1,name2,etc...">

--------------------------------------------------------------------------------

Champ: redirect

Description: Si vous souhaitez rediriger l'utilisateur vers une autre adresse réticulaireURL, plutôt qu'ils voient la réponse par défaut au formulaire à remplir, vous pouvez vous servir de cette variable cachée pour leur envoyer une page HTML déjà prête.

Syntaxe:

Pour choisir l'adresse réticulaire URL où l'utilisateur atterrira:
<input type=hidden name="redirect" value="http://your.address/to/file.html">

Pour permettre à l'utilisateur de spécifier une adresse réticulaire URL à suivre une fois que le formulaire a été rempli:
<input type=text name="redirect">

--------------------------------------------------------------------------------

Champ: required

Description: Vous pouvez maintenant exiger que certains champs de votre formulaire soient remplis avant que l'utilisateur ne puisse soumettre le formulaire avec succès. Mettez simplement tout les noms de champs qui seront obligatoires dans ce champ. Si les champs nécessaires ne sont pas remplis, l'utilisateur sera informé de ceux qu'il doit remplir, et un lien de retour directe au formulaire récemment envoyé sera fournit.

Syntaxe:

Si vous voulez pouvoir demander à l'utilisateur de remplir les champs du courrier électronique et du téléphone, afin de pouvoir les contacter une fois que le courrier a été reçu, utilisez une syntaxe comme: <input type=hidden name="required" value="email,phone">

--------------------------------------------------------------------------------

Champ: env_report

Description: Vous permet d'inclure les variables d'environnement dans le message électronique que vous recevez une fois que l'utilisateur a rempli votre formulaire. Utile si vous souhaitez savoir quel navigateur ils utilisaient, de quel domaine venaient-ils et d'autres attributs associés à l'environnement:

REMOTE_HOST - Envoie le nom de l'hébergeur effectuant cette requête.
REMOTE_ADDR - Envoie l'adresse du protocole IP à l'hébergeur à distance effectuant la requête.
HTTP_USER_AGENT - Le navigateur utilisé par le client pour envoyer sa requête. Format Général: software/version library/version
 

Syntaxe:

Si vous vouliez trouver l'hébergeur distant et le navigateur envoyant la demande, vous mettriez les informations suivantes dans votre formulaire:
<input type=hidden name="env_report" value="REMOTE_HOST,HTTP_USER_AGENT">

--------------------------------------------------------------------------------

Champ: title

Description: Ce champ du formulaire vous permet de spécifier le titre et l'en-tête qui apparaîtront sur la page résultante si vous ne spécifiez pas une adresse réticulaire de redirection.

Syntaxe:

Si vous vouliez un titre comme 'Resultats du Formulaire de Réaction':
<input type=hidden name="title" value="Feedback Form Results">

--------------------------------------------------------------------------------

Champ: return_link_url

Description: Ce champ vous permet de spécifier une adresse réticulaire qui apparaîtra comme return_link_title, sur la page de rapport suivante. Ce champ ne sera pas utilisé si vous avez activé le champ de redirection, mais il est utile si vous permettez à l'utilisateur de recevoir un rapport sur la page suivante, mais vous souhaitez lui donner un moyen de revenir sur la page principale.

Syntaxe:

<input type=hidden name="return_link_url" value="http://your.host.xxx/main.html">

--------------------------------------------------------------------------------

Champ: return_link_title

Description: C'est le titre qui sera utilisé pour permettre à l'utilisateur de retourner sur la page que vous spécifiez avec return_link_url. Les deux champs seront montrés sur le formulaire résultant comme: <ul> <li><a href="return_link_url">return_link_title</a> </ul>

Syntaxe: <input type=hidden name="return_link_title" value="Back to Main Page">

--------------------------------------------------------------------------------

Champ: background

Description: Ce champ du formulaire vous permet de spécifier l'image de l'arrière-plan qui apparaîtra si vous n'avez pas activé le champ de redirection. Cette image apparaîtra en arrière-plan à la page du formulaire des résultats.

Syntaxe:
<input type=hidden name="background" value="http://your.host.xxx/image.gif">

--------------------------------------------------------------------------------

Champ: bgcolor

Description: Ce champ du formulaire vous permet de spécifier une couleur d'arrière-plan bgcolor pour la page du formulaire de résultat de la même manière que vous spécifiez une image d'arrière-plan. Ce champ ne devrait pas être activé si le champ de redirection l'est.

Syntaxe:

Pour un arrière-plan couleur Blanche:
<input type=hidden name="bgcolor" value="#FFFFFF">

--------------------------------------------------------------------------------

Champ: text_color

Description: Ce champ fonctionne de la même manière que le champ de couleur d'arrière-plan bgcolor, sauf qu'il changera la couleur de votre texte.

Syntaxe:

Pour un texte couleur Noire: <input type=hidden name="text_color" value="#000000">

--------------------------------------------------------------------------------

Champ: link_color

Description: Change la couleur des liens sur la page résultante. Cela fonctionne de la même manière que le texte coloré. Ne devrait pas être defini si rediriger est.

Syntaxe:

Pour un lien couleur Rouge:
<input type=hidden name="link_color" value="#FF0000">

--------------------------------------------------------------------------------

Champ: vlink_color

Description: Change la couleur des liens visités sur la page résultante. Cela fonctionne exactement de la même manière que le lien coloré. Ne devrait pas être utilisé si rediriger est. Syntaxe:

Pour un lien visité couleur Bleue:
<input type=hidden name="vlink_color" value="#0000FF">

--------------------------------------------------------------------------------

Champ: alink_color

Description: Change la couleur des liens actifs sur la page résultante. Cela fonctionne de la même manière que le lien coloré. Ne devrait pas être utilisé si rediriger est.

Syntaxe:

Pour un lien visité couleur Bleue:
<input type=hidden name="alink_color" value="#0000FF">

--------------------------------------------------------------------------------

Toute autre sorte de champ qui apparait dans votre script vous sera renvoyé et apparaîtra sur la page résultante si vous n'avez pas installé le champ de redirection.

1. Explication de FormMail