HUSKY - WooCommerce Product Filter Professional

Filtro WooCommerce não funciona no Elementor Loop Grid: como corrigir

Você marca um filtro em uma loja criada com Elementor e o Loop Grid continua exibindo todos os produtos, aplica apenas o primeiro de vários valores selecionados ou o template de categoria vira uma lista comum do WooCommerce após a filtragem. Quando o filtro de produtos WooCommerce não funciona no Elementor Loop Grid, a causa depende de duas coisas: qual elemento do Elementor exibe os produtos e se o modo AJAX do HUSKY está ativado. Identifique primeiro o elemento; cada um tem a sua própria correção.

Qual elemento do Elementor exibe os seus produtos

O HUSKY não desenha a grade de produtos. Ele adiciona as suas condições às consultas de produtos do WooCommerce: a consulta principal da loja e dos arquivos de categoria, tag e atributo, as consultas criadas pelo shortcode [products] do WooCommerce e o seu próprio shortcode [woof_products]. Um elemento do Elementor que monta a própria consulta não escuta o filtro.

ElementoSegue o filtroO que fazer
Widget Archive Products, ou widget Products com Consulta atual (Current Query), em um arquivo de produtos do Theme BuilderSim, usa a consulta principal da lojaO modo de redirecionamento mantém o design; veja a seção sobre arquivos para o modo AJAX e os templates de categoria
Widget Products com fonte de consulta própria (últimos produtos, em promoção, em destaque)Normalmente sim: o widget é baseado no shortcode de produtos do WooCommerceNada de especial; a filtragem recarrega a página
Loop Grid com um template de loop de produtosNão, executa a própria consultaFaça a consulta seguir o filtro ou substitua o elemento
Grades de produtos de pacotes de complementos (WooLentor, Premium Addons, Unlimited Elements, JetWooBuilder e similares)Geralmente nãoO mesmo que para o Loop Grid
Widget Shortcode com [woof_products]Sim, também com AJAXFunciona em qualquer lugar; usa o card de produto do WooCommerce do tema

Três verificações rápidas mostram qual é o seu caso:

  1. A URL após a filtragem contém swoof=1 e as suas escolhas. Nesse caso o filtro fez a sua parte; foi o elemento que ignorou a requisição.
  2. Um elemento de controle. Coloque um widget Shortcode com [woof_products per_page=4] ao lado da sua grade, filtre e compare. Se o shortcode filtra e a sua grade não, a grade executa a própria consulta.
  3. A área AJAX. Abra o código-fonte da página (Ctrl+U) e procure por woof_results_by_ajax. Sem ele não há nada para o modo AJAX substituir, e cada mudança no filtro recarrega a página, mesmo com o AJAX ativado.

Loop Grid e widgets de complementos: faça a consulta deles seguir o filtro

Um Loop Grid pede os produtos ao banco de dados por conta própria, por isso continua listando o catálogo inteiro. Você tem três saídas, de “manter o design do loop” a “menos código”.

Manter o Loop Grid: restringir a consulta com pre_get_posts

Um pequeno snippet pergunta ao HUSKY quais produtos correspondem ao filtro atual e restringe a eles todas as outras consultas de produtos da página. Use a versão reforçada da Correção 2 de “a URL do filtro muda, mas os produtos não mudam”; copie-a para o functions.php do tema filho ou para um plugin de snippets de código. Em comparação com o código mais antigo do FAQ de compatibilidade com o Elementor, ele deixa em paz as listas de produtos do wp-admin, mantém filtradas a página 2 e as seguintes da grade e mostra “nada encontrado” em vez do catálogo inteiro quando nenhum produto corresponde. Não execute os dois snippets ao mesmo tempo; substitua o antigo.

