Networks

formmail.pl est un script d'envoi de formulaires possédant une grande variété d'options. Il est plus flexible que le script form.cgi , mais moins que le script cgiemail . Il accepte des soumissions de formulaires par les méthodes GET ou POST , et permet d'envoyer des e-mail à l'extérieur du domaine pair.com . Pour un usage simple, consultez son guide Comment Faire.

Les champs suivants sont optionnels pour formmail.pl; seul le champ recipient est obligatoire:

===========================================================

recipient (obligatoire)

Ce champ précise l'adresse de destination e-mail où envoyer le contenu du formulaire. Exemple :

<INPUT TYPE="hidden" NAME="recipient" VALUE="address@domain.com">

subject

Ce champ renseigne la ligne "Subject" du courrier e-mail à envoyer. Par défault, le contenu de "Subject" est "WWW Form Submission". Exemple:

<INPUT TYPE="hidden" NAME="subject" VALUE="votre ligne subject">

Vous pouvez également permettre à l'utilisateur de renseigner le champ "Subject" :

<INPUT TYPE="text" NAME="subject">

email

Ce champ spécifie l'adresse e-mail de retour de l'utilisateur qui soumet le formulaire. Ce champ doit être rempli par l'utilisateur lui-même bien sûr. Le e-mail sera généré de façon à ce que la fonction retour de votre programme courrier utilise cette adresse. Par défault, l'adresse est nobody@pair.com. Exemple:

<INPUT TYPE="text" NAME="email">

realname

Ce champ renseigne le nom d'usage de l'utilisateur soumettant le formulaire. Ce champ doit être rempli par l'utilisateur. Le e-mail sera généré avec ce nom dans l'entête. Exemple:

<INPUT TYPE="text" NAME="realname">

redirect

Ce champ indique l' URL vers lequel l'utilisateur doit être automatiquement renvoyé dès la reception réussie du formulaire. Si ce champ n'est pas renseigné, l'utilisateur recevra une réponse par défault. Exemple:

<INPUT TYPE="hidden" NAME="redirect" VALUE="http://domain.com/whatever.html">

required

Ce paramètre vous permet d'indiquer les champs qui doivent impérativement être remplis; en d'autres termes ces champs ne pourront pas être vides au moment de l'envoi du formulaire. Si un de des champs spécifié n'est pas rempli, l'utilisateur recevra un "warning" et le formulaire ne sera pas envoyé. Exemple:

<INPUT TYPE="hidden" NAME="required" VALUE="email,subject">

env_report

Ce paramètre renseigne une liste de variables d'environnement qui doivent être envoyées en même temps que le contenu du formulaire. Cette possibilité est intéressante pour l'enregistrement de l'adresse IP de l'utilisateur envoyant le formulaire, par exemple. Ci-dessous deux variables d'environnement qu'il peut être utile d'enregistrer :

• REMOTE_ADDR - IP adresse IP de l'utilisateur

HTTP_USER_AGENT - nom et version du navigateur Web utilisé

Note: La notion de minuscule/majuscule est importante pour les variables d'environnement. Vous trouverez les variables d'environnement typiques en utilisant le script test.cgi .

Exemple:

<INPUT TYPE="hidden" NAME="env_report" VALUE="REMOTE_HOST,HTTP_USER_AGENT">

sort

Ce champ précise le type de tri qui doit être utilisé pour mettre en forme les données rentrées dans le formulaire dans le courrier e-mail. Par défault, les champs ne seront pas triés (le résultat dépendra du navigateur Web utilisé). Vous pouvez spécifier "alphabetic" pour un tri par ordre alphabétique (identique à form.cgi, décrit plus haut). Vous pouvez également préciser l'odre exacte que vous souhaitez avec "order:". Exemples:

<INPUT TYPE="hidden" NAME="sort" VALUE="alphabetic">
<INPUT TYPE="hidden" NAME="sort" VALUE="order:name,email,phone">

print_config

Ce champ indique que le champ de contrôle formmail.pl (qui est normalement exclus de texte du message sortant) est inclus. Exemple:

<INPUT TYPE="hidden" NAME="print_config" VALUE="email,subject">

title

Ce champ renseigne le titre de la page de réponse par défault, page créee par le script en absence du champ redirect . La valeur par défault est "Thank You". Exemple:

<INPUT TYPE="hidden" NAME="title" VALUE="Résultat du formulaire">

return_link_url

Ce champ indique l'URL qui apparaitra sur la page de réponse par défault, page créee par le script en l'absence d'un champ redirect. Cet URL peut être utilisé pour permettre à l'utilisateur de retourner, par exemple à votre home page. Exemple:

<INPUT TYPE="hidden" NAME="return_link_url" VALUE="http://domain.com/">

return_link_title

Ce champ indique le texte qui sera utilisé dans le link crée quand return_link_url est renseigné. Exemple:

<INPUT TYPE="hidden" NAME="return_link_title" VALUE="Return to Home Page">

background

Ce champ indique l' URL d'une image de fond ( background image ) qui sera utilisée par la page de réponse par défault, page crée par le script en l'absence d'un champ a redirect . Exemple:

<INPUT TYPE="hidden" NAME="background" VALUE="http://domain.com/img/bkgr.gif">

bgcolor

Ce champ indique la couleur du fond qui sera utilisée par la page de réponse par défault, page crée par le script en l'absence d'un champ a redirect. Exemple (blanc pur):

<INPUT TYPE="hidden" NAME="bgcolor" VALUE="#FFFFFF">

text_color

Ce champ indique la couleur du texte qui sera utilisée par la page de réponse par défault, page crée par le script en l'absence d'un champ a redirect. Exemple (noir pur):

<INPUT TYPE="hidden" NAME="text_color" VALUE="#000000">

link_color

Ce champ indique la couleur du lien non visité (unvisited link) qui sera utilisée par la page de réponse par défault, page crée par le script en l'absence d'un champ a redirect. Exemple (rouge pur):

<INPUT TYPE="hidden" NAME="link_color" VALUE="#FF0000">

vlink_color

Ce champ indique la couleur du lien visité (visited link) qui sera utilisée par la page de réponse par défault, page crée par le script en l'absence d'un champ a redirect. Exemple (bleu pur):

<INPUT TYPE="hidden" NAME="vlink_color" VALUE="#0000FF">

alink_color

Ce champ indique la couleur du lien actif (active link) qui sera utilisée par la page de réponse par défault, page crée par le script en l'absence d'un champ a redirect. Exemple (vert pur):

<INPUT TYPE="hidden" NAME="alink_color" VALUE="#00FF00">

Notez que ce script peut également être référencé en tant que FormMail.pl.