WPForms não envia com WP Rocket cache: como corrigir

Tipo Performance & Velocidade

Nome do erro Formulário WPForms quebrado pelo cache do WP Rocket EN: WPForms submission broken by WP Rocket cache

Severidade Grave

Descrição Quando o WPForms não envia com o WP Rocket cache, o Delay JavaScript Execution segurou o wpforms.min.js até a interacao do usuário, ou o Combine/Minify JS quebrou a ordem de carga. Excluir os assets do WPForms dessas otimizacoes restaura o envio AJAX do formulário.

O que é o WPForms que não envia com o cache do WP Rocket?

Esse erro acontece quando o WPForms para de processar o envio depois que o WP Rocket entra no site. O WPForms envia o formulário por AJAX, em segundo plano, sem recarregar a página (opção Enable AJAX form submission, em Settings, General, Advanced). Esse envio depende do script wpforms.min.js e do jQuery rodarem assim que a página carrega. O WP Rocket, por padrão, adia esse JavaScript com o Delay JavaScript Execution (so executa após a primeira interacao do visitante) e ainda pode combinar e minificar os arquivos. Com o script adiado ou na ordem errada, o botão Enviar não responde, o spinner gira sem parar ou o envio falha em silencio. O conserto e dizer ao WP Rocket para não otimizar os arquivos do WPForms e do reCAPTCHA.

Como identificar

O botão Enviar do formulário fica girando o spinner e nunca conclui o envio.
Clicar em Enviar não faz nada na primeira interacao, mas funciona ao recarregar a página com cache desligado.
O Console do navegador (F12) mostra erro do tipo “wpforms is not defined” ou “jQuery is not defined”.
As entradas param de aparecer em WPForms, Entries depois que o WP Rocket foi ativado ou que o Delay JavaScript foi ligado.
O formulário envia normalmente para administradores logados (que veem a página sem cache), mas falha para visitantes anonimos.

Como prevenir

Ao instalar qualquer plugin de cache, teste todos os formulários como visitante anonimo antes de publicar
Mantenha os assets do WPForms e do reCAPTCHA na lista de exclusão do Delay JavaScript e do Combine JavaScript do WP Rocket
Adicione a página de contato em Never Cache URL(s) quando o formulário usar nonce ou campos dinâmicos
Depois de cada atualização do WP Rocket ou do WPForms, refaca um envio de teste para detectar regressao cedo

Causa

O Delay JavaScript Execution do WP Rocket segura o script wpforms.min.js até a primeira interacao, e o envio AJAX não inicializa a tempo.
A opção Combine JavaScript files junta o wpforms.min.js com outros scripts e quebra a ordem de execução das dependencias.
A minificacao de JavaScript do WP Rocket corrompe o script do reCAPTCHA v3 que o WPForms usa para validar o envio.
A página do formulário foi servida do cache com um nonce de segurança já expirado, e o WPForms recusa o envio AJAX por nonce invalido.
O Remove Unused CSS removeu o estilo do spinner e dos campos condicionais, deixando o formulário travado visualmente após o clique.

Como resolver

Confirme que e o WP Rocket: abra o painel do WP Rocket em Settings, WP Rocket, va na aba File Optimization e desligue temporariamente Delay JavaScript Execution. Teste o formulário como visitante anonimo (aba anonima). Se o envio volta, a causa esta nas otimizacoes de JavaScript.
Exclua os assets do WPForms do Delay JavaScript: religue o Delay JavaScript Execution e, no campo de exclusão Excluded JavaScript Files, adicione os caminhos do WPForms e do reCAPTCHA, um por linha. Salve as opções.
```
/wp-content/plugins/wpforms-lite/assets/js/
/wp-content/plugins/wpforms/assets/js/
wpforms
google.com/recaptcha
gstatic.com/recaptcha
```
Tire o WPForms do Combine e do Minify JavaScript: ainda na aba File Optimization, no campo Excluded JavaScript Files das opções Minify e Combine, adicione o mesmo caminho do plugin para o script não ser juntado nem reescrito.
```
/wp-content/plugins/wpforms-lite/assets/js/(.*).js
/wp-content/plugins/wpforms/assets/js/(.*).js
```
Limpe o cache e gere de novo: depois de salvar, clique em Clear and preload cache no menu do WP Rocket para descartar as páginas antigas que ainda carregam o formulário sem o envio.
```
Settings -> WP Rocket -> Dashboard -> Clear and preload cache
```
Resolva o nonce expirado da página cacheada: se o erro for de nonce e não de script, abra a aba Advanced Rules do WP Rocket e adicione a URL da página do formulário em Never Cache URL(s), para ela ser sempre gerada com um nonce valido.
```
/contato/
/fale-conosco/
```
Confirme o envio real: abra a página do formulário numa aba anonima, envie um teste e verifique a chegada da entrada em WPForms, Entries e do e-mail de notificação. Cheque o Console (F12) para garantir que não restou erro de wpforms is not defined.

PHP

// functions.php do tema filho — marca o script do WPForms para o WP Rocket NUNCA atrasar
// (alternativa via codigo ao campo de exclusao; o atributo nowprocket desliga o Delay JS naquele handle)
add_filter( 'script_loader_tag', function ( $tag, $handle ) {
    $excluir = array( 'wpforms', 'wpforms-modern', 'wpforms-recaptcha' );
    if ( in_array( $handle, $excluir, true ) ) {
        return str_replace( '<script ', '<script nowprocket ', $tag );
    }
    return $tag;
}, 10, 2 );

