HUSKY - WooCommerce Product Filter Professional

A URL do filtro WooCommerce muda, mas os produtos não: como corrigir

Você marca uma cor ou uma categoria, o indicador de carregamento aparece, a barra de endereço muda para algo como /shop/?swoof=1&pa_color=red, e a grade de produtos continua mostrando os mesmos produtos. Quando a URL do filtro WooCommerce muda, mas os produtos não mudam, o filtro fez a sua parte: montou a requisição de busca. O template que imprime os produtos é que nunca a leu. Este guia mostra como confirmar isso em dois minutos e como fazer um tema, um construtor de páginas ou um template personalizado responder ao filtro.

Por que a URL do filtro muda, mas os produtos não

O HUSKY não desenha a grade de produtos da sua loja. Ele adiciona suas condições (taxonomias, preço, campos meta, texto) às consultas de produtos que o WooCommerce já executa, e somente a elas:

  • a consulta principal da página da loja e dos arquivos de categoria, tag e atributo de produtos (a etapa woocommerce_product_query do WooCommerce);
  • o shortcode próprio do plugin, [woof_products];
  • os shortcodes de produtos do WooCommerce, como [products], por meio de woocommerce_shortcode_products_query.

Uma lista de produtos que monta seu próprio WP_Query fica fora desse caminho. Grades de produtos de construtores de páginas, cartões de posts e repetidores, elementos "query loop", layouts de arquivo do tema com consulta própria e loops escritos à mão em um template PHP pedem produtos ao banco de dados à sua maneira, por isso continuam mostrando o catálogo completo, qualquer que seja o filtro. Nada está quebrado no filtro; a lista simplesmente não o escuta.

Dois sintomas relacionados têm a mesma raiz. Em uma página comum, onde o script do filtro não encontra nenhuma lista de produtos do WooCommerce, ele envia o visitante à página da loja para mostrar os resultados. E em uma "página de categoria" que na verdade é uma página do WordPress feita com um construtor, o filtro não conhece a categoria atual, então oferece todos os termos e pesquisa em todo o catálogo.

Confirme a causa em dois minutos

  1. Leia a URL depois de filtrar. Se ela contém swoof=1 e suas escolhas (/swoof/ seguido delas quando as URLs de SEO estão ativas, ou apenas min_price e max_price quando o preço é a única escolha), o filtro funcionou. Se a URL não muda de forma alguma, o filtro nunca enviou a requisição: procure primeiro um erro de JavaScript no console do navegador.
  2. Tente a mesma requisição na página padrão da loja. Copie tudo a partir de ?swoof=1 e acrescente à URL da página da loja do WooCommerce. Produtos filtrados ali e não filtrados na sua página apontam diretamente para a lista de produtos da sua página.
  3. Teste com um shortcode simples. Em uma página de rascunho, coloque [woof] e, abaixo dele, [woof_products per_page=12], ou o [products limit="12"] do WooCommerce. Se eles filtrarem corretamente, use uma das correções abaixo na sua página real.
  4. Verifique que tipo de página é. Olhe a tela de edição: uma Página (Page) do WordPress com uma grade de produtos não é um arquivo de produtos, mesmo que sua URL seja parecida com /category/shoes/.

Correção 1: exibir os produtos com [woof_products]

A correção mais confiável é deixar o plugin imprimir os produtos. Substitua o elemento de produtos do construtor por um widget ou bloco de Shortcode que contenha [woof_products]:

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

O shortcode reage ao filtro em qualquer página, aceita o modo AJAX com is_ajax=1 e renderiza cada produto com o cartão de produto normal do WooCommerce do seu tema (a parte de template content-product.php), de modo que fica igual à loja. Para usar outra parte de template, altere-a com o filtro woof_template_part.

Para uma página que deve listar apenas uma categoria, dê a mesma condição aos dois shortcodes; caso contrário, o filtro oferece termos de todo o catálogo:

