Product Filter do WooCommerce no JetSmartFilters: corrigir

Tipo WooCommerce

Nome do erro JetSmartFilters não filtra produtos do WooCommerce EN: JetSmartFilters not filtering WooCommerce products

Severidade Grave

Descrição O Product Filter do WooCommerce no JetSmartFilters não filtra produtos quando o provedor escolhido em 'This filter for' ou o Query ID do widget de filtro não apontam para a mesma query que monta a grade da loja. Sem esse pareamento, o filtro envia a busca para um lugar diferente do que exibe os produtos, e a vitrine continua igual.

O que é o Product Filter do WooCommerce no JetSmartFilters?

O Product Filter do WooCommerce no JetSmartFilters e o conjunto de widgets de filtro (Checkboxes, Select, Range) que o usuário aplica numa página de loja para reduzir a lista de produtos por categoria, atributo ou preco. Cada widget de filtro precisa declarar PARA QUEM ele filtra: o campo ‘This filter for’ define o provedor (por exemplo ‘WooCommerce Archive’, ‘JetWooBuilder Products Grid’ ou ‘JetEngine Listing Grid’) e o Query ID liga o filtro a uma grade específica daquela página. Quando esse provedor ou esse Query ID não batem com a query que de fato renderiza os produtos, o filtro ‘roda’ mas não mexe na vitrine: a selecao e enviada, porém para uma consulta que ninguem esta exibindo.

Como identificar

O usuário marca uma categoria ou atributo no filtro, a página recarrega ou faz AJAX, mas a grade de produtos continua exatamente a mesma.
O contador de produtos não muda e nenhum item some, mesmo aplicando filtros que deveriam reduzir muito a lista.
O filtro funciona numa Listing Grid de teste mas não na página real da loja (shop), ou vice-versa.
No console do navegador aparece a resposta AJAX de ‘jet-smart-filters’ com itens, mas o HTML visivel da loja não e trocado.
Filtros de atributo (cor, tamanho) aparecem vazios ou sem opções para escolher.

Como prevenir

Defina o mesmo provedor ‘This filter for’ em todos os widgets de filtro de uma página antes de publicar, sempre igual ao widget que renderiza os produtos
Use Query ID identico no filtro e na grade apenas quando houver mais de uma grade na mesma página; fora disso, deixe ambos em branco
Crie atributos de produto como taxonomia global em Produtos -> Atributos para que os filtros por cor, tamanho e marca tenham termos disponiveis
Após editar qualquer filtro, teste a loja como visitante anonimo e confira se a grade realmente muda ao aplicar a selecao

Causa

Provedor errado no campo 'This filter for': o filtro aponta para 'JetEngine Listing Grid' enquanto a loja usa a archive padrão do WooCommerce, entao o filtro atualiza uma grade que não existe naquela página.
Query ID divergente entre o widget de filtro e a grade de produtos: o filtro tem Query ID preenchido e a Products Grid esta vazia (ou com outro valor), quebrando o pareamento que diz qual grade recarregar.
Toggle do content widget desligado em Crocoblock -> JetPlugins Settings -> JetSmartFilters -> General Settings, deixando o provedor (ex.: WooCommerce Archive ou JetWooBuilder) indisponivel para o filtro.
Indexer desativado em JetSmartFilters -> Settings -> Indexer Settings: sem indexação os filtros de taxonomia e atributo não calculam contagem nem aplicam o recorte nos produtos.
Apply type 'Page reload' sem o toggle 'Show apply button' ligado, ou 'Apply on' apontado para outra acao: a selecao fica registrada mas nunca dispara a nova query da loja.
Atributo de produto criado como atributo custom do produto em vez de taxonomia global em Produtos -> Atributos, entao o filtro por atributo não tem termos para filtrar.

Como resolver

Confirme qual widget monta a loja: abra a página da loja no editor e identifique se os produtos vem da archive padrão do WooCommerce (tema classico), de uma Products Grid do JetWooBuilder ou de uma Listing Grid do JetEngine. O provedor do filtro precisa ser exatamente esse.
Acerte o provedor em 'This filter for': em cada widget de filtro, abra Content e ajuste o dropdown 'This filter for' para o provedor que você identificou no passo 1, salvando o widget.
Pareie o Query ID dos dois lados: se você usa Query ID, ele deve ser identico no widget de filtro e na grade de produtos. Se não precisa segmentar várias grades na mesma página, deixe os dois em branco para o JetSmartFilters parear automaticamente.
```
loja-produtos
```
Habilite o content widget do provedor: no painel, abra Crocoblock e ligue o toggle do provedor usado, para que ele apareca como opção valida no filtro.
```
Crocoblock -> JetPlugins Settings -> JetSmartFilters -> General Settings
```
Ligue o Indexer: ative a indexação para que filtros de categoria e atributo calculem contagem e apliquem o recorte nos produtos.
```
JetSmartFilters -> Settings -> Indexer Settings -> Enable Indexer
```
Revise Apply type e Apply on: se o Apply type for 'Page reload', ligue o toggle 'Show apply button'; confirme também o campo 'Apply on' para que a selecao dispare a nova query. Depois teste a loja como visitante em aba anonima.

PHP

// functions.php do tema filho — registra no log o provedor e o Query ID
// que CADA filtro JetSmartFilters carregou na pagina da loja. Util pra
// flagrar provedor errado ou Query ID divergente sem abrir cada widget.
add_action( 'jet-smart-filters/render/filter-template/end', function ( $args ) {
    if ( empty( $args ) || ! is_array( $args ) ) {
        return;
    }
    $provider = isset( $args['content_provider'] ) ? $args['content_provider'] : '(vazio)';
    $query_id = isset( $args['query_id'] ) ? $args['query_id'] : '(vazio)';
    error_log( sprintf(
        'JetSmartFilters: filtro renderizado | provider=%s | query_id=%s',
        $provider,
        $query_id
    ) );
}, 10, 1 );