Perguntas frequentes

Por que o WPForms para de enviar so depois de instalar o WP Rocket?

Porque o WP Rocket adia o JavaScript com o Delay JavaScript Execution. O wpforms.min.js, que dispara o envio AJAX, so executa após a primeira interacao do visitante e isso quebra a inicializacao do formulário. Excluir os assets do WPForms dessa otimização resolve.

Qual otimização do WP Rocket mais quebra formulários?

O Delay JavaScript Execution e a principal, seguido do Combine JavaScript files. O Delay segura o script até a interacao e o Combine muda a ordem de carga das dependencias. Excluir o caminho do WPForms dos dois campos costuma resolver o envio.

Preciso desligar o cache inteiro para o formulário voltar?

Não. Desligar o cache resolve o sintoma mas mata a performance. O caminho certo e excluir apenas os assets do WPForms das otimizacoes de JavaScript e, se houver nonce, adicionar a página do formulário em Never Cache URL(s).

O envio funciona logado mas falha para visitante. Por que?

Porque administradores logados costumam ver a página sem cache, entao o script carrega normal. O visitante anonimo recebe a versão cacheada e otimizada, onde o script foi adiado ou o nonce expirou. Teste sempre numa aba anonima.

Como descubro qual script esta sendo bloqueado?

Abra o Console do navegador com F12 na aba Console e envie o formulário. Mensagens como wpforms is not defined ou jQuery is not defined apontam que a dependencia foi adiada ou removida pela otimização do WP Rocket.

O atributo nowprocket faz a mesma coisa que o campo de exclusão?

Sim. O nowprocket marca um script para o WP Rocket não aplicar o Delay JavaScript Execution, igual a adicionar o caminho no campo de exclusão. A diferenca e que o atributo fica no código do tema, útil para versionar a correção.

Depois de excluir os assets preciso limpar o cache?

Sim. As páginas já cacheadas continuam servindo o formulário com o script adiado até o cache ser regenerado. Use Clear and preload cache no painel do WP Rocket para forcar a recriacao das páginas com a exclusão aplicada.

Grave

Como corrigir a lentidão do Tutor LMS com muitos alunos

A lentidão de performance do Tutor LMS aparece quando a base de alunos cresce e as telas de progresso, gradebook e dashboard varrem tabelas que incham, como wp_comments e wp_usermeta. Sem cache de objeto e com a loja consultando os cursos, cada carregamento dispara dezenas de queries pesadas e o site arrasta.

Grave

Como corrigir TBT alto e JavaScript bloqueante no WordPress

TBT alto no WordPress é quando o Total Blocking Time, a soma do tempo em que a thread principal fica bloqueada por JavaScript entre o primeiro render e a interatividade, passa de 200ms no laboratório. Costuma vir de scripts pesados, plugins que carregam JS no carregamento inicial e código de terceiros como rastreadores.

Atenção

Como corrigir o cache do WP Rocket que quebra listings do JetEngine no WordPress

O cache do WP Rocket que quebra listings do JetEngine acontece quando otimizacoes como Delay JavaScript Execution, Remove Unused CSS e o cache de página servem uma versão estática que não executa o JavaScript ou não carrega o CSS de que o Listing Grid e o JetSmartFilters precisam para renderizar conteúdo dinâmico.

Atenção

Como corrigir scripts externos quebrados ao remover query strings no WP Rocket

As query strings do WP Rocket quebram scripts externos quando a otimização de arquivos (Minify e Combine de JavaScript) reescreve ou agrupa URLs de terceiros, fazendo o navegador deixar de carregar o arquivo original versionado. A correção e excluir esses arquivos da otimização.

Informativo

Como corrigir o erro ao desativar emojis no Perfmatters no WordPress

O erro ao usar o Perfmatters disable emojis ocorre quando outro plugin de cache serve um HTML antigo, um plugin de terceiros reenfileira o emoji do WordPress ou o tema usa caracteres emoji que dependiam do script removido, fazendo o wp-emoji-release.min.js voltar a aparecer ou os emojis renderizarem errado.

Grave

Como corrigir LCP alto no WordPress (Core Web Vitals)

LCP alto no WordPress é quando o Largest Contentful Paint, o tempo até o maior elemento visível (geralmente a imagem ou o título do topo) ser renderizado, passa de 2,5 segundos. Costuma vir de servidor lento (TTFB), imagem hero pesada ou recursos que bloqueiam a renderização.

Setores

Extensões

Integrações

Como corrigir a submissao de formulários quebrada pelo cache do WP Rocket no WPForms

O que é o WPForms que não envia com o cache do WP Rocket?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir a lentidão do Tutor LMS com muitos alunos

Como corrigir TBT alto e JavaScript bloqueante no WordPress

Como corrigir o cache do WP Rocket que quebra listings do JetEngine no WordPress

Como corrigir scripts externos quebrados ao remover query strings no WP Rocket

Como corrigir o erro ao desativar emojis no Perfmatters no WordPress

Como corrigir LCP alto no WordPress (Core Web Vitals)

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos