Instructions pour Formmailer

Dans ce tutoriel, vous apprendrez comment créer des formulaires avec Formmailer.
C'est une façon simple et sécurisée de mettre en place un formulaire de contact ou un formulaire de feedback, illustré de quelques exemples.

Qu’est-ce qu’un Formmailer?

Imaginez que vous organisez un événement et que vous souhaitez que les invités puissent s’inscrire par Internet.

Il serait intéressant de pouvoir définir avec précision toutes les informations que les invités doivent fournir, p. ex. le nom, le nombre de personnes ou s’ils apporteront quelque chose.

Grâce au Formmailer, vous pouvez créer très simplement de tels formulaires, sans pour autant avoir des connaissances de programmation approfondies.

Les pages suivantes vous montrent comment faire.

Comment puis-je commencer?

Vous devez d’abord réfléchir aux informations que vous souhaitez transmettre par l’intermédiaire du formulaire.

Commencez par créer un formulaire simple.

Veillez à ce que la «form action» indique /cgi-sys/FormMail.cgi.

Ce formulaire se présente de la façon suivante:

L’e-mail que vous recevez pourrait se présenter ainsi:

Paramètres de base du Formmailer

Paramètres à l’intérieur de la page Web ou dans un fichier

Vous pouvez intégrer les paramètres dans des champs cachés, c’est-à-dire dans les champs du formulaire qui ne se voient pas, ou vous pouvez créer un fichier de configuration. Ceci est utile si, par exemple, vous ne souhaitez pas que votre adresse e-mail apparaisse dans le formulaire.

Pour cela, créez un dossier «formmail» dans votre répertoire FTP et un dossier «conf» dans ce dossier. Vous devez impérativement nommer ces dossiers ainsi. Puis, dans «conf», créez un fichier intitulé p. ex. «mon_formulaire». Dans votre programme FTP, cela doit ressembler à ça:

Vous pouvez ensuite intégrer ce fichier dans votre formulaire avec l’option suivante:

Le fichier est organisé en lignes et il a le format suivant: feldname]:[wert]

Tous les signes peuvent apparaître dans la valeur, y compris les espaces et les tabulations.

Ce fichier pourrait avoir le contenu suivant:

A quelles adresses e-mail vais-je envoyer mon formulaire?

Vous pouvez les envoyer directement à une adresse e-mail et, en complément, à une autre adresse e-mail en copie ou copie cachée. Ces adresses aussi doivent appartenir à votre compte.

Vous pouvez insérer plusieurs adresses électroniques séparées par des virgules.

Adresse e-mail du destinataire (To)

Adresse e-mail en copie (Cc)

Adresse e-mail en copie cachée (Bcc)

Autres paramètres e-mail importants

E-mail de confirmation

En raison des abus de spammeurs, cette fonction a malheureusement dû être supprimée.

Objet

Vous pouvez prédéfinir l’objet ou le laisser saisir par la personne qui remplit le formulaire.

Si vous optez pour la dernière solution, rendez le champ visible; dans l’autre cas, cela n’est pas nécessaire.

Nom de la personne qui remplit le formulaire

Le nom de la personne qui remplit le formulaire doit être inséré dans le champ «realname»; il est ensuite affiché dans l’en-tête de l’e-mail.

E-mail de la personne qui remplit le formulaire

Intégrer l’adresse e-mail de la personne qui remplit le formulaire sous forme de texte, définir votre propre adresse comme expéditeur

La première variante définit l’adresse e-mail de la personne qui remplit le formulaire comme expéditeur de l’e-mail. Ceci peut parfois créer des difficultés, par exemple en cas de faute de frappe lors de la saisie des adresses e-mail. Des technologies telles que SPF peuvent aussi expliquer pourquoi le propriétaire du formulaire ne reçoit pas l’e-mail.

Nous recommandons donc la configuration suivante:

Définissez la valeur «email» de façon fixe avec une adresse e-mail existant sur votre hébergement. Vous garantissez ainsi que vous recevrez toujours l’e-mail.

Vous trouverez l’adresse e-mail de la personne qui remplit le formulaire intégrée en texte clair dans le contenu.

Charset

Le jeu de caractères par défaut du Formmailer est iso-8859-1.

Si votre page est rédigée dans un autre jeu de caractères, vous devez configurer cet aspect dans le Formmailer pour que les données soient correctement présentées dans l’e-mail.

Pour cela, veuillez utiliser le champ «charset»:

Classer les champs dans l’e-mail

Vous pouvez classer les champs du formulaire par ordre alphabétique ou selon un ordre que vous définissez vous-même.

Si vous ne classez pas les champs, ils sont présentés au hasard et non comme vous les avez énumérés sur votre page Web.

Ainsi, il n’est possible de classer les e-mails selon l’ordre adopté sur la page Web que si vous les classez dans le champ «sort».

Classement alphabétique

Classement individuel

Dans ce cas, c’est d’abord la commande, puis le nom qui apparaissent dans l’e-mail.