Depois ajuste a configuração:

  • A filtragem precisa recarregar a página: o snippet filtra a grade enquanto a URL filtrada é carregada. Um Loop Grid não tem área AJAX, então isso acontece por si só; se a página também tiver uma (verificação 3 acima), defina Tentar transformar a loja em AJAX (Try to ajaxify the shop) como Não (No) (WooCommerce → Configurações → Products Filter → Opções), caso contrário apenas essa área será atualizada.
  • Em uma página comum (não um arquivo do Theme Builder), o filtro envia os resultados para a página da loja, a menos que encontre na página uma lista de produtos do WooCommerce ou [woof_products], e um Loop Grid não é nenhum dos dois. Diga a ele para ficar:
    /**
     * HUSKY: keep filter results on the page with the Loop Grid.
     * Child theme functions.php or a code snippets plugin.
     */
    add_action( 'wp_footer', function () {
        if ( is_page( 123 ) ) { // ID of the page with the Loop Grid
            echo '<script>var woof_not_redirect = 1;</script>';
        }
    } );
  • O snippet afeta todas as consultas de produtos em uma página filtrada, inclusive os carrosséis de “relacionados” ou “mais vendidos”. Para limitá-lo a uma página, remova o comentário da sua linha is_page() e informe o ID dessa página.
  • Adicione o snippet apenas onde um elemento realmente executa a própria consulta. Onde o widget Archive Products exibe os produtos, ele não é necessário; remova-o se você o adicionou ali antes.
  • Verifique o link da página 2 da grade após a filtragem: ele ainda deve conter swoof=1 e os valores selecionados. Um modo “carregar mais” ou de rolagem infinita que busca a página seguinte sem eles mostra produtos não filtrados a partir da página 2; experimente a paginação numerada e verifique os links dela novamente.

Mudar para o widget Products

O widget Products do Elementor Pro normalmente segue o filtro sem nenhum código: nos arquivos com Consulta atual (Current Query), nos demais lugares com a sua própria fonte de consulta. Se o design do card, configurado nos controles do próprio widget, for suficiente para você, ele é a substituição mais simples para um Loop Grid.

Usar o shortcode [woof_products]

Um widget Shortcode com o shortcode [woof_products] do plugin filtra em qualquer página e oferece suporte a AJAX:

[woof_products per_page=12 columns=4 is_ajax=1]

Ele renderiza cada produto com o card do WooCommerce do seu tema (content-product.php), não com um template de loop do Elementor. Em uma página que deve mostrar uma categoria, dê ao filtro e à lista de produtos a mesma condição: [woof taxonomies=product_cat:25] e [woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1], com o ID da sua categoria no lugar de 25.

Vários valores selecionados, mas só o primeiro é aplicado

Com lógica OR entre os valores de um atributo, selecionar vermelho, azul e verde deve mostrar produtos em qualquer uma das três cores. Se um Loop Grid definido como Consulta atual (Current Query) em um template de arquivo mostra só os vermelhos, é porque o Loop Grid monta a consulta a partir da requisição à sua maneira e mantém apenas o primeiro valor. O filtro em si está correto: a mesma requisição mostra os produtos certos no widget Products ou em [woof_products].

Substitua o Loop Grid pelo widget Products definido como Consulta atual (Current Query) ou por [woof_products]. Verifique também se o atributo realmente usa OR: abra as opções adicionais do atributo na aba Estrutura (Structure) e veja Lógica de filtragem (Logic of filtering). O AND só funciona para tipos de filtro que permitem vários valores, como as caixas de seleção.

Arquivos do Theme Builder: design perdido e template errado

Os resultados do AJAX parecem uma lista comum do WooCommerce

Se a área AJAX existe dentro de um widget Archive Products, os produtos são substituídos no mesmo lugar após cada mudança no filtro, mas o novo HTML é renderizado no servidor por [woof_products] a partir das partes padrão do WooCommerce, fora da renderização da página do Elementor. As classes e as configurações do widget do Elementor não estão nele: os produtos perdem a grade, o espaçamento e os textos dos botões do widget. Como o modo AJAX reconstrói a grade é explicado em O filtro AJAX quebra o layout da grade de produtos.

A correção mais confiável é definir Tentar transformar a loja em AJAX (Try to ajaxify the shop) como Não (No): a URL filtrada é renderizada pelo Elementor e fica exatamente como o template. Se quiser manter o AJAX, ajuste a resposta com o filtro woof_draw_products_html para que o CSS da grade do Elementor volte a ser aplicado:

/**
 * HUSKY AJAX results inside an Elementor Archive Products widget:
 * add the class Elementor's grid styles expect.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'woof_draw_products_html', function ( $html, $shortcode_str ) {
    return str_replace(
        '<ul class="products columns-',
        '<ul class="products elementor-grid columns-',
        $html
    );
}, 10, 2 );

Antes de usá-lo, inspecione a lista de produtos em um carregamento novo da página e confirme os nomes das classes em ul.products; use os da sua página se forem diferentes. As diferenças restantes, como um botão que foi envolvido em um elemento extra ou um rótulo alterado, são mais fáceis de corrigir com algumas linhas de CSS do que em PHP. Se o número de colunas mudar após a filtragem, defina-o com loop_shop_columns, como mostrado no artigo sobre o layout.

Uma página de categoria filtrada usa o template da loja

Enquanto um filtro está ativo, o HUSKY por padrão marca a requisição como o arquivo do tipo de conteúdo de produto e desativa o sinalizador de “arquivo de taxonomia” do WordPress. As condições de exibição do Elementor passam então a ver a loja em vez de uma categoria: um template atribuído a “Categorias de produtos” é substituído pelo geral, e os títulos de arquivo mostram o nome da loja em vez da categoria. Defina Desativar a influência do swoof (Disable swoof influence) como Sim (Yes) em Avançado → Opções e teste novamente. Os detalhes e os efeitos colaterais estão em manter a página de categoria ao filtrar.

Contagens que mostram números da loja inteira em um template de categoria costumam vir do próprio shortcode do filtro: um [woof] com dynamic_recount=0 não refaz a contagem para a categoria atual. Remova o atributo ou defina-o como 1.

O filtro dentro de um popup ou off-canvas do Elementor não faz nada

O HUSKY anexa os seus scripts ao formulário do filtro uma única vez, quando a página está pronta. Se um popup ou off-canvas insere o seu conteúdo depois, o filtro aparece, mas os cliques não fazem nada, porque o novo formulário nunca foi inicializado. Abra o código-fonte da página e procure por woof_redraw_zone: se o código do filtro não estiver lá antes de o popup abrir, este é o seu caso.

Use o painel deslizante do próprio plugin: coloque [woof_slideout location="left"] em um widget Shortcode ou defina Visibilidade global (Global visibility) como Mostrar (Show) na aba Slideout para adicioná-lo às páginas da loja. O formulário dele faz parte da página desde o início, por isso funciona como qualquer outro filtro. Outras opções são um popup que renderiza o conteúdo junto com a página ou uma seção que você mostra e oculta com um botão.

O editor do Elementor não carrega com o HUSKY ativo

O erro do editor em versões mais antigas (Call to a member function get() on null) está resolvido nas versões atuais: quando a página é aberta no editor do Elementor, [woof_products] ignora os hooks do loop da loja. Atualize primeiro o plugin. Se o editor ainda travar apenas enquanto o HUSKY estiver ativo, remova o widget clássico do WordPress do HUSKY do painel do Elementor; você continua colocando o filtro com o widget Shortcode:

/**
 * Hide HUSKY's WordPress widget from the Elementor panel.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'elementor/widgets/register', function ( $widgets_manager ) {
    $widgets_manager->unregister( 'wp-widget-woof_widget' );
} );

Isto usa o hook de registro das versões atuais do Elementor; o hook mais antigo do FAQ de conflito com o editor do Elementor está obsoleto nelas.

Checklist

  • Você sabe qual elemento exibe os produtos, e um [woof_products] de controle filtra corretamente na mesma página.
  • Loop Grid ou grade de complemento: o snippet reforçado com pre_get_posts no lugar do antigo, a filtragem recarrega a página, o link da página 2 mantém swoof=1.
  • Vários valores de um atributo: widget Products ou [woof_products] em vez de um Loop Grid com Consulta atual (Current Query).
  • Template de categoria do Theme Builder: Desativar a influência do swoof (Disable swoof influence) = Sim (Yes); AJAX desativado ou a resposta ajustada com woof_draw_products_html.
  • Filtro em um popup: substituído por [woof_slideout].
  • Caches limpos e resultado testado em uma janela privada.

Se o shortcode de controle funcionar e o seu elemento do Elementor ainda não, abra um tópico no fórum de suporte do HUSKY com um link para a página e o nome do elemento e do complemento que exibe os produtos.