Formulário

O bloco form incorpora um formulário enviável em uma página ou post. Ele não define seus próprios campos; em vez disso, faz referência a um registro de Formulário criado separadamente em Forms na administração, e renderiza automaticamente os campos desse formulário.

Correção: uma tabela de resumo mais antiga descreve este bloco como tendo um campo de "URL de ação". Isso está incorreto e desatualizado. Não existe campo de URL de ação. O bloco referencia um registro de Formulário por form_id; no momento da renderização, o bloco busca os campos desse formulário e envia os dados para /forms/<slug> (o slug do formulário vinculado), automaticamente.

Campos

Campo	Descrição	Obrigatório?
form_id	O registro de Formulário vinculado, escolhido em uma lista suspensa de formulários já criados em Forms na administração.	Sim
heading	Título exibido acima do formulário. Exemplo de placeholder: "Get in touch".	Não
subheading	Texto curto de apoio exibido abaixo do título.	Não
button_text	Rótulo do botão de envio. Volta para o texto de envio configurado no próprio formulário, ou "Submit", se deixado em branco.	Não

Segurança de HTML

heading, subheading e o rótulo resolvido do botão de envio são todos escapados e renderizados como texto simples. Todos os campos deste bloco são escapados como texto simples; não há campo de HTML bruto aqui. Os campos de entrada reais do formulário (texto, email, checkboxes e assim por diante) vêm do registro de Formulário vinculado, não deste bloco, e são renderizados pelo renderizador padrão de campos de formulário.

Este bloco também suporta cor de fundo, padding e margin como controles de aparência (ele não tem controles separados de cor do texto ou de borda).

Como usar

{{block:contact-form​}}

Normalmente posicionado em uma página "Contact", ou incorporado no meio de uma landing page como uma chamada para ação de captura de leads. Se o bloco não tiver um form_id definido (nenhum formulário vinculado), nada é renderizado na página, pois não há dados de formulário a partir dos quais construí-lo.

Exemplo

Uma página de contato usando um formulário "General inquiry" criado em Forms na administração, com campos de nome, email e mensagem:

Campo	Valor
form_id	General inquiry (registro de Formulário existente)
heading	Get in touch
subheading	We'll get back to you within one business day.
button_text	Send message

No momento do build, o bloco resolve o slug (digamos general-inquiry) e os campos do formulário "General inquiry", e renderiza um <form> que envia os dados para /forms/general-inquiry. Se esse formulário tiver proteção contra spam (Cloudflare Turnstile) configurada, o widget é renderizado automaticamente acima do botão de envio; nenhuma configuração extra é necessária no próprio bloco.