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:
FROM: Hans Muster <no-reply@hostpoint.ch>
TO: Info <info@votre-propre-domaine.ch>
SUBJECT: Formulaire de contact
recipient: info@votre-propre-domaine.ch
comment: S'il vous plaît envoyez-moi plus d'informations sur vos offres
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:
Nom: Dupont
Prénom: Pierre
Rue: Rue Example 1
CP/Localité: 1234 Ville Exemple
Remarque:
Je viens avec mon épouse et j’apporte un gâteau.
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:
bring: gâteau à la carotte
persons: 5
realname: Hans Muster
transport: Auto
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:
Pour envoyer une demande d'assistance au support, merci d'utiliser ce formulaire-ci.