Como corrigir o erro de JavaScript no JetSmartFilters no WordPress
O que é erro de JavaScript no JetSmartFilters?
O erro de JavaScript no JetSmartFilters e a falha do script que aplica os filtros no navegador. O JetSmartFilters depende de um arquivo JavaScript próprio, que escuta a interacao do visitante com o filtro, monta a requisicao e atualiza o provider (o Listing Grid, Products Grid ou widget que mostra os resultados) sem recarregar a página inteira no modo AJAX. Quando esse script lanca uma excecao, o filtro deixa de responder: o clique não faz nada, os resultados não mudam e o console do navegador registra o erro.
O sintoma central e o filtro parar de funcionar com uma mensagem visivel apenas no console (F12 do navegador), e não na tela. O problema raramente esta no servidor: na maioria dos casos e um conflito entre o script do JetSmartFilters e outro plugin ou tema, um provider apontando para um Query ID que não existe, ou um plugin de cache e minificacao entregando uma versão quebrada do arquivo. Por isso o conserto passa por isolar o conflito, conferir a ligacao entre filtro e provider e limpar a entrega dos assets.
Como identificar
- O console do navegador (F12) exibe ‘Uncaught TypeError’ ou ‘is not a function’ apontando para o arquivo jet-filters.js ou jet-smart-filters.js logo ao interagir com o filtro.
- O filtro não aplica nada ao clicar: a lista de resultados não muda e nenhuma requisicao AJAX aparece na aba Network do navegador.
- A mensagem ‘Uncaught ReferenceError: jQuery is not defined’ aparece no console quando outro plugin altera a ordem de carregamento dos scripts.
- O console registra erro de sintaxe (‘Unexpected token’) vindo do arquivo de filtros, sinal de minificacao agressiva ou de um arquivo cacheado e truncado.
- Os filtros funcionam no editor do Elementor mas quebram no frontend, com o console acusando script duplicado ou variavel já declarada.
Como prevenir
- Mantenha JetSmartFilters e JetEngine sempre na mesma geração de versão estavel, validando a atualização em staging antes de subir para producao.
- No plugin de cache, exclua os scripts do JetSmartFilters da minificacao, combinacao e do delay de JavaScript, evitando que a otimização trunque ou atrase o arquivo.
- Padronize um Query ID único e documentado para cada Listing/Products Grid e replique exatamente esse valor no filtro correspondente.
- Evite duplicar o mesmo filtro ou template em popup e página ao mesmo tempo, para não redeclarar o script do JetSmartFilters na mesma tela.
- Após qualquer mudanca de provider ou de fonte de dados, regenere o indexador do JetSmartFilters para manter o contrato de dados consistente.
Causa
- Outro plugin ou o tema carrega uma versão diferente do jQuery, ou enfileira scripts fora de ordem, e o jet-filters.js executa antes de suas dependencias estarem prontas, lançando 'jQuery is not defined' ou 'is not a function'.
- Um plugin de cache com minificacao ou combinacao de JavaScript (como o recurso de combine/minify do WP Rocket ou Autoptimize) corrompe ou trunca o script do JetSmartFilters, gerando 'Unexpected token' no console.
- O widget de filtro aponta para um provider e Query ID que não correspondem ao Listing Grid ou Products Grid da página, entao o script não encontra o alvo no DOM e falha ao montar a requisicao.
- O Optimize DOM e Markup ou o recurso de delay/defer de JavaScript do plugin de performance adia o script do JetSmartFilters depois do evento que ele precisa escutar, deixando o filtro inerte e o handler sem registrar.
- Ha duas instancias do mesmo filtro ou do mesmo script JetSmartFilters na página (template duplicado, popup e página juntos), causando redeclaracao de variavel e excecao no console ao inicializar.
- Uma versão desatualizada do JetSmartFilters ou do JetEngine deixa o indexador e o provider em contrato incompativel, e o JavaScript quebra ao tentar ler uma estrutura de dados que mudou entre versões.
Como resolver
- Leia a mensagem exata no console do navegador: Abra o console antes de tudo para saber qual erro tratar. A mensagem diz o tipo do erro e o arquivo de origem, o que separa conflito de jQuery, script truncado por cache e provider sem alvo. Anote a linha indicada.
Abra a página do filtro e pressione F12 -> aba Console Interaja com o filtro e leia a mensagem (TypeError, ReferenceError ou Unexpected token) Na aba Network, filtre por 'Fetch/XHR' e confira se a requisicao do filtro sai ao clicar - Desligue cache, minificacao e delay de JavaScript: Conflitos de assets são a causa mais comum. Limpe o cache e desative temporariamente combine/minify e delay de JavaScript do plugin de performance, depois recarregue a página com cache vazio para ver se o erro some.
Painel WP -> plugin de cache (ex.: WP Rocket) -> File Optimization -> desligue Combine e Minify JavaScript Desative Delay JavaScript Execution e remova o jet-filters.js de qualquer exclusão mal feita Limpe todo o cache e recarregue a página com Ctrl+Shift+R (hard refresh) - Confira o provider e o Query ID do filtro: O filtro precisa apontar para o mesmo provider e Query ID do Listing/Products Grid da página. Se não casam, o script não acha o alvo no DOM e quebra. Abra o widget do filtro e o do grid e compare os dois campos.
Edite a página -> abra o widget de filtro -> confira o campo 'This filter for' (provider) Confirme que o 'Query ID' do filtro e identico ao 'Query ID' do Listing Grid ou Products Grid Se usar mais de um grid, defina um Query ID único em cada e replique no filtro correspondente - Isole o conflito desativando plugins e trocando o tema: Se o erro persiste sem cache, e conflito de código. Desative os outros plugins um a um e troque para um tema padrão, recarregando a página e o console a cada teste até o erro desaparecer, identificando o culpado.
Painel WP -> Plugins -> desative os demais plugins um a um (mantenha JetSmartFilters e JetEngine) Painel WP -> Aparencia -> Temas -> ative um tema padrão (ex.: Twenty Twenty-Four) Recarregue a página, repita a interacao e observe o console após cada mudanca - Atualize JetSmartFilters e JetEngine e recrie o indexador: Versões diferentes do JetSmartFilters e do JetEngine podem deixar o contrato de dados incompativel. Atualize ambos para a versão estavel mais recente e, se usar a indexação de filtros, regenere o indexador após atualizar.
Painel WP -> Plugins -> atualize JetSmartFilters e JetEngine para a versão estavel mais recente Painel WP -> JetSmartFilters -> Settings -> ative e regenere o Indexer (se estiver em uso) Recarregue a página e confira se o console fica limpo ao aplicar o filtro
<?php
/**
* Exclui os scripts do JetSmartFilters do delay/defer de plugins de cache
* via o filtro do WP Rocket, evitando que o arquivo de filtros seja adiado.
*/
add_filter( 'rocket_delay_js_exclusions', 'full_jsf_keep_filters_scripts' );
function full_jsf_keep_filters_scripts( $excluded ) {
$excluded[] = 'jet-smart-filters';
$excluded[] = 'jet-filters';
return $excluded;
}Perguntas frequentes
Por que o JetSmartFilters para de aplicar mas não aparece erro na tela
O cache e a minificacao podem quebrar o JetSmartFilters
Como o Query ID influencia o erro de JavaScript do filtro
O que significa 'jQuery is not defined' no console com JetSmartFilters
Por que o filtro funciona no editor do Elementor mas quebra no frontend
Preciso regenerar o indexador depois de atualizar o JetSmartFilters
Como saber se o erro e do JetSmartFilters ou de outro plugin
Como corrigir os Predefined Websites que não importam no Astra Pro
O Astra Starter Templates (Predefined Websites) não importa quando o servidor estoura o tempo de execução, não consegue gravar o XML em wp-content ou falha ao instalar um plugin obrigatório do template. A importação para no meio e exibe erros como cURL error 28 ou Could not store XML file.
Como corrigir o Calendar do JetEngine que não exibe eventos dinâmicos no WordPress
O JetEngine Calendar não exibe eventos dinâmicos quando o campo de data escolhido em Group calendar cells by está vazio ou em formato que o widget não interpreta, quando a query do Listing não retorna posts, ou quando o Listing Template aponta para uma fonte diferente da consultada.
Como corrigir o erro de fontes do Google entre Elementor e Perfmatters no WordPress
O erro de fontes Google entre Elementor e Perfmatters acontece quando as opções Disable Google Fonts ou Remove Unused CSS do Perfmatters removem os arquivos de fonte que o Elementor carrega, fazendo a tipografia trocar para a fonte padrão do sistema ou desaparecer no frontend.
Como corrigir a incompatibilidade entre JetThemeCore e Astra
A incompatibilidade entre JetThemeCore e Astra aparece quando o Theme Builder do Crocoblock não consegue substituir o cabeçalho, o rodape ou o body do Astra, e a página sai com o layout nativo do tema em vez do template criado. O Override theme header, body e footer parece não ter efeito e o template publicado e ignorado no front-end.
Como corrigir o Taxonomy Field que não salva termos no ACF PRO
O ACF Taxonomy Field não salva termos quando a opção Save Terms está desligada: por padrão ela vem desativada, então o campo guarda a seleção apenas como metadado e nunca conecta o termo ao post na taxonomia.
Como corrigir o JetTricks que não aplica efeitos no Elementor
O JetTricks não aplica efeitos no Elementor quando o plugin ou o Elementor estão inativos ou desatualizados, quando o efeito é verificado apenas no editor (a maioria roda só no frontend publicado) ou quando cache e otimização de JavaScript bloqueiam os scripts do JetTricks.
Saúde e Bem-Estar
Restaurantes & Alimentação
Hotelaria & Turismo
Imobiliárias & Construção
Negócios Locais & Franquias
E-commerce & Lojas Virtuais
Educação & Cursos
Profissionais Liberais & Serviços
Agências Digitais & Freelancers
MEIs e Autônomos
Agências e Freelancers
Pequenas Empresas
Startups
Franquias
Elementor PRO
Rank Math
SEOPress
Happy Addons
Tutor LMS
WP Optimize
Crocoblock
WP Rocket
Ultimate Addons
Perfmatter
Funnel Kit
AIOS
Astra PRO
ACF
Essential Addons
WP Forms
UpdraftPlus
Ver mais
FULL CRM 
FULL Widget
FULL Woo
FULL Pop-up
FULL Security
FULL NPS
FULL Update
FULL Social Proof
FULL Analytics
FULL Templates
FULL Creator AI
FULL Backup
FULL Safe Login
FULL SMTP
FULL Monitor
FULL Speed
FULL Cache
FULL Whitelabel
