cgifile - En ligne dans le Cloud

PROGRAMME:

Nom

cgiemail, cgiecho, cgifile - Outils de conversion CGI Form-to-Mail

La cgiemail utilisateur guide

Ce guide vous aidera à rédiger un formulaire WWW qui vous envoie un message électronique. Les
les étapes suivantes sont requises :

· Créez un modèle d'e-mail.

· Mettez un lien vers le modèle sur votre page.

· Décidez si un lien mailto: fera l'affaire.

· Créer le formulaire HTML.

· Créez des formulaires HTML plus avancés.

· Assurez-vous que l'ACTION est correcte.

· Essayez votre formulaire avec cgiecho.

· Lancez-vous avec cgiemail.

· Déboguez si vous ne recevez pas de courrier

Les étapes suivantes sont facultatives.

· Ajouter du texte à la page de réussite.

· Utilisez une autre page de réussite.

· Faites quelques entrées nécessaires.

· Spécifiez le formatage pour certaines entrées.

· Utiliser les variables d'environnement CGI.

Création an Courriel modèle.
Avant de commencer à recevoir des e-mails via le Web, vous devez décider quels sont ces
les messages devraient ressembler à. Créez un fichier ASCII, appelé modèle de courrier électronique, qui ressemble
quelque chose comme ça:

À: [email protected] LIGNES D'EN-TÊTE
Sujet : questions trois
ligne blanche
Quel est ton nom? [votre nom]
Quelle est votre quête? [quête] CORPS
Quelle est ta couleur préférée? [Couleur]

Dans un sens, ce modèle est de forme libre. Les personnes qui souhaitent vous envoyer un e-mail peuvent télécharger
ce modèle, remplissez-le et envoyez-le vous par la poste. Cependant, le modèle sera également utilisé
par le programme cgiemail, donc avant de télécharger le fichier sur votre serveur WWW, faites attention à
suivez ces directives :

· Partout où vous souhaitez que l'utilisateur de votre formulaire fournisse des informations, utilisez un seul mot
entre crochets sans espace, par exemple Votre nom : [votrenom]. Non [Mettez votre nom
ici].

· Assurez-vous que l'adresse dans le champ À : est correcte.

· S'il y a des lignes vides parmi les lignes d'en-tête, supprimez-les.

· S'il y a des lignes vides avant les lignes d'en-tête, supprimez-les.

· Assurez-vous que toutes vos lignes d'en-tête sont valides. Le premier caractère de la ligne doit être un
lettre. La plupart des informations doivent figurer dans le corps du message ; n'invente pas le tien
En-têtes.

· Assurez-vous qu'il y a une ligne vide entre les lignes d'en-tête et le corps.

· Assurez-vous de l'enregistrer en tant que texte ASCII. Par exemple, si vous utilisez Microsoft Word, utilisez
"Enregistrer sous" et choisissez "Texte uniquement avec des sauts de ligne".

