Il existe deux possibilités d’utilisation de script CGI (Common Gateway Interface) qui trouvent leur utilité dans presque chaque présentation en ligne: l'enregistrement du nombre de visiteurs (afin de comptabiliser l’accès sur une page Web) et la transformation du contenu des formulaires en E-mail. Les deux fonctions sont installées sur nos serveurs, il faut donc seulement les activer au moment voulu. Il suffit d’insérer dans votre page une ligne pour activer la comptabilité des visiteurs, respectivement d'insérer quelques lignes dans votre formulaire pour activer notre script de transformation de formulaire.
  
Exploitation des scriptes CGI existant:

Si vous voulez  installer et adapter vous-même les scripts CGI, vous nécéssiterez souvent des indications absolues du cheminement à votre registre. Veuillez prendre en compte que vous devez écrire un double backslash \\ sous Windows, parce que sous Perl il est déjà conféré ailleurs.

Les indications de cheminement suivantes sont valables pour nos serveurs Web:


Serveur NetGalaxie
Chemin absolu de votre registre: d:\\www\\nomutilisateur
(p.ex. d:\\www\\www99)

Serveur NetGalaxie
Chemin absolu du registre Perl: c:\\perl\\bin

Le programme Mail "Blat v1.8.4" est installé (sur nos serveurs) pour l'utilisation dans des scripts :
Blat v1.8.4 by P.Mendes, M.Neal, G.Vollant, T. Charron
http://www.interlog.com/~tcharron/blat.html
Pfad: c:\winnt\system32\blat.exe

Syntax: Blat <filename> -t <recipient> [optional switches (see below)]
<filename>
: file with the message body ('-' for console input, end with ^Z)
-t <recipient> : recipient list (comma separated)
-s <subj> : subject line
-f <sender> : overrides the default sender address (must be known to server)
-i <addr> : a 'From:' address, not necessarily known to the SMTP server.
-c <recipient> : carbon copy recipient list (comma separated)
-b <recipient> : blind carbon copy recipient list (comma separated)
-o <organization>: Organization field
-x <X-Header: detail>: Custom 'X-' header. eg: -x "X-INFO: Blat is Great!"
-r : Request return receipt.
-d : Request disposition notification.
-h : displays this help.
-q : supresses *all* output.
-server <addr> : Specify SMTP server to be used. (optionally, addr:port)
-mime : MIME Quoted-Printable Content-Transfer-Encoding.
-uuencode : Send (binary) file UUEncoded
-base64 : Send (binary) file using base64 (binary Mime)
-try <n times> : how many time blat should try to send. from '1' to 'INFINITE'
-attach <file> : attach binary file to message (may be repeated)
-attacht <file>: attach text file to message (may be repeated)
-ti <n> : Set timeout to 'n' seconds.
  
  
Transformation de formulaires en E-mails:

Fondamentalement vous pouvez aussi reporter des formulaires avec la fonction mailto:. Ceci a néanmoins trois inconvénients:
Premièrement  le contenu sera souvent presque illisible (les voyelles et les interlignes ne sont pas correctement reportées.
Deuxièmement l’expéditeur a besoin d’une adresse E-mail valable pour envoyer le formulaire, ce qui par exemple n’est pas le cas sur les terminaux Internet publics.
Troisièmement tous les Navigateurs ne travaillent pas correctement avec cette méthode.

C’est pourquoi il est toujours plus avantageux de transformer un formulaire à l’aide d’un script CGI, et de cette manière s’assurer un contenu sûr et lisible. Vous trouverez  ci-dessous la description pas à pas des instructions pour les scripts CGI. Pour ce faire nous utilisons le script FormMail.pl de la bibliothèque CGI-Freeware-MSA (anglais) dans sa version spécifique pour Windows NT. Nous l'avons installé pour vous dans le registre central des scripts. Dans cette bibliothèque vous trouverez également d’autres scripts utiles comme par exemple: le livre d’or.

Pour que le script se charge d'éditer le contenu du formulaire, il vous faudra simplement insérer quelques champs cachés dans votre formulaire. Ceux-ci servirons à formater l’E-mail à expédier.


Modification des formulaires:

Pour utiliser FormMail il faudra ajouter dans vos formulaires quelques indications supplémentaires:

Naturellement votre formulaire devra se référer au script pour qu’en appuyant sur la touche „envoi“, il puisse être lancé par le serveur et comme méthode, il faudra indiquer en majuscules POST ou GET. Vous pouvez faire ceci indépendamment de votre nom de domaine, avec les ordres suivants:

<form action="/scripts/formmail.pl" method=POST>

Par la suite vous devrez définir différents champs soit comme champ caché
(type=hidden) de tel façon que l’utilisateur ne le voit pas ou comme champ à remplir par l’utilisateur. Ces champs contiennent d’importantes informations pour formater vos E-mails par exemple l’adresse du destinataire du contenu du formulaire. Les champs peuvent être inséré n’importe ou entre l'ordre indiqué ci-dessus et la fin du formulaire </FORM>.
  
Description des champs particuliers:
  
Champ (field): recipient (récepteur)

C’est l’unique champ du formulaire qui est absolument nécessaire pour que le script travaille d’une façon irréprochable. Il indique à qui le contenu du formulaire doit être envoyé. Il y a de fortes chances que vous allez définir ce champ comme champ caché pour éviter que l’utilisateur ne le manipule. Le contenu du champ sera probablement votre propre adresse E-mail.

Syntaxe:

<input type=hidden name="recipient" value="votrenom@votredomaine.com">
  
Champ: subject (objet)
  
Le champ "subject"(objet), vous permet d’indiquer quel objet doit apparaître dans l’Email en création. Si vous ne définissez pas cette variable, le script créera automatiquement une information avec la mention "WWW Form Submission“.

Syntaxe:

Si vous voulez définir un champ "subject" (objet):
  
<input type=hidden name="subject" value="votre_objet">

Si vous permettez à l’utilisateur d’indiquer un champ "subject" (objet):
  
<input type=text name="subject">

  
Champ: E-mail
  
Ce champ permet à l’utilisateur d’indiquer une adresse E-mail pour lui répondre. Si vous voulez avoir la possibilité de répondre à l’utilisateur par E-mail vous devez absolument  introduire ce champ dans votre formulaire et le faire remplir par l’utilisateur. Cette requête de l’utilisateur figure alors dans le champ From: (De:) du message que vous recevrez.
  
Syntaxe:

<input type=text name="email">

  
Champ: realname (nom réel)
  
Le champ „nom réel“ dans le formulaire permet à l’utilisateur d’indiquer son vrai nom. Ce champ est utile pour l’identification de l’expéditeur et apparaîtra également dans le champ From: (De:). Comme vous en avez l’habitude dans les programmes E-mail, dans lesquels à part l’adresse e-mail vous avez également le nom complet de l’utilisateur.

Syntaxe:

<input type=text name="realname">

  
Champ: redirect (reroutage)
  
Si l’utilisateur doit après l'envoi du formulaire être dirigé vers une autre URL que celle de la réponse standard du scripts (en langue anglaise), vous pouvez utilisez cet champ pour le définir.

Syntaxe:

<input type=hidden name="redirect" value="http://votre_domaine/votre_fichier.html">
  
Champ: sort (trier)
  
Il trie les champs du formulaire dans l' e-mails que vous recevez dans l’ordre que vous avez indiqué. Si vous n’avez pas défini cet champ, les champs seront triés selon l’ordre d’arrivé des données au serveur par l’internet. En règle générale ceci n’est pas l’ordre selon lequel vous avez défini les champs, mais la plupart du temps totalement pêle-mêle.

Syntaxe:

<input type=hidden name="sort" value="order:champ1,champ2,champ3">

Indication: Remplacez champ1, champ2, champ3 par les noms de champ figurant  dans le formulaire, qui devront être donnés selon un ordre bien défini.
  
Champ: required (obligatoire)
  
Donne la possibilité de définir certains champs que l’utilisateur devra en tout cas remplir. Si le formulaire est envoyé sans que ces champs définis soient remplis, une information defaute apparaîtra.
Syntaxe:
<input type=hidden name="required" value="champ1,champ2,champ3">

Indication: Remplacez champ 1, champ 2, champ 3 par les noms de champ figurant  dans le formulaire, qui devront être remplis obligatoirement.
  
Champ: missing_fields_redirect
  
Donne la possibilité de définir le site html qui apparait quand les champs définis dans "champ-obligatoire" ne sont pas remplis. Attention: cette fonction n’est disponible qu’à partir de la version 1.6. Veuillez vérifier quelle version de Form-Mail est installé dans votre répertoire.

Syntaxe:

<input type=hidden name="missing_fields_redirect" value="http://your.host.com/error.html">

Indication: remplacez "http://your.host.com/error.html" par l’URL du site qui devra apparaître comme information d'erreur.

Nous avons décrit les champs de formulaire les plus important pour configurer l’E-mail. Il y a cependant d’autres champs formulaires moins importants qui sont décrit en langue anglaise dans la bibliothèque MSA d’origine.
  
  

Installation d’un compteur de visiteurs:

Vous pouvez démarrer un compteur de visiteurs en saisissant l'ordre suivant:

<IMG SRC="/scripts/counter1/counter.exe?width=4&link=votre_domaine&style=a">

Indiquez ce faisant obligatoirement sous link=votredomaine votre nom de domaine sans l'extension, par exemple pour un compteur sur le site http://www.netgalaxie.com il faudra indiquer seulement: link=netgalaxie

La variable intitulée width représente le nombre de chiffre du compteur et la variable style permet de préciser le style du compteur. Vous avez pour cela le choix entre les différents styles indiqués ci-dessous. Vous avez par exemple choisi le style „bbldotg“ il faudra indiquez: style=bbldotg

Style Résultat Style Résultat
a amini
b bbldotb
bbldotg bbldotr
big-org big-sinv
big-suns big-trum
blutrns b-rosew
doghous fdg
fdr led
m-blueo med-blue
med-blue med-dig
med-pur med-red
netscap odb
odw pcg
pdr pdw
pdy sbg
sm-puri standard
tiny visitat
web1 web2

Links:

CGI / Perl
  

Copyright © 2000 NetGalaxie - Hébergement. All rights reserved.