Perguntas frequentes

Apliquei o filtro e a grade de produtos não muda. Por onde comeco?

Comece pelo campo 'This filter for' do widget de filtro. Ele precisa apontar para o mesmo provedor que renderiza os produtos na página: archive padrão do WooCommerce, Products Grid do JetWooBuilder ou Listing Grid do JetEngine. Provedor errado e a causa mais comum de o filtro rodar sem mexer na vitrine.

O que e o Query ID e quando preciso preencher?

Query ID e um texto curto que liga um filtro a uma grade específica. So e necessário quando ha mais de uma grade na mesma página e você precisa dizer qual delas o filtro deve atualizar. Se houver uma única grade, deixe o Query ID em branco nos dois lados para o pareamento ser automático.

Meus filtros de atributo aparecem vazios, sem opções. Por que?

Geralmente porque o atributo foi criado como atributo personalizado do produto, e não como taxonomia global. Crie o atributo em Produtos -> Atributos do WooCommerce e associe os termos aos produtos; assim o filtro por atributo passa a ter opções para exibir e filtrar.

Preciso ligar o Indexer do JetSmartFilters?

Sim, para filtros de categoria e atributo em loja. O Indexer e quem calcula a contagem de itens e aplica o recorte por taxonomia. Com ele desativado, o filtro pode marcar a opção mas não reduzir a lista. Ative em JetSmartFilters, na aba Settings, em Indexer Settings.

Escolhi 'Page reload' e o filtro não dispara nada. O que falta?

Quando o Apply type e 'Page reload', e preciso ligar o toggle 'Show apply button' para o usuário ter como confirmar a selecao. Sem o botão, a escolha fica registrada mas nunca recarrega a loja. Confira também o campo 'Apply on' do widget.

Funciona numa página de teste mas não na loja real. Por que?

A página de teste e a loja costumam usar provedores diferentes: a loja roda a archive padrão do WooCommerce e o teste usa uma Listing Grid. Como o filtro guarda o provedor configurado, ele atualiza a grade certa apenas na página cujo provedor bate. Ajuste o 'This filter for' para o provedor da loja real.

A resposta AJAX vem com produtos mas a tela não troca. O que isso indica?

Indica pareamento quebrado: o filtro consulta uma query, mas o trecho de HTML que ele tenta substituir não corresponde a grade visivel. Quase sempre e Query ID divergente ou provedor que não bate com a grade renderizada. Alinhe provedor e Query ID dos dois lados.

Grave

Como corrigir email de pedido do WooCommerce não enviado

Quando o WooCommerce não envia o email de pedido, o cliente não recebe a confirmação e a loja não é avisada da venda. A causa quase sempre é a função mail() do PHP sendo bloqueada pela hospedagem ou marcada como spam; configurar um SMTP autenticado resolve a maioria dos casos.

Crítico

Como corrigir pagamento do WooCommerce com erro

O pagamento do WooCommerce com erro acontece quando o cliente tenta pagar mas a transação falha, é recusada ou o pedido não é confirmado mesmo após o pagamento. Quase sempre vem de chaves de API erradas (modo teste x produção), de webhook do gateway não chegando ao site ou de SSL/HTTPS mal configurado no checkout.

Atenção

Como corrigir o cupom de desconto que não funciona no WooCommerce

O cupom que não funciona no WooCommerce acontece quando o cliente digita o código de desconto e ele é recusado, não aplica o valor, ou o campo de cupom nem aparece no carrinho. Quase sempre vem dos cupons desativados nas configurações, de restrições de uso (valor mínimo, produtos, validade) ou de cache servindo um carrinho antigo.

Crítico

Como corrigir erro de pagamento do Tutor LMS com WooCommerce

O erro de pagamento do Tutor LMS com WooCommerce ocorre quando o aluno compra um curso, o pedido entra no WooCommerce, mas a matricula não acontece e ele fica sem acesso. A causa quase sempre e o pedido não atingir o status Concluido, o produto do curso não ser virtual, ou a engine de monetizacao errada nas Configurações.

Grave

Como corrigir o botão Adicionar ao carrinho que não funciona no WooCommerce

O botão add to cart do WooCommerce não funcionar significa que o cliente clica em comprar mas o produto não entra no carrinho: o botão fica girando, recarrega a página sem somar, ou nada acontece. Quase sempre vem de requisições AJAX bloqueadas, conflito de JavaScript de plugin ou tema, ou do produto sem estoque ou sem preço.

Atenção

Como corrigir a variação de produto que não aparece no WooCommerce

A variação de produto que não aparece no WooCommerce acontece quando o produto é variável mas as opções de tamanho, cor ou modelo não surgem para o cliente escolher. Quase sempre vem de um atributo não marcado como 'Usado para variações', de variações sem preço ou estoque, ou de cache servindo uma versão antiga da página.

Setores

Extensões

Integrações

Como corrigir o filtro de produtos do WooCommerce no JetSmartFilters

O que é o Product Filter do WooCommerce no JetSmartFilters?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir email de pedido do WooCommerce não enviado

Como corrigir pagamento do WooCommerce com erro

Como corrigir o cupom de desconto que não funciona no WooCommerce

Como corrigir erro de pagamento do Tutor LMS com WooCommerce

Como corrigir o botão Adicionar ao carrinho que não funciona no WooCommerce

Como corrigir a variação de produto que não aparece no WooCommerce

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