Hecho con Chinaski

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.

Lee este sitio en