Formulários

Os formulários são o construtor do Chinaski para formulários de contato, inscrição e captura de leads, com gerenciamento de submissões, emails de confirmação e para administradores, webhooks por formulário, defesas contra spam e controles de privacidade. Os formulários vivem em sua própria seção administrativa, são publicados tanto em sua própria URL quanto incorporados em páginas construídas, e são documentados nestas páginas:

• Campos e o construtor de formulários: tipos de campo, regras de validação, exibição condicional, uploads de arquivos.
• Submissões: para onde as respostas vão, limites de taxa, retenção e proteção contra duplicatas.
• Emails & webhooks: emails de confirmação e notificação, webhooks assinados por formulário.
• Spam & privacidade: Turnstile, bloqueio por país, honeypot e chaves de minimização de dados.

Orientação rápida

Um formulário consiste em três coisas:

1. O formulário: seu nome, slug de URL (usado tanto para seu próprio endereço quanto para o shortcode de incorporação), estado de publicação e configurações de apresentação (mensagem de sucesso, redirecionamento para página de agradecimento, texto/cores do botão de envio).
2. Seus campos: uma lista ordenada de campos tipados, validados e opcionalmente condicionais.
3. Seu tratamento: o que acontece ao enviar: armazenar a submissão (com retenção), enviar emails, disparar um webhook.

Criando e publicando um formulário

• Autônomo: com um slug definido, o formulário é servido em /forms/<slug> no CMS. Um formulário inativo retorna 404 em vez disso.
• Incorporado em uma página: coloque um shortcode [form:<slug>] no corpo de uma página/post. O builder renderiza o formulário inline no momento do build; a saída pública não precisa de conectividade com o CMS para exibir o formulário. Se um formulário referenciado não estiver disponível para o builder, o shortcode faz fallback para incorporar o formulário hospedado no CMS em um iframe (requer que a URL base do CMS esteja configurada).

Como o site é estático, as submissões fazem POST direto de volta ao servidor do CMS; a coisa a verificar ao mudar de hospedagem é que a URL do CMS esteja alcançável onde quer que o formulário esteja incorporado.

Padrões que importam

Todo formulário novo começa com uma base sensata: as submissões são armazenadas (sem limite de retenção), o endereço IP é armazenado com cada submissão, as configurações de webhook/email ficam em branco, e o Cloudflare Turnstile é habilitado por formulário (ele só realmente roda quando as chaves do Turnstile estão configuradas no site inteiro). Cada um desses itens é ajustável no formulário, incluindo "não armazenar IPs" e "deletar submissões após N dias"; veja as subpáginas linkadas.

Onde gerenciar submissões

As entradas submetidas são visualizáveis e pesquisáveis na seção de Forms da administração, com visualizações por formulário e a habilidade de deletar (o que também limpa quaisquer arquivos enviados que pertençam a essas submissões). A limitação de taxa impede que um único visitante inunde o sistema: 5 submissões a um formulário por hora, e 30 por hora no total entre todos os formulários.

Nesta seção

• Campos de Formulário
• Submissões de Formulário
• Emails & Webhooks de Formulário
• Spam & Privacidade de Formulário