Code
HTML *°
Code
DIVERS
- Recevoir des soumissions
- Exportation de soumissions
- Suppression de soumissions
- Intégration de fonctions sans serveur
- Filtrage de spam
- Formulaire AJAX
- Formulaires rendus par JavaScript
- Les notifications
- Des conseils de dépannage
- Utilisation et facturation
----------------------------------
Formes
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 /
.
Recevoir des soumissions
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
TĂLĂCHARGEMENT DE FICHIERS
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.
Exportation de soumissions
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.
Suppression de soumissions
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.
Intégration de fonctions sans serveur
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 .
Filtrage de spam
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.
CHAMP DE MIEL
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.
RECAPTCHA EXPLICITE 2
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:
- Ajoutez un
data-netlify-recaptcha="true"
attribut Ă votre<form>
tag. - Ă l'endroit oĂč vous souhaitez que le CAPTCHA apparaisse, ajoutez un
<div>
Ă©lĂ©ment vide dans votre formulaire avec le mĂȘmedata-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.
RECAPTCHA 2 PERSONNALISĂ AVEC VOS PROPRES PARAMĂTRES
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é:
- Inscrivez-vous pour une paire de clés API reCAPTCHA et suivez les instructions pour ajouter reCAPTCHA à votre site. Cela implique généralement l'ajout d'un script avant la fermeture
</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.
- Ajoutez un
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.
CHANGER L'ĂTAT D'UNE SOUMISSION
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é .
Formulaire AJAX
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.
Formulaires rendus par JavaScript
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:
- Comment intégrer la gestion des formulaires de Netlify dans une application React
- Comment intégrer des formulaires Netlify dans une application Vue
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.
Les notifications
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.
NOTIFICATIONS PAR EMAIL
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.
INTĂGRATION DE 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
Des conseils de dépannage
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
- entrez une adresse email réelle au lieu d'une adresse fictive telle que test@test.com.
- écrivez des phrases complÚtes dans n'importe quelle zone de texte plutÎt que quelques caractÚres insensés.
- Ă©talez le taux de soumissions d'une seule adresse IP.
Visitez notre forum communautaire pour obtenir plus de conseils sur la façon de déboguer votre formulaire .
Utilisation et facturation
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:
- Soumissions : Ceci compte le nombre total de soumissions vérifiées sur tous les formulaires de votre site au cours de cette période de facturation.
- Téléchargement de fichiers : permet de suivre la taille de stockage totale de tous les fichiers téléchargés via les soumissions de formulaires vérifiées au cours de la période de facturation en cours.
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.
CHANGEMENT DE NIVEAU
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.