Formulario
El block form incrusta un formulario que se puede enviar en una página o entrada. No define sus propios campos; en su lugar, enlaza a un registro de Form que se crea por separado en Forms en el backend, y renderiza automáticamente los campos de ese formulario.
Corrección: una tabla de resumen anterior describe este block como si tuviera un campo de "action URL". Eso es incorrecto y está desactualizado. No hay campo de action URL. El block enlaza a un registro de Form mediante form_id; en el momento del render, el block toma los campos de ese formulario y hace post a /forms/<slug> (el slug del formulario enlazado), automáticamente.
Campos
| Campo | Descripción | ¿Obligatorio? |
|---|---|---|
form_id | El registro de Form enlazado, elegido de una lista desplegable de formularios ya creados en Forms en el backend. | Sí |
heading | Encabezado mostrado encima del formulario. Ejemplo de placeholder: "Get in touch". | No |
subheading | Texto de apoyo breve mostrado debajo del encabezado. | No |
button_text | Etiqueta del botón de envío. Recurre al texto de envío configurado del propio formulario, o "Submit", si se deja en blanco. | No |
Seguridad HTML
heading, subheading y la etiqueta resuelta del botón de envío se escapan y renderizan como texto plano. Todos los campos de este block se escapan como texto plano; aquí no hay ningún campo de HTML sin procesar. Los campos de entrada reales del formulario (texto, email, casillas de verificación, etc.) provienen del registro de Form enlazado, no de este block, y los renderiza el renderizador estándar de campos de formulario.
Este block también admite color de fondo, padding y margin como controles de apariencia (no tiene controles separados de color de texto ni de borde).
Cómo usarlo
{{block:contact-form}} Normalmente se coloca en una página de "Contacto", o incrustado a media altura en una landing page como un llamado a la acción para capturar contactos. Si el block no tiene ningún form_id definido (ningún formulario enlazado), no se renderiza nada en la página, ya que no hay datos de formulario con los que construirlo.
Ejemplo
Una página de contacto que usa un formulario de "General inquiry" creado en Forms en el backend, con campos para nombre, email y mensaje:
| Campo | Valor |
|---|---|
form_id | General inquiry (registro de Form existente) |
heading | Get in touch |
subheading | We'll get back to you within one business day. |
button_text | Send message |
En el momento del build, el block resuelve el slug (digamos general-inquiry) y los campos del formulario "General inquiry", y renderiza un <form> que hace post a /forms/general-inquiry. Si ese formulario tiene protección contra spam (Cloudflare Turnstile) configurada, el widget se renderiza automáticamente encima del botón de envío; no se necesita configuración adicional en el block mismo.