[woof taxonomies=product_cat:25]
[woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1]

Substitua 25 pelo ID da categoria (mostrado na URL ao editar a categoria). O shortcode [products] do próprio WooCommerce também é filtrado, mas somente com recarregamento da página. Se você precisa dele no modo AJAX, escreva [products_woof limit="12" columns="4"]: o plugin o envolve para que os resultados possam ser trocados sem recarregar.

Correção 2: fazer uma grade de construtor ou um WP_Query personalizado escutar o filtro

Quando você quer manter o design de cartões do próprio construtor, faça a consulta dele usar o resultado do filtro. O snippet abaixo se conecta a pre_get_posts, pergunta ao HUSKY quais produtos correspondem ao filtro atual e restringe a consulta da grade a eles. É uma versão reforçada do código em Como tornar filtráveis os construtores de páginas e templates personalizados: deixa em paz as listas de produtos do wp-admin, mantém a paginação da grade funcionando, respeita uma seleção fixa de produtos do elemento e mostra "nenhum produto" em vez do catálogo inteiro quando nada corresponde.

/**
 * HUSKY: apply the active filter to product lists that run their own query
 * (page builder grids, post cards, query loops, custom templates).
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'pre_get_posts', function ( $query ) {
    static $busy = false;

    if ( $busy || ! function_exists( 'woof' ) || $query->is_main_query() ) {
        return;
    }
    // Keep the product lists in wp-admin untouched.
    if ( is_admin() && ! wp_doing_ajax() ) {
        return;
    }
    // Product queries only.
    if ( ! in_array( 'product', (array) $query->get( 'post_type' ), true ) ) {
        return;
    }
    // WooCommerce archives and [woof_products] are filtered already.
    if ( 'product_query' === $query->get( 'wc_query' ) ) {
        return;
    }
    // Only while a filter is active: ?swoof=1, an SEO URL,
    // or ?min_price=...&max_price=... when only the price is set.
    $request = woof()->get_request_data();
    if ( ! isset( $request[ woof()->get_swoof_search_slug() ] ) && ! isset( $request['min_price'] ) ) {
        return;
    }
    // Optional: limit to one page.
    // if ( ! is_page( 123 ) ) { return; }

    $was_doing = isset( $_REQUEST['woof_products_doing'] );
    $args      = woof()->woof_products( array( 'get_args_only' => 1 ) );

    // All matching IDs, whatever page of the grid is open.
    $args['fields']         = 'ids';
    $args['posts_per_page'] = -1;
    $args['paged']          = 1;
    $args['no_found_rows']  = true;
    $args['orderby']        = 'ID';
    unset( $args['meta_key'] );

    $busy = true;
    $ids  = ( new WP_Query( $args ) )->posts;
    $busy = false;

    if ( ! $was_doing ) {
        unset( $_REQUEST['woof_products_doing'] );
    }

    // Respect a fixed product selection of the element itself.
    $own = array_filter( array_map( 'intval', (array) $query->get( 'post__in' ) ) );
    if ( $own ) {
        $ids = array_values( array_intersect( $ids, $own ) );
    }

    // No match: show "no products" instead of the whole catalog.
    $query->set( 'post__in', $ids ? $ids : array( 0 ) );
} );

Como funciona: woof()->woof_products( array( 'get_args_only' => 1 ) ) retorna os argumentos de consulta que o [woof_products] usaria para a requisição atual, sem executá-la. O snippet os transforma em uma lista de IDs de produtos correspondentes e entrega essa lista à grade como post__in. A grade mantém seu próprio layout, ordenação e tamanho de página. O mesmo hook cobre um WP_Query que você mesmo escreve em um template, desde que ele consulte o post type product.

Agora toda consulta de produtos em uma página filtrada segue o filtro, inclusive carrosséis como "mais vendidos" ou "produtos relacionados" em um rodapé. Se não é isso que você quer, descomente a linha is_page() e coloque o ID da página com a grade; isso também poupa uma consulta extra ao banco de dados para cada outra lista de produtos da página.

O modo AJAX precisa dos dois hooks do loop da loja

Com Tentar ajaxificar a loja (Try to ajaxify the shop) definido como Sim (Yes) (WooCommerce → Configurações → Products Filter → Opções), o plugin envolve a lista de produtos em um contêiner próprio. Ele abre o contêiner no hook woocommerce_before_shop_loop e o fecha em woocommerce_after_shop_loop. Após cada alteração do filtro, ele pede ao servidor o novo HTML e substitui o conteúdo desse contêiner. O template de arquivo padrão do WooCommerce chama os dois hooks; muitos layouts de construtores e templates personalizados não. O resultado é um destes três sintomas:

  • Nenhum dos hooks é chamado: não há contêiner para substituir, então cada alteração do filtro recarrega a página inteira.
  • Só o primeiro hook é chamado: o contêiner aberto nunca é fechado e engole o resto do layout, por exemplo a segunda coluna ou a barra lateral, que de repente aparece dentro da coluna de produtos.
  • Os cartões mudam de aparência depois da filtragem: os resultados AJAX são renderizados no servidor pelo [woof_products] com o cartão de produto padrão do WooCommerce, não pelo design de cartões do construtor. Campos de quantidade padrão ou botões de adicionar ao carrinho aparecem onde o construtor os havia ocultado.

Se você controla o código do template, chame os dois hooks em volta do loop:

<?php
// Product list part of your theme template.
do_action( 'woocommerce_before_shop_loop' );

woocommerce_product_loop_start();
while ( have_posts() ) {
    the_post();
    wc_get_template_part( 'content', 'product' );
}
woocommerce_product_loop_end();

do_action( 'woocommerce_after_shop_loop' );

Tudo entre os dois hooks é substituído a cada requisição AJAX, portanto a marcação de envoltório que você quer em volta de cada produto pertence ao content-product.php, não ao template de arquivo. As condições personalizadas do seu próprio loop (por exemplo, "produtos dos últimos 60 dias") não fazem parte do resultado AJAX, porque o servidor o renderiza com [woof_products]; adicione essas condições com o hook woof_products_query ou use o modo de redirecionamento.

Se você não pode alterar o template, o que é comum com construtores, defina Tentar ajaxificar a loja (Try to ajaxify the shop) como Não (No). No modo de redirecionamento, cada alteração do filtro carrega a URL filtrada, e o snippet da Correção 2 faz a grade do construtor mostrar os produtos certos. Com o envio automático ativado, cada escolha é aplicada na hora, só que com um carregamento de página em vez de uma troca via AJAX.

O filtro pula para a página da loja ou ignora a categoria

Os resultados abrem na página da loja. Em uma página que não é um arquivo de produtos, o script do filtro procura uma lista de produtos do WooCommerce: um elemento com a classe products dentro de um contêiner .woocommerce, ou a saída do próprio plugin. Se não encontra nenhuma, ele envia a busca à página da loja, e o filtro na sua página parece desaparecer. A Correção 1 resolve; as configurações com shortcodes para landing pages e para a página inicial estão em filtro de produtos em uma página personalizada. Se a grade do seu construtor já reage ao filtro graças à Correção 2, mas usa uma marcação diferente, diga ao script para permanecer na página:

/**
 * HUSKY: keep filter results on this page instead of the shop page.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'wp_footer', function () {
    if ( is_page( 123 ) ) { // ID of the page with the product grid
        echo '<script>var woof_not_redirect = 1;</script>';
    }
} );

O filtro oferece termos de outras categorias. O plugin obtém a categoria atual do WordPress (o objeto consultado de um arquivo de taxonomia de produtos). Uma página do WordPress construída para parecer uma categoria não tem esse objeto, então o filtro trabalha com o catálogo inteiro. Use o arquivo de categoria real e estilize-o com o template de arquivo ou de theme builder do seu construtor, ou passe taxonomies=product_cat:ID para os dois shortcodes, como mostrado na Correção 1. Um tema personalizado criado sem suporte ao WooCommerce pode causar o mesmo efeito em arquivos reais; declarar add_theme_support( 'woocommerce' ) em um callback de after_setup_theme corrige a detecção, embora os templates de produto do tema possam então precisar de ajustes. Se a página é um arquivo real e a categoria ainda não é detectada, defina Verificação adicional da página de categoria (Additional check of the category page) como Sim (Yes) em Avançado → Opções. Os temas de blocos recebem essa verificação automaticamente. Para ocultar termos que não têm produtos na categoria atual, veja como mostrar apenas as opções de filtro da categoria atual.

Conflitos de roteamento: URLs de SEO e links permanentes

Com a extensão SEO URL request ativada, o filtro passa a fazer parte do caminho, por exemplo /shop/swoof/color-red/, em vez de uma query string. Alguns construtores resolvem URLs e templates por conta própria (o Bricks é um caso conhecido) e não reconhecem esse caminho, então a interface do filtro funciona enquanto os produtos nunca mudam, ou a página recorre a um template sem filtro. Para testar, abra Avançado → SEO URL request e defina Ativar/Desativar (Enable/Disable) como Não (No), limpe todos os caches e filtre novamente. Se os links simples ?swoof=1&... funcionam, o roteamento é a causa; mantenha as URLs de SEO desativadas nesse site.

As URLs de SEO também exigem links permanentes amigáveis. Se a configuração em Configurações → Links permanentes estiver como Simples (Plain), escolha qualquer outra estrutura, salve e teste novamente.

Situações comuns com construtores

O que mostra os produtosO que fazer
Grade de produtos do construtor, cartões de posts, repetidor ou elemento query loop (Avada Post Cards, Oxygen Repeater, Bricks query loop, um bloco Query Loop com consulta personalizada)Correção 2, modo de redirecionamento. Ou substitua o elemento por [woof_products].
Layout de theme builder que substitui o template da loja ou da categoria (layouts do Avada, YOOtheme, Flatsome, Beaver Themer, Breakdance)Funciona no modo de redirecionamento quando o layout usa o loop do WooCommerce. Modo AJAX somente se o layout chamar os dois hooks do loop da loja; caso contrário, defina Tentar ajaxificar a loja (Try to ajaxify the shop) como Não (No).
Widgets de produtos e grades de loop do ElementorVeja como tornar filtráveis as grades de produtos do Elementor.
WP_Query escrito à mão em um template PHPA Correção 2 resolve; para o modo AJAX, adicione os dois hooks.
Outro plugin que substitui a consulta ou o template de produtosDesative-o para um teste. Se o filtro passar a funcionar, esse plugin precisa usar a consulta padrão do WooCommerce.

Se ainda não funcionar

  • Teste sem login em uma janela privada. Um cache de página que ignora a query string serve o mesmo HTML sem filtro para todas as URLs do filtro; exclua do cache de página as URLs que contêm swoof.
  • Depois de adicionar o snippet, abra diretamente uma URL de filtro. Se a grade continuar sem filtro, o elemento provavelmente não consulta o post type product, ou carrega seus produtos mais tarde por uma requisição AJAX própria, sem os parâmetros do filtro (alguns botões "carregar mais" fazem isso).
  • Se a primeira página filtra corretamente, mas a página 2 mostra um 404 ou produtos sem filtro, os links de paginação da grade perdem os parâmetros do filtro. Verifique se o link da página 2 ainda contém swoof=1 e as suas escolhas; mais causas estão em paginação do filtro não funciona.

Se o teste com shortcode da primeira seção funciona e o seu template continua sem funcionar, abra um tópico no fórum de suporte do HUSKY com um link para a página, o tema ou construtor e o elemento que mostra os produtos.