----------------------------------
Netlify est livré avec une gestion de formulaire intégrée. Nos générateurs de logiciels le font en analysant directement vos fichiers HTML au moment du déploiement. Vous n'avez donc pas besoin de passer un appel d'API ou d'inclure du code JavaScript supplémentaire sur votre site.
Codez un formulaire HTML dans n'importe quelle page de votre site, ajoutez un netlify
attribut ou data-netlify="true"
Ă la <form>
balise, et vous pourrez commencer Ă recevoir des soumissions dans le panneau d'administration de votre site Netlify.
L' name
attribut de votre formulaire détermine ce que nous appelons le formulaire dans l'interface de l'application Netlify. Si vous avez plusieurs formulaires sur un site, chaque formulaire doit avoir un name
attribut différent .
Voici un exemple:
<form name="contact" method="POST" data-netlify="true">
<p>
<label>Your Name: <input type="text" name="name" /></label>
</p>
<p>
<label>Your Email: <input type="email" name="email" /></label>
</p>
<p>
<label>Your Role: <select name="role[]" multiple>
<option value="leader">Leader</option>
<option value="follower">Follower</option>
</select></label>
</p>
<p>
<label>Message: <textarea name="message"></textarea></label>
</p>
<p>
<button type="submit">Send</button>
</p>
</form>
Par défaut, lorsque les visiteurs remplissent un formulaire, ils voient un message de réussite de style générique avec un lien vers la page du formulaire. Vous pouvez remplacer le message de réussite par défaut par une page personnalisée que vous créez en ajoutant un action
attribut Ă la <form>
balise, en entrant le chemin de votre page personnalisée (comme "/pages/success"
) en tant que valeur. Le chemin doit ĂȘtre relatif Ă la racine du site, en commençant par a /
.
Vous pouvez trouver toutes les soumissions à vos formulaires Netlify dans l' onglet Formulairesdu tableau de bord de votre site. Sélectionnez un nom de formulaire dans la liste des formulaires actifs pour accéder aux soumissions pour ce formulaire. Par défaut, seules les soumissions vérifiées sont répertoriées. Vous pouvez passer aux spams via un menu déroulant au-dessus de la liste. Il est possible d' exporter des soumissions vérifiées dans un fichier CSV. Vous pouvez également accéder aux soumissions via notre API .
Netlify dispose de plusieurs options de notification intĂ©grĂ©es pour l'envoi de formulaires vĂ©rifiĂ©s, notamment des notifications par courrier Ă©lectronique et Slack. Vous pouvez les trouver dans ParamĂštres> Formulaires> Notifications de formulaire . SĂ©lectionnez le menu dĂ©roulant Ajouter une notification pour voir vos options. (Cette fonctionnalitĂ© peut ne pas ĂȘtre disponible sur tous les forfaits .)
Netlify s'intÚgre également à Zapier afin que vous puissiez configurer des déclencheurs qui envoient vos soumissions de formulaires vérifiées à l'une des 500 applications et plus de leur catalogue.
Utilisez ce lien pour accéder à l'application Netlify Zapier: Netlify sur Zapier
Netlify Forms peut recevoir des fichiers téléchargés via des soumissions de formulaire. Pour ce faire, ajoutez une entrée type="file"
Ă nâimporte quel formulaire. Lorsqu'un formulaire est soumis, un lien vers chaque fichier tĂ©lĂ©chargĂ© sera inclus dans les dĂ©tails de la soumission du formulaire. Celles-ci sont visibles dans l'application Netlify, dans les notifications par courrier Ă©lectronique et via notre API.
Dans l'application Netlify, vous pouvez exporter les soumissions de formulaires vérifiés dans un fichier CSV. Dans l' onglet Formulaires , sélectionnez le formulaire que vous souhaitez exporter, puis cliquez sur le bouton Télécharger en tant que CSV situé en haut de la page de détail du formulaire.
Pour sélectionner une ou plusieurs soumissions de formulaire d'un formulaire particulier, cochez la case en regard de chaque titre de soumission.
AprĂšs avoir sĂ©lectionnĂ© la ou les soumissions, un bouton rouge Supprimer sera disponible. Lorsque vous cliquez sur le bouton de suppression, vous ĂȘtes invitĂ© Ă confirmer l'action de suppression. Une fois que vous avez confirmĂ©, les envois sĂ©lectionnĂ©s seront dĂ©finitivement supprimĂ©s.
Vous pouvez intégrer vos formulaires aux fonctions sans serveur de Netlify en déclenchant une fonction lors de l'envoi de formulaires vérifiés. Pour en savoir plus, consultez la documentation sur les fonctions .
Akismet , lâun des leaders du marchĂ© en matiĂšre de dĂ©tection de spam, filtre toutes les formes de spam envoyĂ©es . Seules les soumissions qui passent le filtre sont incluses dans la liste des soumissions vĂ©rifiĂ©es de votre formulaire . On peut trouver les soumissions marquĂ©s comme spam par Akismet en passant Ă votre formulaire soumissions Spam liste.
Pour une protection supplĂ©mentaire, vous pouvez ajouter un champ pot de miel et / ou un dĂ©fi reCAPTCHA 2 explicite . Nous rejetons automatiquement les soumissions qui ne rĂ©pondent pas Ă ces dĂ©fis. Les envois indĂ©sirables capturĂ©s par un champ pot de miel ou reCAPTCHA 2 ne seront mĂȘme pas inclus dans les envois de spam de votre formulaire.
Les champs «pot de miel» sont des champs de formulaire cachĂ©s qui incitent les utilisateurs de bot Ă remplir un champ que les utilisateurs humains ne peuvent pas voir. Un formulaire soumis avec un champ pot de miel rempli peut ĂȘtre rejetĂ© en toute sĂ©curitĂ©, car seul un bot verrait et complĂ©terait le champ. Vous pouvez avertir Netlify d'un champ pot de miel cachĂ© en ajoutant un netlify-honeypot
attribut Ă votre <form>
avec le nom de votre champ caché. Assurez-vous ensuite que ce champ est présent dans le formulaire, mais masqué via CSS ou JavaScript.
Voici un exemple:
<form name="contact" method="POST" netlify-honeypot="bot-field" data-netlify="true">
<p class="hidden">
<label>Donât fill this out if you're human: <input name="bot-field" /></label>
</p>
<p>
<label>Email: <input type="text" name="email" /></label>
</p>
<p>
<label>Message: <textarea name="message"></textarea></label>
</p>
<p>
<button type="submit">Send</button>
</p>
</form>
Désormais, si quelqu'un entre une valeur dans le bot-field
, Netlify rejettera discrĂštement la soumission du formulaire.
Si vous souhaitez ajouter un défi reCAPTCHA 2 à un formulaire, Netlify peut en inclure un pour vous ou vous pouvez en ajouter un . Pour que Netlify fournisse le CAPTCHA:
data-netlify-recaptcha="true"
attribut Ă votre <form>
tag.<div>
Ă©lĂ©ment vide dans votre formulaire avec le mĂȘme data-netlify-recaptcha="true"
attribut.Lors de la publication de votre site, le formulaire inclura le code HTML nécessaire pour rendre le CAPTCHA.
Voici un exemple:
<form name="contact" method="POST" data-netlify-recaptcha="true" data-netlify="true">
<p>
<label>Email: <input type="text" name="name" /></label>
</p>
<p>
<label>Message: <textarea name="message"></textarea></label>
</p>
<div data-netlify-recaptcha="true"></div>
<p>
<button type="submit">Send</button>
</p>
</form>
Lorsqu'un visiteur soumet le formulaire, nos serveurs valideront le serveur CAPTCHA. Si la validation Ă©choue, nous redirigeons le visiteur vers la mĂȘme page et rejetons la soumission du formulaire.
Vous pouvez également ajouter votre propre code reCAPTCHA 2 sur votre site et laisser Netlify valider que les formulaires soumis proviennent d'un humain. Ceci est utile si vous souhaitez avoir plus de contrÎle sur vos validations ou si vous utilisez une bibliothÚque JavaScript pour injecter un CAPTCHA dans vos formulaires.
Dans ce cas, Netlify a besoin de votre clé de site reCAPTCHA2 et de votre secret pour valider l'exactitude de la réponse captcha. Vous pouvez fournir ces valeurs via des variables d'environnement dans les paramÚtres de votre site. Utilisez SITE_RECAPTCHA_KEY
pour définir la clé de votre site et SITE_RECAPTCHA_SECRET
pour définir le secret fourni par reCAPTCHA 2.
Pour configurer un reCAPTCHA personnalisé:
</head>
de votre modĂšle HTML et d'un extrait de code Ă la fin de l' <form>
emplacement oĂč vous souhaitez que le widget reCAPTCHA apparaisse.2.Connectez-vous Ă votre tableau de bord Netlify et ajoutez les variables d'environnement suivantes au panneau ParamĂštres> Construire et dĂ©ployer> Environnement> Variables d'environnement :
SITE_RECAPTCHA_KEY
avec la clé de site API reCAPTCHA.SITE_RECAPTCHA_SECRET
avec la clé secrÚte de l'API reCAPTCHA.data-netlify-recaptcha="true"
attribut au formulaire HTML contenant le widget reCAPTCHA personnalisé.<form name="contact" method="POST" data-netlify-recaptcha="true" data-netlify="true">
<!-- input fields and custom reCAPTCHA snippet -->
</form>
Les serveurs Netlify vĂ©rifient les envois de ce formulaire et ne les acceptent que sâils incluent une g-recaptcha-response
valeur valide .
Si vous envoyez votre formulaire via AJAX, assurez-vous que le g-recaptcha-response
champ est inclus dans le corps de la demande POST.
Vous pouvez modifier l'état d'une soumission de spam à vérifié ou vice versa. Pour ce faire, sélectionnez une ou plusieurs soumissions, puis utilisez le bouton Marquer comme spam ou Marquer comme vérifié .
Vous pouvez également soumettre des formulaires via AJAX / XHR, en utilisant l' action
attribut du formulaire comme cible de la demande AJAX.
Notez que Netlify ajoute automatiquement à votre formulaire publié un champ masqué appelé form-name
avec une valeur correspondant Ă l' name
attribut du formulaire lorsque vous envoyez un formulaire HTML au lieu de le générer avec JavaScript. Assurez-vous d'inclure ce champ dans votre demande AJAX!
Voici un exemple simple de jQuery:
$("#my-form").submit(function(e) {
e.preventDefault();
var $form = $(this);
$.post($form.attr("action"), $form.serialize()).then(function() {
alert("Thank you!");
});
});
Notez que le contenu de la demande AJAX doit ĂȘtre codĂ© en URL. Dans l'exemple ci-dessus, la serialize()
fonction jQuery gÚre le codage de l'URL. Les formulaires Netlify ne prennent pas en charge les données de formulaire JSON pour le moment.
Nos robots trouvent vos formulaires en analysant le code HTML de votre site une fois la construction terminée. Cela signifie que si vous utilisez JavaScript pour restituer un formulaire cÎté client, nos robots ne le trouveront pas dans les fichiers prédéfinis. Vous pouvez contourner ce problÚme en créant un formulaire HTML masqué avec l' data-netlify="true"
attribut et des champs de saisie avec des name
attributs correspondant aux entrĂ©es de votre formulaire rendu par JavaScript. Si vous souhaitez utiliser notre intĂ©gration reCAPTCHA2, vous devez appliquer le mĂȘme traitement et crĂ©er un div
élément dans le code HTML masqué avec l' data-netlify-recaptcha="true"
attribut.
Vous pouvez également trouver des tutoriels sur notre blog:
Bien que les deux articles soient assez spécifiques à un framework, le code montre comment prérender des formulaires lorsque vous les utilisez dans une application Web.
Cette fonctionnalitĂ© peut ne pas ĂȘtre disponible sur tous les forfaits .
Vous pouvez envoyer des notifications pour l'envoi de formulaires vérifiés à partir du tableau de bord de votre site dans ParamÚtres> Formulaires> Notifications de formulaire .
Ces notifications peuvent ĂȘtre envoyĂ©es par courrier Ă©lectronique, Webhook ou Slack. Dans les options de configuration, vous pouvez choisir dâĂȘtre averti pour un seul formulaire spĂ©cifique ou pour toutes les soumissions vĂ©rifiĂ©es vers nâimporte quel formulaire de votre site.
Tous les courriels de notification sont envoyés à team@netlify.com et toute réponse à une notification sera envoyée à cette adresse. Si vous souhaitez répondre à un utilisateur du formulaire, vous devrez entrer son adresse manuellement.
L'objet par défaut pour toutes les notifications de formulaire est le suivant:
Soumission de formulaire Ă partir du formulaire {YOUR-FORM-NAME}
Pour remplacer cela, ajoutez un subject
champ Ă votre formulaire et la valeur de ce champ sera utilisĂ©e pour le sujet de l'e-mail de notification. Ce champ n'a pas besoin d'ĂȘtre visible pour vos utilisateurs.
Pour un meilleur contrÎle des courriels déclenchés par un formulaire ou pour vous connecter à d'autres services, vous pouvez utiliser l'application Netlify sur Zapier.
Netlify est disponible sur Zapier, oĂč vous pouvez connecter Netlify Ă plus de 1 000 autres applications. Vous pouvez configurer une action «Zap» pour qu'elle soit dĂ©clenchĂ©e lors de la soumission d'un formulaire vĂ©rifiĂ© sur votre site Web. Vous pouvez en savoir plus sur notre blog ou utiliser l'un des modĂšles ci-dessous pour commencer:
Démarrez le déploiement de votre site Netlify aprÚs de nouvelles soumissions de formulaires Netlify.
Envoyer des e-mails Gmail pour les nouvelles soumissions de formulaires Netlify
Enregistrer les nouvelles soumissions de formulaire Netlify sous forme de lignes dans Google Sheets
Créez des pistes Salesforce à partir des nouvelles soumissions de formulaire Netlify
Créez des abonnés MailChimp à partir des nouvelles soumissions de formulaires Netlify
Créer des tickets Zendesk pour les nouvelles soumissions de formulaires Netlify
Voir plus d' intégrations Netlify propulsé par
Si vous ne parvenez pas Ă utiliser le formulaire action
pour personnaliser la page de rĂ©ussite, essayez de vous connecter Ă votre page de rĂ©ussite personnalisĂ©e Ă partir de quelque part sur la mĂȘme page que le formulaire. Utilisez le mĂȘme chemin exact dans votre lien de test que vous essayez d'utiliser pour l' action
attribut et assurez-vous que le lien y fonctionne avant de creuser davantage dans votre formulaire.
Si vous envoyez des soumissions tests de votre formulaire et que vous ne les trouvez pas dans votre liste de soumissions vérifiées , il est possible qu'elles soient signalées comme spam par Akismet. Utilisez le menu déroulant situé au-dessus de la liste pour passer aux envois de spam, puis vérifiez à nouveau pour vos tests.
Pour éviter que vos tests ne soient signalés comme spam en premier lieu, nous vous recommandons
Visitez notre forum communautaire pour obtenir plus de conseils sur la façon de déboguer votre formulaire .
Vous pouvez vĂ©rifier lâutilisation de votre service Formulaires sous ParamĂštres> Formulaires> Gestion des formulaires> Utilisation . Cela montre votre niveau d'utilisation actuel et suit votre utilisation des services suivants:
La tarification des formulaires varie en fonction de l'utilisation. Lorsque l'utilisation atteint une limite de niveau, le site passe automatiquement au niveau ou au package suivant.
Tout membre de l'équipe ayant la possibilité de modifier les paramÚtres de votre site peut également modifier les niveaux des services sur ce site.
Pour ce faire, accédez à ParamÚtres> Formulaires> Gestion des formulaires> Utilisation , puis sélectionnez Modifier le niveau . Les frais supplémentaires seront calculés au prorata et facturés à la fin du cycle de facturation, selon le mode de paiement de l'équ
Visitez la communauté Netlify pour discuter des idées et des questions avec les autres utilisateurs de Netlify.