HUSKY - WooCommerce Product Filter Professional

Filtro AJAX do WooCommerce quebra o layout da grade de produtos: o que fazer

A loja parece certa até o primeiro clique no filtro. Aí três colunas viram quatro, as linhas ficam com buracos, os cards de produto perdem as etiquetas ou os botões do tema, ou a barra lateral escorrega para baixo dos produtos. Quando um filtro AJAX do WooCommerce quebra o layout da grade de produtos, os produtos em si estão corretos; o que mudou foi o HTML que os desenha. Abaixo está o que o modo AJAX do HUSKY substitui, por que a marcação específica do tema se perde no caminho e a solução para cada sintoma.

O que o modo AJAX substitui e o que ele não consegue copiar

Com Tentar usar AJAX na loja (Try to ajaxify the shop) definido como Sim (Yes) (WooCommerce → Configurações → Products Filter → Opções), o plugin demarca a área de produtos das páginas da loja e das categorias. No hook woocommerce_before_shop_loop (prioridade 2), ele abre um contêiner <div class="woocommerce woocommerce-page woof_shortcode_output"> com <div id="woof_results_by_ajax"> dentro dele, e em woocommerce_after_shop_loop (prioridade 10) fecha os dois.

Quando o visitante altera o filtro, o script envia uma requisição para /wp-admin/admin-ajax.php com a ação woof_draw_products. O servidor renderiza [woof_products is_ajax=1] e o script troca o contêiner pelo resultado. Esse resultado é montado apenas com partes padrão do WooCommerce:

  • o hook woocommerce_before_shop_loop (avisos, contagem de resultados, lista suspensa de ordenação);
  • woocommerce_product_loop_start(), que imprime <ul class="products columns-N">;
  • a parte de template content-product.php para cada produto;
  • woocommerce_product_loop_end() e o hook woocommerce_after_shop_loop (paginação).

Duas coisas decorrem disso. Primeiro, tudo o que o template de arquivo do seu tema imprime por conta própria entre os dois hooks (wrappers extras, uma classe de grade, o skin de loop de um construtor) não está no novo HTML. Segundo, o novo HTML é produzido em uma requisição admin-ajax, não na página da loja. O código que é executado enquanto a página da loja carrega, na ação wp ou template_redirect, dentro do template de arquivo ou somente quando is_admin() é falso, nunca é executado para ele. Os scripts do tema que estilizaram a grade uma única vez no carregamento da página também não rodam de novo.

Descubra o que mudou: compare a marcação antes e depois

Abra a loja em uma janela anônima, clique com o botão direito no primeiro produto e escolha Inspecionar (Inspect). Anote as classes de ul.products, de seus elementos pais e do primeiro li.product. Aplique um filtro e inspecione o mesmo lugar de novo. A diferença aponta para a correção:

Sintoma após filtrarCausaSeção
Número de colunas diferente, columns-4 em vez de columns-3A configuração de colunas do tema não é aplicada na requisição AJAXColunas e lacunas
Linhas de 3, depois 1, depois 3; buracos na gradeAs classes de linha first/last são contadas para outro número de colunasColunas e lacunas
A barra lateral ou o rodapé se move, desaparece ou se repete; produtos exibidos duas vezesO tema não chama os dois hooks do loop da loja em volta do loopHooks do loop da loja
Classe ausente em ul.products, botões ou etiquetas de volta, visualização em grade/lista perdida, imagens em brancoMarcação do tema, condições de PHP ou scripts do temaRecursos do card do tema

As colunas de produtos mudam após filtrar e surgem lacunas

O [woof_products] obtém seu número de colunas do filtro loop_shop_columns do WooCommerce, que recorre a Produtos por linha (Products per row) em Aparência → Personalizar → WooCommerce → Catálogo de produtos. Temas com opção própria de colunas costumam aplicá-la somente enquanto uma página da loja carrega. Na requisição AJAX, esse código não é executado, então os resultados voltam com o valor do WooCommerce: muitas vezes 4 onde a loja mostra 3.

As lacunas têm a mesma raiz. O WooCommerce dá ao primeiro produto de cada linha a classe first e ao último a classe last, contados a partir desse número de colunas, e a grade clássica com float começa uma nova linha a cada first. Se o CSS do tema comporta 3 produtos por linha e o HTML do AJAX conta 4, cada quarto produto força uma nova linha: 3 produtos, depois 1 sozinho, depois 3 de novo.

Defina o número de colunas uma vez, para todas as requisições, com o número que sua loja mostra no desktop:

/**
 * Same number of columns on shop pages and in HUSKY AJAX results.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'loop_shop_columns', function () {
    return 3; // products per row on desktop
}, 999 );

Não o envolva em is_shop() ou verificações semelhantes, ou ele será ignorado na requisição AJAX. A prioridade 999 faz com que ele prevaleça sobre o filtro do próprio tema. O FAQ curto forçar os resultados filtrados a um número definido de colunas usa o mesmo filtro. Em uma página personalizada, [woof_products columns=3] define o número diretamente. Celulares e tablets são estilizados pelas media queries do CSS do tema nos dois casos.

Se a classe indica columns-3 após filtrar e as larguras ainda estão erradas, o tema dimensiona os produtos por uma classe em seu próprio wrapper, fora da área trocada. Adicione CSS para o contêiner AJAX em Aparência → Personalizar → CSS adicional ou no campo Código CSS personalizado (Custom CSS code) do plugin (Avançado → Código):

/* HUSKY AJAX results: 3 products per row in a float-based grid */
#woof_results_by_ajax ul.products li.product {
    width: 30.75%;
    margin-right: 3.8%;
    clear: none;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n) {
    margin-right: 0;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n+1) {
    clear: both;
}

Se o seu tema organiza ul.products com CSS grid em vez de float, uma regra basta: #woof_results_by_ajax ul.products { grid-template-columns: repeat(3, 1fr); }. Envolva qualquer uma das versões em uma media query de desktop se o tema usar menos colunas em celulares.

Barra lateral abaixo dos produtos, rodapé quebrado, resultados duplicados: os hooks do loop da loja

O modo AJAX exige que o tema chame woocommerce_before_shop_loop imediatamente antes da lista de produtos e woocommerce_after_shop_loop imediatamente depois dela, como faz o template padrão do WooCommerce. Quando isso não acontece:

  • Falta o hook de fechamento. Os dois contêineres nunca são fechados, e o navegador só os fecha no fim do elemento pai. A barra lateral, a segunda coluna ou o rodapé acabam dentro da área de produtos: muitas vezes a barra lateral já fica sob os produtos no carregamento da página e, após o primeiro clique no filtro, tudo o que está dentro do contêiner, inclusive a barra lateral com o filtro, é substituído pelos resultados.
  • Os hooks são chamados em outro lugar. Se o tema os dispara em uma barra de ferramentas e imprime o loop de produtos depois de woocommerce_after_shop_loop, os resultados do AJAX caem no contêiner enquanto a grade original permanece abaixo dele, e os produtos aparecem duas vezes.
  • Wrappers do tema atravessam os contêineres. Um elemento que o tema abre em woocommerce_before_shop_loop e fecha em woocommerce_after_shop_loop deve ficar inteiramente dentro dos contêineres do HUSKY (aberto depois da prioridade 2, fechado antes da prioridade 10) ou inteiramente fora deles. Qualquer coisa intermediária os sobrepõe e quebra o aninhamento.

Para verificar, abra o código-fonte da página (Ctrl+U), procure woof_results_by_ajax e acompanhe o HTML para baixo: depois do </ul> de fechamento dos produtos e da paginação, deve haver dois </div> antes de a barra lateral ou o rodapé começarem. Na pasta do tema, procure woocommerce_after_shop_loop nos templates de arquivo. A parte de produtos de um template que funciona com o modo AJAX se parece com o archive-product.php do próprio WooCommerce:

<?php
if ( woocommerce_product_loop() ) {
    do_action( 'woocommerce_before_shop_loop' );

    woocommerce_product_loop_start();
    if ( wc_get_loop_prop( 'total' ) ) {
        while ( have_posts() ) {
            the_post();
            do_action( 'woocommerce_shop_loop' );
            wc_get_template_part( 'content', 'product' );
        }
    }
    woocommerce_product_loop_end();

    do_action( 'woocommerce_after_shop_loop' );
} else {
    do_action( 'woocommerce_no_products_found' );
}

Faça a alteração em uma cópia do template em um tema filho, ou peça ao autor do tema que adicione o hook que falta. Layouts de construtores de páginas raramente chamam os dois hooks; para eles, o modo de redirecionamento, descrito adiante, é a escolha realista. Produtos que não mudam de jeito nenhum são tratados em a URL do filtro muda, mas os produtos não, e os templates do Elementor em Loop Grid e templates de arquivo do Elementor sem filtrar.

Recursos do card do tema perdidos: etiquetas, botões, classes de grade, scripts

Alterações que seu PHP faz apenas nas páginas da loja

O código que oculta botões de adicionar ao carrinho, adiciona uma linha de categoria ou uma etiqueta e decide isso em wp ou template_redirect com is_shop() não é executado na requisição AJAX, então o card padrão volta após a filtragem. Execute-o também para a requisição do HUSKY. O admin_init é disparado em toda requisição admin-ajax:

/**
 * Card changes for shop pages AND for HUSKY AJAX results.
 * Child theme functions.php or a code snippets plugin.
 */
function my_shop_card_changes() {
    // Example: no add-to-cart buttons in the product grid
    remove_action( 'woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10 );
}

// Normal page loads of the shop and product archives
add_action( 'wp', function () {
    if ( is_shop() || is_product_taxonomy() ) {
        my_shop_card_changes();
    }
} );

// HUSKY AJAX filtering, sent through admin-ajax.php
add_action( 'admin_init', function () {
    if ( wp_doing_ajax() && isset( $_REQUEST['action'] ) && 'woof_draw_products' === $_REQUEST['action'] ) {
        my_shop_card_changes();
    }
} );

As opções do tema que alteram o card (uma linha de categoria, uma imagem de hover, um botão de visualização rápida) costumam ser aplicadas da mesma forma dentro do tema. Se elas desaparecem após filtrar e o tema não tem um hook que cubra também as requisições AJAX, use o modo de redirecionamento.

Classes que o tema adiciona à lista de produtos

Se a comparação mostrar uma classe em ul.products que existe no carregamento da página e falta após filtrar, adicione-a à resposta AJAX com o filtro woof_draw_products_html. Ele recebe o HTML que está prestes a ser enviado ao navegador:

/**
 * Add the theme's grid class to the product list in HUSKY AJAX results.
 * 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 my-theme-grid columns-', // use the class from your page
        $html
    );
}, 10, 2 );

A string de busca corresponde ao loop/loop-start.php do próprio WooCommerce; se o seu tema sobrescreve esse arquivo, copie a tag de abertura do código-fonte da página. Quando o tema renderiza os cards com uma parte de template diferente de content-product.php, retorne o nome dela com o filtro woof_template_part: o valor product-grid carrega content-product-grid.php da pasta woocommerce do seu tema.

Scripts do tema: imagens com lazy load, alturas iguais, masonry, visualização rápida

Scripts que rodam uma só vez no carregamento da página (imagens com lazy load, cards de alturas iguais, masonry, alternadores de grade/lista, botões de visualização rápida) não enxergam os novos produtos. O HUSKY dispara o evento jQuery woof_ajax_done após cada troca; coloque ali a chamada de inicialização do tema, em um arquivo JS do tema ou em Código JavaScript executado após o término do AJAX (JavaScript code after AJAX is done) (Avançado → Código). O autor do tema pode indicar o nome da função; mais sobre o evento em woof_ajax_done.

jQuery(document).on('woof_ajax_done', function () {
    // Many layout scripts recalculate on resize
    jQuery(window).trigger('resize');
    // Call your theme's own init function here if it has one
});

Contagem de resultados ou ordenação exibida duas vezes

Um tema que imprime a própria contagem e a própria barra de ordenação fora da área de produtos ainda pode receber as cópias padrão do WooCommerce dentro dos resultados do AJAX. Oculte as cópias internas, somente se realmente forem duplicadas:

#woof_results_by_ajax .woocommerce-result-count,
#woof_results_by_ajax .woocommerce-ordering {
    display: none;
}

Se a contagem do próprio tema fora da área não é atualizada após filtrar, coloque o seletor CSS dela em Seletor CSS da contagem de resultados (Result count css selector) (Avançado → Opções): o plugin passa então a enviar uma contagem nova a cada resposta AJAX e substitui o elemento que encontrar.

Quando desistir do AJAX: modo de redirecionamento e Modo Turbo

Alguns layouts não podem ser reconstruídos a partir de partes padrão do WooCommerce: skins de loop de construtores, carrosséis, templates de tema sem os hooks. Defina Tentar usar AJAX na loja (Try to ajaxify the shop) como Não (No). Cada alteração no filtro passa então a carregar a URL filtrada e o seu tema renderiza a página inteira como de costume, de modo que a grade fica idêntica à da loja sem filtro. O que se perde é a atualização no próprio lugar. Para recarregar uma vez por pesquisa em vez de a cada clique, defina Envio automático (Autosubmit) como Não (No), para que o filtro aguarde o seu botão, e veja rolagem automática até os produtos no modo de redirecionamento para levar o visitante aos resultados.

Se Tentar usar AJAX na loja (Try to ajaxify the shop) volta para Sim (Yes), o Modo Turbo está ativado: ele liga o modo AJAX a cada carregamento de página. Defina primeiro Ativar o Modo Turbo (Enable turbo mode) como Não (No) em sua aba, depois desligue o AJAX e limpe o cache de páginas para que os visitantes recebam a nova configuração.

Lista de verificação

  • Marcação comparada antes e depois da filtragem no inspetor do navegador.
  • loop_shop_columns retorna o número de colunas da loja sem condições de página.
  • O código-fonte da página mostra os dois contêineres do HUSKY sendo fechados logo após os produtos e a paginação.
  • As alterações de card em PHP também rodam para a requisição woof_draw_products; os scripts do tema são executados de novo em woof_ajax_done.
  • Se o layout ainda diferir: Tentar usar AJAX na loja (Try to ajaxify the shop) = Não (No), com o Modo Turbo desativado e os caches limpos.

Se o layout continuar quebrando com um tema padrão como o Storefront e somente o HUSKY ativo, abra um tópico no fórum de suporte do HUSKY com um link para a página da loja e uma descrição do que muda após a filtragem.