S’il existe d’autres champs, ils sont ajoutés à la suite.

Page de succès et page d’erreur

Vous pouvez créer votre propre page Web pour l’envoi avec succès et pour l’échec de l’envoi du formulaire et la faire afficher de façon automatique.

Pour la page d’erreur, vous recevez les champs erronés sous forme de paramètres GET et pouvez les lire avec un langage de programmation.

Page de succèss

Page d’erreur

Paramètres avancés du Formmailer

Bien sûr, vous pouvez aussi configurer votre formulaire de façon plus détaillée.

Le visiteur peut joindre au formulaire un fichier à votre attention

Le visiteur peut vous envoyer des fichiers.

Pour cela, vous devez d’abord rendre le formulaire adapté à des fichiers. Ajoutez l’option enctype="multipart/form-data":

Chaque champ auquel un fichier peut être joint doit commencer par file_ et avoir le type file.

Informations sur l’adresse IP ou le navigateur

Vous pouvez insérer des variables d’environnement, c’est-à-dire des informations sur l’environnement du visiteur.

Il peut s’agir de l’adresse IP, du nom du navigateur utilisé et du nom utilisé sur Internet pour l’ordinateur du visiteur.

Variables d’environnement

REMOTE_HOST

Fournit le nom utilisé sur Internet pour l’ordinateur du visiteur

REMOTE_ADDR

Fournit l’adresse IP du visiteur

HTTP_USER_AGENT

Fournit le nom du navigateur et le système d’exploitation du visiteur

Qu’est-ce qui doit apparaître dans l’e-mail?

En général, tous les champs de l’e-mail sont transmis. Mais vous pouvez cacher les champs.

Cacher des champs

Ici, les champs «redirect», «sort», «missing_field_redirect» et «bcc_mail» n’apparaissent pas dans l’e-mail:

Vérification des données saisies dans le formulaire

Vous pouvez simplement vérifier l’existence des variables ou les comparer à d’autres variables.

Champ obligatoire

Vous pouvez p. ex. utiliser ce paramètre dans un formulaire dans lequel une adresse doit être saisie.

Vérification par rapport à une expression régulière

Vous pouvez ajouter une expression régulière avec [feld]_regex.

Journalisation

Logfile

Vous pouvez en outre enregistrer dans un fichier les messages qui vous sont transmis.

Le journal (log) est archivé dans le dossier formmail/log dans le même répertoire que celui où se trouve «public_html» ou «www».

Vous pouvez définir le fichier journal avec le paramètre logfile.

Voyez ci-dessous comment définir le fichier comme fichier journal:

Templates

Vous pouvez adapter individuellement l’apparence de l’e-mail que vous recevez.

Créer des templates

Vous pouvez définir précisément à quoi doit ressembler l’e-mail que vous recevez.

Pour cela, dans le dossier formmail/templates dans le répertoire FTP racine, créez un fichier avec le nom de votre choix. Nous nommons le template «inscription.txt».

Ecrivez dans ce fichier à quoi doit ressembler l’e-mail. Les noms entre crochets sont remplacés par le champ correspondant.

Exemple

Le contenu du fichier inscription.txt pourrait se présenter ainsi:

Un e-mail envoyé avec les données du client pourrait donc ressembler à ceci:

Utiliser des templates

Je viens avec mon épouse et j’apporte un gâteau.

Template pour l’e-mail que vous recevez

Conception de la page de succès et de la page d’erreur

Vous pouvez aussi modifier la page de succès et la page d’erreur sans propre page HTML. Ces options ne sont pertinentes que si vous ne créez pas votre propre page de succès ou d’erreur.

Fond

Image de fond de la page de succès ou d’erreur

Couleur de fond de la page de succès ou d’erreur

Image de fond de la page de succès

Couleur de fond de la page de succès

Image de fond de la page d’erreur

Couleur de fond de la page d’erreur

Titre

Le titre de la page de succès et de la page d’erreur peut être défini comme suit:

Titre de la page de succès

Titre de la page d’erreur

Particularités de la page d’erreur

Si vous laissez Formmailer générer la page d’erreur, les champs seront présentés de la façon suivante:

Donc, par exemple:

email:
test@votre-propre-domaine.ch

Vous pouvez modifier la couleur de «[champ]» avec le paramètre error_key_color, et celle de «[valeur]» avec error_value_color:

Couleur de «[champ]»

Couleur de fond de la page d’erreur

Exemples

Voilà à quoi pourrait ressembler un formulaire.

Formulaire d’invitation à une fête

Le code se présente ainsi:

L’e-mail que vous recevez pourrait alors se présenter ainsi:

Formulaire avec vérification

Vous voulez créer un formulaire pour une inscription à un cours et vérifier les variables.

Dans ce formulaire doivent être saisis un nom, un prénom, un cours et un niveau. L’âge doit être composé de deux chiffres exactement.

Le code se présente ainsi: