Formulaire

Le block form intègre un formulaire pouvant être soumis dans une page ou un article. Il ne définit pas ses propres champs ; à la place, il pointe vers un enregistrement Form créé séparément sous Forms dans l'admin, et rend automatiquement les champs de ce formulaire.

Correction : un ancien tableau récapitulatif décrit ce block comme possédant un champ "action URL". C'est incorrect et périmé. Il n'existe pas de champ d'URL d'action. Le block pointe vers un enregistrement Form via form_id ; au moment du rendu, le block récupère les champs de ce formulaire et envoie les données vers /forms/<slug> (le slug du formulaire lié), automatiquement.

Champs

Champ	Description	Requis ?
form_id	L'enregistrement Form lié, choisi dans une liste déroulante des formulaires déjà créés sous Forms dans l'admin.	Oui
heading	Titre affiché au-dessus du formulaire. Exemple de placeholder : "Get in touch".	Non
subheading	Court texte de soutien affiché sous le titre.	Non
button_text	Libellé du bouton de soumission. Retombe sur le texte de soumission propre au formulaire, ou sur "Submit", s'il est laissé vide.	Non

Sécurité HTML

Le heading, le subheading et le libellé résolu du bouton de soumission sont tous échappés et rendus en texte brut. Tous les champs de ce block sont échappés en texte brut ; il n'y a aucun champ HTML brut ici. Les champs de saisie réels du formulaire (texte, e-mail, cases à cocher, etc.) proviennent de l'enregistrement Form lié, pas de ce block, et sont rendus par le moteur de rendu de champs de formulaire standard.

Ce block prend également en charge la couleur de fond, le padding et la margin comme contrôles d'apparence (il n'a pas de contrôles distincts de couleur de texte ou de bordure).

Utilisation

{{block:contact-form​}}

Généralement placé sur une page "Contact", ou intégré au milieu d'une landing page comme appel à l'action de capture de leads. Si le block n'a pas de form_id défini (aucun formulaire lié), rien n'est rendu sur la page, puisqu'il n'y a aucune donnée de formulaire à partir de laquelle le construire.

Exemple

Une page de contact utilisant un formulaire "General inquiry" créé sous Forms dans l'admin, avec des champs pour le nom, l'e-mail et le message :

Champ	Valeur
form_id	General inquiry (enregistrement Form existant)
heading	Get in touch
subheading	We'll get back to you within one business day.
button_text	Send message

Au moment du build, le block résout le slug (disons general-inquiry) et les champs du formulaire "General inquiry", et rend un <form> qui envoie les données vers /forms/general-inquiry. Si ce formulaire a une protection anti-spam (Cloudflare Turnstile) configurée, le widget est rendu automatiquement au-dessus du bouton de soumission ; aucune configuration supplémentaire n'est nécessaire sur le block lui-même.