Filtro de produtos WooCommerce não funciona com WP Rocket e cache
Quando o filtro de produtos WooCommerce não funciona com o WP Rocket ou com outro plugin de otimização, o padrão é quase sempre o mesmo: tudo funciona enquanto você está logado e, para os visitantes, os cliques não fazem nada, o indicador de carregamento gira para sempre ou o controle deslizante de preço aparece como um simples campo de texto. O HUSKY envia o mesmo código para os dois. A diferença é que o cache e a otimização de JavaScript costumam ignorar administradores logados, então você nunca vê a página otimizada que seus visitantes recebem. A seguir: como ler o erro em um minuto, o que exatamente excluir no WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer e Cloudflare, e como impedir que o cache de página quebre a filtragem AJAX com um nonce error.
Por que o filtro funciona para administradores e falha para visitantes
O front-end do filtro não é um único arquivo de script, mas uma cadeia que precisa ser executada em uma ordem fixa:
- jQuery, do qual todos os scripts do filtro dependem.
- Um bloco de configurações inline impresso na página (no código-fonte ele é
<script id="woof_front-js-before">). Ele define as variáveis de que o filtro precisa:woof_current_values,woof_is_ajax,swoof_search_slug,woof_ext_init_functions, o token de segurançawoof_front_noncee outras. - Os arquivos do plugin em
/wp-content/plugins/woocommerce-products-filter/:js/front.js, que lê essas variáveis, os scripts dos elementos do filtro e das extensões, e complementos jQuery como iCheck (estilos de checkbox), ion.rangeSlider (controles deslizantes) e plainOverlay (a camada de carregamento).
A otimização e o cache quebram essa cadeia de três maneiras. A otimização muda a ordem, por exemplo adiando os arquivos, mas não o bloco inline, ou o contrário. Ela move ou reescreve o bloco inline ao combinar ou minificar. E um cache de página armazena HTML que contém dados com data de validade: o token de segurança. A maioria dos plugins de cache e otimização entrega a usuários logados uma página que não está em cache nem otimizada, então a visão do administrador comprova apenas que o filtro em si funciona.
Leia primeiro o console do navegador
Abra a loja em uma janela privada, onde você não está logado. Pressione F12 (Cmd+Option+I no Mac), abra a aba Console, recarregue a página e clique em um filtro. O primeiro erro em vermelho mostra onde procurar.
| Mensagem do console | O que significa |
|---|---|
woof_current_values is not defined, o mesmo para woof_is_ajax, swoof_search_slug, woof_ext_init_functions (Firefox: assignment to undeclared variable, Safari: Can't find variable) | O bloco de configurações inline não foi executado antes do front.js: foi adiado, movido, removido ou corrompido |
jQuery is not defined | O jQuery está atrasado ou adiado, mas um código que depende dele foi executado antes |
iCheck is not a function, plainOverlay is not a function, ionRangeSlider is not a function | O arquivo do complemento não foi carregado, ou uma segunda cópia do jQuery foi carregada depois dele e substituiu o objeto jQuery |
woof_husky_txt is not defined | O bloco de dados da busca por texto foi removido ou separado do seu arquivo |
SyntaxError apontando para o bloco inline | Código inválido no bloco inline, muitas vezes vindo do campo de JavaScript personalizado do próprio plugin (veja abaixo) |
Identifier 'woof_front_nonce' has already been declared | O bloco de configurações foi executado duas vezes: um otimizador ou um tema com transições de página em AJAX executou novamente os scripts inline |
"nonce error" is not valid JSON | A página veio de um cache e seu token de segurança expirou |
Unexpected token '<' ... is not valid JSON | O servidor respondeu à requisição do filtro com HTML: um aviso do PHP, uma página de firewall ou uma página em cache |
Bad escaped character in JSON | Algo reescreveu a resposta AJAX no caminho até o navegador |
Nenhum erro, mas o controle deslizante é um campo simples, os botões + das listas hierárquicas não aparecem e os cliques não fazem nada: os scripts ainda não foram executados. É assim que se comportam os recursos de "atrasar o JavaScript até a interação do usuário". Veja o código-fonte da página e procure por woof_front: se as tags de script têm um tipo como rocketlazyloadscript ou litespeed/javascript, um otimizador as está segurando. Se woof_front não aparece no código-fonte, verifique o campo Inicializar o plugin somente nas páginas seguintes do site (Init plugin on the next site pages only) (Avançado → Código): quando ele lista páginas, o plugin é carregado apenas nelas.
O que excluir da otimização de JavaScript
A regra é a mesma em todas as ferramentas: o jQuery, os blocos inline e os arquivos do plugin devem permanecer juntos e na ordem original. Excluir apenas o front.js é uma meia correção comum que não funciona, pois o bloco de configurações e o jQuery continuam atrasados. Estas três linhas cobrem tudo:
/wp-includes/js/jquery/
woocommerce-products-filter
woof_
A primeira linha corresponde ao jQuery e ao jQuery UI (o controle deslizante de preço no estilo WooCommerce o utiliza). A segunda corresponde a todos os arquivos do plugin e de suas extensões. A terceira corresponde aos blocos inline: seus ids e as variáveis dentro deles começam com woof_. Os campos de exclusão dos plugins de otimização costumam comparar uma palavra-chave tanto com a URL do arquivo quanto com o conteúdo dos scripts inline.
- WP Rocket. Em Otimização de arquivos (File Optimization), adicione as linhas aos arquivos excluídos de Atrasar a execução do JavaScript (Delay JavaScript execution); se o filtro continuar quebrado, adicione-as também às exclusões de Carregar JavaScript adiado (Load JavaScript deferred) ou desative essa opção. Se Otimizar a entrega de CSS (Optimize CSS delivery) estiver configurada para remover o CSS não utilizado, adicione os estilos do plugin e as classes
.woofà sua lista de permissões de CSS: muitas classes do filtro aparecem somente depois que o JavaScript é executado, então uma análise da página estática as trata como não utilizadas. - LiteSpeed Cache. Combinar JS (JS Combine) e Carregar JS adiado (Load JS Deferred) (adiado ou atrasado) são as causas habituais; adicione as linhas às exclusões de JS e às exclusões de carregamento adiado/atrasado. Se a requisição do filtro retorna, mas os produtos não são atualizados e o console mostra
Bad escaped character in JSON, desative Mapeamento de CDN (CDN Mapping): em casos confirmados, ele reescreveu a resposta AJAX. - Autoptimize. Quando o JavaScript é agregado, o jQuery vai para o arquivo combinado no fim da página, enquanto o código inline permanece onde estava e é executado cedo demais. Mantenha
js/jquery/jquery.min.jsewoocommerce-products-filterem Excluir scripts do Autoptimize (Exclude scripts from Autoptimize). - SiteGround Speed Optimizer, WP-Optimize e similares. As opções de combinar, adiar e "atrasar scripts inline" precisam das mesmas exclusões ou devem ficar desativadas.
- Cloudflare Rocket Loader. Ele carrega todos os scripts de forma assíncrona, inclusive os blocos inline, e também impede a inicialização da extensão Construtor do filtro no front-end (Filter front builder). Desative-o nas configurações de velocidade da Cloudflare e depois limpe o cache da Cloudflare.
- A minificação de HTML que "remove caracteres desnecessários" pode danificar scripts inline. Desative a minificação de JavaScript inline.
- Código do tema ou snippet no filtro
script_loader_tag. O WordPress passa o bloco inline por esse filtro junto com a tag do script, então um código que remove atributos ou substitui aspas ali pode corrompê-lo. Remova esse código ou limite-o a outros handles.
Duas configurações dentro do filtro
Código JavaScript após a conclusão do AJAX (JavaScript code after AJAX is done) (WooCommerce → Configurações → Products Filter → Avançado → Código) é inserido no bloco de configurações inline como o corpo de uma função. Um erro de digitação ali, como um colchete não fechado, quebra o bloco inteiro, e todas as variáveis do filtro passam a ser "not defined". Esvazie o campo para testar; para executar código depois da filtragem, o evento woof_ajax_done é um lugar mais seguro.
Otimizar o carregamento dos arquivos JavaScript do HUSKY (Optimize loading of HUSKY JavaScript files) (Avançado → Opções) alterna entre duas formas de carregamento: Não (No) carrega o front.js mais quatro scripts separados para botões de opção, checkboxes e listas suspensas; Sim (Yes) carrega um único arquivo compactado, js/front_comprssd.js, no rodapé. Algumas configurações de otimizadores funcionam com um valor e não com o outro. Teste os dois, limpando todos os caches após cada alteração.
Cache de página e o "nonce error"
No modo AJAX (Tentar ajaxificar a loja (Try to ajaxify the shop) na aba Opções, ou uma página com [woof_products is_ajax=1]) e com o atributo ajax_redraw, o filtro pede ao servidor novos produtos e envia o token woof_front_nonce tirado da página. O servidor o verifica e, se não for válido, responde com o texto simples nonce error. O script espera JSON, não consegue ler essa resposta e o indicador de carregamento permanece na tela.
O token é criado quando o HTML é gerado. Para visitantes não logados, os nonces do WordPress são válidos por no mínimo 12 e no máximo 24 horas. Uma página servida de um cache mais antigo que isso carrega um token morto. É por isso que o problema aparece em páginas em cache um dia depois da criação do cache, e por isso um recarregamento às vezes ajuda: ele acaba caindo em uma cópia nova. Limpar o cache resolve só por algumas horas. Correções duradouras:
- Mantenha o tempo de vida do cache das páginas HTML abaixo de 12 horas. O padrão de 10 horas do WP Rocket é seguro; o cache de HTML de longa duração em uma CDN é o culpado típico.
- Não coloque em cache o HTML da loja e das categorias na CDN. Com a Cloudflare, adicione uma regra de cache que ignora o cache para a loja, para as URLs
/product-category/e para qualquer outra página com o filtro, e mantenha o cache de página do WordPress, que respeita seu próprio tempo de vida. Ignorar apenas as URLs filtradas não basta: o token que o visitante usa vem da página onde a filtragem começa. - Prolongue a vida útil deste token específico. Desde o WordPress 6.1, o filtro nonce_life recebe o nome da ação, de modo que o token do filtro pode viver mais sem afetar nenhum outro nonce do site. O token protege apenas a requisição pública da lista de produtos.
/*
* HUSKY: keep the filter token valid longer than the page cache lifespan.
* A token is valid for at least half of this time (here: 2 days).
* Child theme functions.php or a code snippets plugin.
*/
add_filter('nonce_life', function ($life, $action = -1) {
if ('woof_front_nonce' === $action) {
return 4 * DAY_IN_SECONDS;
}
return $life;
}, 10, 2);
O modo de redirecionamento simples, sem AJAX e sem ajax_redraw, não usa o token: cada alteração do filtro carrega uma nova URL, e o cache de página pode servir URLs filtradas como qualquer outra página. Se você chama o filtro a partir do seu próprio código, por exemplo uma requisição jQuery personalizada para woof_draw_products, os dados da requisição devem incluir nonce_filter: woof_front_nonce, ou o servidor responde nonce error mesmo sem nenhum cache.
Filtros desatualizados e outros efeitos colaterais do cache
- As configurações alteradas do filtro não aparecem. As configurações fazem parte do HTML em cache e do bloco inline. Limpe todas as camadas de cache depois de salvá-las: o plugin de cache, o cache do servidor (Varnish, Nginx, cache da hospedagem), a CDN e, em seguida, atualize o navegador à força (Ctrl+F5, Cmd+Shift+R no Mac).
- Um link filtrado abre sem nada selecionado, ou uma loja limpa abre com seleções antigas. O cache trata URLs com query strings diferentes como uma única página. Cada URL
?swoof=1&...deve ser armazenada separadamente ou não ser armazenada, portanto nunca configure o cache para ignorar query strings nas URLs da loja. - O filtro mobile aparece no desktop, ou o contrário. O modo mobile do filtro e algumas extensões decidem no servidor, a partir do user agent do navegador, o que imprimir. Uma página em cache para um celular não deve ser servida a um desktop: ative arquivos de cache separados para dispositivos móveis.
- A primeira visita a uma nova combinação de filtros é mais lenta: essa URL ainda não tem cópia em cache. Para a velocidade em geral, veja como acelerar a filtragem em catálogos grandes.
Uma ordem segura para testar
- Trabalhe em uma janela privada, sem login, com o console aberto.
- Desative toda a otimização de JavaScript (minificar, combinar, adiar, atrasar, Rocket Loader) e limpe todas as camadas de cache. Se o filtro agora funciona, a otimização é a causa. Se ainda falha, a causa está em outro lugar: leia o primeiro erro do console e teste com um tema padrão em uma cópia de staging.
- Reative as opções uma por vez, limpe o cache e teste após cada uma. Quando uma delas quebrar o filtro, adicione as três linhas de exclusão a essa opção ou deixe-a desativada.
- No modo AJAX, verifique o filtro novamente em uma página que está no cache há um dia. Nenhum nonce error significa que o tempo de vida do cache ou do token está correto.
- Teste também em um celular, além do desktop, e na segunda página de resultados.
Se, depois desses passos, o filtro ainda funcionar apenas para usuários logados, abra um tópico no fórum de suporte do HUSKY com o link da página, o primeiro erro do console e a lista das opções de otimização que você ativou, e vamos analisar o caso.