· Si vous avez créé le fichier sur un Mac, assurez-vous de le télécharger sous forme de texte, c'est-à-dire CR traduit.
(Les ordinateurs Unix ont des codes indiquant la fin d'une ligne différents de ceux des Mac, donc votre
le fichier peut ressembler à une longue ligne pour l'ordinateur Unix.)

Dans ces lignes directrices, il y a beaucoup de flexibilité. Vous pouvez mettre Bcc:, X-Face:, ou n'importe quel
autre en-tête dans les en-têtes. Vous pouvez mettre des choses comme Cc : [votre nom] dans les en-têtes. Être
Créatif. Ne mettez rien dedans que vous ne voudriez pas que votre webmaster voie,
car c'est là que vont les messages renvoyés.

Maintenant, allez-y et téléchargez votre modèle d'e-mail sur le serveur WWW et regardez-le avec votre
Navigateur WWW.

mettre a lien à le modèle on Un flux efficace peut augmenter .
Voici un exemple:

Souhaitez-vous traverser le pont ? Téléchargez mon formulaire "questions trois" et envoyez-le à
<[email protected]>.

Même après avoir créé votre formulaire WWW, vous voudrez laisser ce lien pour augmenter
l'accessibilité aux utilisateurs handicapés.

Décide if a mailto: lien sera faire.
Déjà, sans HTML compliqué, vous avez un moyen pour que les gens sur le WWW vous envoient
les informations que vous souhaitez. Avant de vous lancer dans la création d'un formulaire HTML, décidez si
ça vaut vraiment le coup. Les formulaires sur le WWW présentent deux inconvénients particuliers :

· Vous recevrez beaucoup de courriels frivoles de personnes qui « surfent simplement sur le Web ».

· L'adresse e-mail de l'utilisateur est saisie manuellement, et est souvent mal saisie, de sorte que vous avez
aucun moyen de répondre. C'est moins un problème avec mailto: links.

Création le HTML formulaire.
Si vous avez décidé de créer un formulaire HTML, vous devez donner aux gens un moyen de fournir un
adresse e-mail. Avec le lien mailto:, leur expéditeur fournirait l'adresse De: pour
eux. Mais maintenant, vous devez ajouter une ligne en haut de votre modèle d'e-mail comme ceci :

De l'email]

Voici un exemple de formulaire HTML.

Votre adresse email: ____________________

Votre nom: ____________________

Votre quête : ____________________

Ta couleur préférée: ____________________

Envoyer un e-mail (Cet exemple n'envoie pas réellement d'e-mail.)

Voici la source HTML :

<FORM METHODE="POST"
ACTION="http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt">

Votre adresse email:
Votre nom:
Votre quête :
Ta couleur préférée:



Ceci est un exemple très simple. Notez que le NOM de chaque entrée correspond à ce que vous
préalablement mis dans le modèle d'e-mail. Dans cet exemple, il s'agit de l'e-mail, de votre nom, de votre quête,
et la couleur. C'est le concept clé de l'utilisation de cgiemail. Veillez à ce qu'ils soient exactement les
même; si vous mettez NAME="couleur" dans votre formulaire HTML et [couleur] (notez l'orthographe
différence) dans votre modèle d'e-mail, l'entrée n'apparaîtra pas dans l'e-mail.

Création PLUS Avancée HTML formes.
Pour apprendre à créer des formulaires plus complexes, lisez le guide NCSA. Tous leurs exemples de formulaires
peuvent être convertis en formulaires cgiemail simplement en changeant l'ACTION. Contrairement aux autres formulaires
programmes de messagerie, vous n'êtes pas obligé d'utiliser des entrées masquées avec des noms spéciaux.

Tous les types d'entrées (boutons radio, etc.) fonctionnent de la même manière. Chaque entrée a besoin d'un NOM, et
ce nom doit apparaître entre crochets dans votre modèle d'e-mail. C'est si simple. À
obtenir plus d'idées, voir la page d'exemple cgiemail.

Marque sûr le ACTION is corriger.
La partie la plus délicate du formulaire HTML consiste à définir correctement l'ACTION. Commencez par le
URL de votre modèle d'e-mail, puis divisez-le en deux parties, par exemple

http://web.mit.edu/wwwdev/cgiemail/questions3.txt
\ /\ /
`--- Partie 1 ---' ` -------- Partie 2 ----------'

Ensuite, vous mettez le nom du script au milieu. Habituellement, c'est ``/cgi-bin/cgiecho'', mais il
dépend de la configuration de votre serveur. Sur web.mit.edu, il se trouve que
``/bin/cgiecho'', donc mon ACTION ressemble à ceci :

http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt
\ /\ /\ /
`--- Partie 1 ---' nom du script ` -------- Partie 2 ----------'

Pour simplifier, vous pouvez omettre la partie 1, mais vous devez l'inclure si vous voulez tester votre
formulaire en tant que fichier local. Si vous ne savez pas ce que cela signifie, n'hésitez pas à omettre la partie 1.

Essayez ande Un flux efficace peut augmenter formulaire avec cgiecho.
Insérez votre formulaire dans votre navigateur WWW préféré, remplissez les entrées et soumettez-le. Tu
devrait voir à quoi ressemble le formulaire traité. Si à la place vous voyez une erreur avec un nombre
près de 500, votre ACTION est probablement mal réglée. Revenez à l'étape précédente.

Si certaines de vos entrées ne semblent pas s'afficher sous la forme traitée, assurez-vous que
les entrées ont exactement les mêmes noms dans le formulaire HTML que dans le modèle ASCII. Par exemple
NAME="votrenom" dans le formulaire HTML et [votrenom] dans le modèle d'e-mail.

Go le travail avec cgiemail.
Changez maintenant cgiecho en cgiemail dans l'ACTION de votre formulaire HTML. Essaye le. Vous devriez
recevoir un e-mail avec le formulaire traité. Si vous obtenez une page de réussite mais ne
recevoir du courrier, il y a un problème avec votre fichier modèle. Retournez et assurez-vous
correctement suivi les directives de l'étape 1.

Si ça marche, félicitations !

9. Déboguez si vous ne recevez pas de courrier

Normalement, le courrier est envoyé de manière asynchrone, ce qui signifie qu'il entre dans une file d'attente pour être envoyé à un
l'heure qui convient. Le courrier asynchrone est envoyé de manière plus efficace et fiable, mais a le
inconvénient que les problèmes ne peuvent être signalés qu'en renvoyant un message d'erreur au
expéditeur. Pour le système de messagerie, il semble que l'expéditeur du courrier soit le serveur Web, donc
le message d'erreur ne vous parviendra pas.

Si vous ne recevez pas de courrier, vous pouvez temporairement utiliser la distribution synchrone du courrier en créant
une entrée cachée nommée cgiemail-mailopt et lui donnant une valeur contenant "sync", par exemple



Remarque : pour la version 1.1, cela ne fonctionnera pas. Demandez à votre webmaster d'installer une version plus récente.
Certains expéditeurs ont une extension non standard qui envoie des rebonds à une adresse dans un Errors-
À : en-tête en plus du serveur Web. Cependant, certaines erreurs rendent cette ligne d'en-tête
illisible, il n'y a donc aucun moyen de s'assurer que le rebond ira à vous.

En option: Ajouter texte à le succès .
Lorsque le courrier est envoyé, une page intitulée « Succès » apparaît avec le texte du message électronique.
Vous pouvez utiliser une variable cachée appelée ``addendum'' pour ajouter votre propre texte. Voici une simple
Exemple:



Si vous êtes prêt à supposer que les lecteurs de votre formulaire utilisent un logiciel de navigation récent
comme Lynx 2.6 ou Netscape 3.0, alors vous pouvez mettre un balisage HTML dans cette variable en utilisant le
entités de caractères appropriées. Par exemple, si vous vouliez ajouter

Merci!

alors le balisage HTML serait

Merci!

ce qui signifie que vous auriez besoin des éléments suivants dans votre formulaire :

<INPUT TYPE="caché" NAME="addendum"
VALUE="<em>Merci !</em>">

Notez qu'en plus d'être difficile à écrire, cette fonctionnalité ne fonctionnera pas pour les personnes utilisant des
logiciel de navigation.

En option: Utilisez an autre succès .
Si vous n'aimez pas la page par défaut qui s'affiche lorsque l'e-mail est envoyé avec succès, vous pouvez
spécifiez une URL alternative en utilisant une variable cachée appelée ``success'' dans votre formulaire HTML,
par exemple

<INPUT TYPE="caché" NAME="succès" VALUE="http://web.mit.edu/">

Remarque : commencez votre URL par / ou par http://. Sinon cgiemail dirigera votre navigateur
à un deuxième appel de cgiemail, ce qui entraîne l'erreur Aucune substitution de variable.

Depuis la version 1.3, il n'y a aucun moyen de faire en sorte que cette autre page de réussite contienne des informations
l'utilisateur soumis dans le formulaire. Cette fonctionnalité sera probablement ajoutée dans une future version.

En option: Marque quelques entrées nécessaire.
Si vous souhaitez rejeter automatiquement les formulaires avec certaines entrées laissées en blanc, ajoutez le
préfixe ``required-'' au nom de l'entrée à la fois dans votre formulaire HTML et votre e-mail
modèle. Voici un exemple:

Au format HTML :

Votre nom:

Dans le modèle d'e-mail

Votre nom : [requis-votrenom]

En option: Spécifier formatage en quelques contributions.
Si, dans votre modèle d'e-mail, le texte entre crochets commence par %, cgiemail
utiliser le printf () fonction en C sur le nom du champ après la virgule. Si vous n'êtes pas familier
avec cette fonction, regardez dans un livre sur C. Si vous la connaissez, notez ces
deux différences :

· Le premier caractère de la chaîne de format doit être %.

· Les caractères comme \n et \t doivent être littéraux. Si vous voulez une nouvelle ligne, vous devez mettre un
nouvelle ligne juste avant la virgule, même si cela semble étrange. Par exemple, si
Godzilla's Pizza voulait que les garnitures soient répertoriées une par ligne, ils mettraient les éléments suivants dans
leur modèle d'e-mail :

[%s
,Garniture]

En option: Utilisez CGI sûr, heureux et sain variables.
Cette fonctionnalité peut ou non fonctionner, selon que votre webmaster l'a activée ou non
lors de la configuration de cgiemail.

En plus des entrées de formulaire, votre modèle de courrier électronique peut inclure des variables d'environnement CGI
simplement en faisant précéder le nom de la variable d'un signe dollar. Par exemple,

[$HTTP_USER_AGENT]

mettra le nom du navigateur et/ou de la passerelle de l'utilisateur dans votre message électronique. Afin de
être respectueux de la vie privée, votre formulaire HTML doit avertir les utilisateurs de toute information concernant
ceux qui seront inclus dans l'e-mail, par exemple HTTP_USER_AGENT, REMOTE_ADDR.

Administration
Contact en amont : cgiemail[email protected]>

Mainteneur Debian : Anibal Monsalve Salazar[email protected]>

Des informations complètes sur la création, l'installation et l'utilisation de cgiemail sont disponibles sur le WWW :

http://web.mit.edu/wwwdev/cgiemail/

Utiliser cgifile en ligne à l'aide des services onworks.net