Networks

cgiemail est un CGI pour le "E-Mail gateway". Il prend en compte les résultats d'un formulaire, qu'il met en forme suivant fichier modèle pour produire un message e-mail . Cela le rend beaucoup plus flexible que FormMail.

Pour utiliser cgiemail, vous devez tout d'abord écrire un formulaire pour les visiteurs du site qui s'en l'utiliseront pour vous envoyer les informations. Si vous avez un domaine virtuel ou un domaine "vanity", le tag d'ouverture du formulaire doit être :

<FORM METHOD="POST" ACTION="/cgi-sys/cgiemail/template.txt">

Si vous n'avez pas de domaine propre, vous devez utiliser :

<FORM METHOD="POST" ACTION="/cgi-sys/cgiemail/username/template.txt">

Dans chacun des cas, cgiemail trouvera automatiquement votre répertoire Web et y cherchera ( ou dans un sous-répertoire que vous spécifiez) le fichier modèle.

Pendant la période de test de votre formulaire, vous pouvez changer cgiecho par cgiemail dans le tag FORM. Cela affichera simplement le courrier e-mail sur l'écran de votre navigateur Web au lieu de faire un envoi.

Le fichier modèle que vous créez doit être un fichier texte ASCII (ne pas le charger en mode binaire ), et doit avoir l'extension .txt. Le fichier modèle est placé dans votre répertoire Web avec les autres fichiers.

Le fichier modèle commence par une entête de courrier qui doit être suivie d'une ligne vierge avant le contenu du message à envoyer. Si vous ne suivez pas cette convention, votre courrier sera endommagé ou ne vous atteindra pas. Les deux entêtes les plus importants sont To: et Subject:, donc commencez toujours par ceux là. Ci-après un exemple de fichier modèle :

To: strangeman@chasm.big
Subject: question trois

Quel est votre nom?              [votrenom]
Quelle est votre demande ?             [demande]
Quelle est votre couleur préférée?  [couleur]

Le HTML qui utiliserait ce modèle ressemblerait à:

<FORM METHOD="POST" ACTION="/cgi-sys/cgiemail/template.txt">
Votre nom: <INPUT NAME="votrenom">
<BR>
Votre demande: <INPUT NAME="demande">
<BR>
Votre couleur préférée: <INPUT NAME="couleur">
<P>
<INPUT TYPE="submit" value="Send E-Mail">
</FORM>

Lorsque le courrier e-mail est envoyé, le visiteur verra une page "accusé de reception" et rien de plus. Pour ajouter un commentaire supplémentaire à cette page, insérez le champ suivant dans votre fichier HTML :

<INPUT TYPE="hidden" NAME="addendum" VALUE="votre message ici">

Ou mieux encore, insérer le champ suivant pour générer un renvoi sur une de vos pages :

<INPUT TYPE="hidden" NAME="success" VALUE="votre URL ici">

Pour rendre le remplissage d'un champ obligatoire, changer son nom pour avoir un début du type required- dans le fichier HTML ainsi que dans le fichier modèle.

Vous pouvez inclure des variables d'environnement dans le e-mail en les insérant dans le fichier modèle en tant que noms de champs commençant par le caractère $. Par exemple :

Le navigateur Web de l'utilisateur était : [$HTTP_USER_AGENT]