Estou no WordPress.com — isto funciona?

Sim — mas apenas no plano Business ou superior (ou qualquer plano pago com pelo menos um plugin de terceiros ativado). O plano gratuito e o Personal não permitem código personalizado. O WordPress.org auto-alojado não tem esta restrição.

Funciona com o Editor Clássico?

Sim. No Editor Clássico, muda para o separador Texto (não Visual) e cola as duas linhas. Guarda. O formulário aparece da mesma forma que no Block Editor.

E o Elementor, Divi e outros construtores de páginas?

Sim. O Elementor e o Divi têm widgets HTML — coloca um, cola o snippet, guarda. O mesmo com o Beaver Builder e a maioria dos outros construtores de páginas.

Funciona com AMP para WordPress?

Os plugins AMP removem tags arbitrárias. Duas opções: desativa o AMP para a página específica que tem o formulário, ou ignora o AMP completamente (a maioria dos sites modernos já o faz).

Estes guias descrevem o Toimii depois que ele estiver no ar. O painel e a cobrança ainda não estão disponíveis — o Toimii será lançado em 2026.

Como incorporar um formulário de contato no WordPress sem plugin

Um bloco HTML Personalizado. Duas linhas. Sem instalar plugin, sem PHP, sem alterações à base de dados — funciona no Block Editor ou no Editor Clássico.

<script src="https://cdn.toimii.io/components/your-code.js" async></script>
<toimii-contact></toimii-contact>

Isto funciona mesmo?

Sim — no WordPress.org auto-alojado e no WordPress.com plano Business e superior. O bloco HTML Personalizado está integrado. Sem plugin necessário. Um detalhe — o teu perfil de utilizador precisa da permissão unfiltered_html (os Administradores têm-na; os Editores e Contribuidores não).

Passo a passo

Abre a página ou post

No WP Admin, vai a Páginas ou Posts e abre a entrada onde queres o formulário. Certifica-te de que estás com sessão iniciada como Administrador — os perfis Editor e Contribuidor têm os scripts removidos silenciosamente ao guardar.

Adiciona um bloco HTML Personalizado

Clica no botão + (Adicionar Bloco), procura "Custom HTML" e insere o bloco. No Editor Clássico, muda para o separador Texto.

Cola o código de incorporação

Copia as duas linhas do teu painel Toimii e cola-as no bloco. O Block Editor não pré-visualiza scripts personalizados na vista do editor — é o comportamento esperado.

Pré-visualiza

Clica em Pré-visualização. O formulário deve aparecer na página de pré-visualização — a pré-visualização é a fonte de verdade, não a vista do editor.

Publica ou atualiza

Clica em Atualizar ou Publicar. Vê o URL ao vivo para confirmar que o formulário funciona do início ao fim. Envia uma mensagem de teste.

Plano necessário

O WordPress.org auto-alojado não tem restrição de plano. O WordPress.com requer o plano Business (ou qualquer plano pago com pelo menos um plugin ativado) — os planos gratuito, Personal e Premium bloqueiam código personalizado.

Problemas comuns

O WordPress remove as tags <script> de utilizadores não-administradores silenciosamente. Editores e Contribuidores perdem o embed ao guardar sem aviso — apenas os Administradores (ou utilizadores com a permissão unfiltered_html) o conseguem manter.
Os plugins de cache (W3 Total Cache, WP Super Cache, LiteSpeed Cache) às vezes precisam de uma limpeza de cache manual após a primeira publicação para que a tag script chegue aos visitantes.
Alguns plugins de segurança (Wordfence, iThemes Security) bloqueiam scripts inline mesmo para administradores. Se o formulário não aparecer, adiciona cdn.toimii.io e api.toimii.io à lista de permissões da Firewall / Allow do plugin.
Os plugins AMP removem scripts arbitrários. Desativa o AMP para a página que aloja o formulário ou ignora o AMP completamente.
No Editor Clássico, cola no modo Texto — não no Visual. O modo Visual re-codifica o HTML em bruto.

Perguntas frequentes

Porque é que o meu embed não aparece depois de guardar?

Verifica o teu perfil de utilizador. O filtro wp_kses() do WordPress remove as tags

A incorporar noutra plataforma?

As mesmas duas linhas de código, explicadas para cada plataforma.

Squarespace

Coloca um Bloco de Código em qualquer página. Requer o plano Core (renomeado Business em 2025) ou superior.

Ler o guia completo

Webflow

O elemento Code Embed suporta até 50 000 caracteres. O código personalizado requer o plano Basic ou superior. Publica para pré-visualizar.

Ler o guia completo

Wix

O Wix coloca o widget Embed numa sandbox, por isso usamos um método dividido — script em Definições → Código Personalizado, tag via Embed a Widget. Guia honesto.

Ler o guia completo

Shopify

Adiciona uma secção Custom Liquid a qualquer tema — sem instalar app. Salta as páginas de checkout a menos que estejas no Shopify Plus.

Ler o guia completo

Sites Estáticos

Astro, Hugo, 11ty, Jekyll — as mesmas duas linhas no teu template de layout. As builds ficam rápidas.

Ler o guia completo

HTML / Personalizado

Uma página HTML simples chega. Abre num editor de texto, cola, guarda, faz upload. Três passos e está online.

Ler o guia completo

React / Vue / Angular

Usa o elemento personalizado diretamente em JSX, templates Vue ou componentes Angular. Sem componente wrapper, sem pacote extra.

Ler o guia completo

Pronto para experimentar?

30 dias de teste gratuito. Sem cartão de crédito. Pronto em minutos.

Sem cartão de crédito. Pronto em 2 minutos.