Formularios
Forms es el builder de Chinaski para formularios de contacto, registro y captación de leads: con gestión de submissions, correos de confirmación y para admins, webhooks por form, defensas contra spam y controles de privacidad. Los forms viven en su propia sección del admin, se publican ya sea en su propia URL o incrustados en páginas built, y están documentados a lo largo de estas páginas:
- Fields y el form builder: tipos de campos, reglas de validación, visualización condicional, carga de archivos.
- Submissions: a dónde van las respuestas, rate limits, retención y protección contra duplicados.
- Emails y webhooks: correos de confirmación y notificación, webhooks firmados por form.
- Spam y privacidad: Turnstile, bloqueo por país, honeypot y switches de minimización de datos.
Orientación rápida
Un form consiste en tres cosas:
- El form: su nombre, slug de URL (usado tanto para su propia dirección como para su shortcode de embed), estado de publicación y ajustes de presentación (mensaje de éxito, redirección a página de thank-you, texto/colores del botón de envío).
- Sus fields: una lista ordenada de fields tipados, validados y opcionalmente condicionales.
- Su manejo: qué pasa al enviar: almacenar la submission (con retención), enviar correos, disparar un webhook.
Crear y publicar un form
- Standalone: con un slug definido, el form se sirve en
/forms/<slug>en el CMS. Un form inactivo devuelve 404 en su lugar. - Incrustado en una página: pon un shortcode
[form:<slug>]en el cuerpo de una página/post. El builder renderiza el form inline en build time: la salida pública no necesita conectividad con el CMS para mostrar el form. Si un form referenciado no está disponible para el builder, el shortcode hace fallback a incrustar el form alojado en el CMS en un iframe (requiere que el base URL del CMS esté configurado).
Como el site es estático, las submissions hacen POST directamente de vuelta al servidor del CMS: lo que hay que verificar al cambiar de hosting es que la URL del CMS sea alcanzable donde sea que el form esté incrustado.
Defaults que importan
Cada form nuevo comienza con una base sensata: las submissions se almacenan (sin límite de retención), la dirección IP se almacena con cada submission, los ajustes de webhook/email están en blanco, y Cloudflare Turnstile está habilitado por form (solo se ejecuta realmente cuando las llaves de Turnstile están configuradas a nivel de site). Cada uno de estos puntos es ajustable en el form, incluyendo "no almacenar IPs" y "eliminar submissions después de N días"; ver las subpáginas enlazadas.
Dónde gestionar las submissions
Las entradas enviadas se pueden ver y buscar en la sección Forms del admin, con vistas por form y la capacidad de eliminar (lo que también limpia cualquier archivo subido que pertenezca a esas submissions). El rate limiting evita que un solo visitante sature: 5 submissions a un form por hora, y 30 por hora en total entre todos los forms.
En esta sección
También en Formularios
Configura los campos de un formulario en Chinaski: tipos, nombres y etiquetas, validación, opciones, subida de archivos y condiciones de visibilidad.
Qué guarda Chinaski en cada envío de formulario, más los límites de frecuencia, la retención y cómo se confirma un envío exitoso al visitante.
Configura qué ocurre al enviar un form: email de confirmación al remitente, email de notificación al admin y webhook a un sistema externo.
Protege los formularios del spam: Turnstile, bloqueo por país, honeypot, filtro de spam, y ajustes de almacenamiento de IP y retención.