HUSKY - WooCommerce Product Filter Professional

Filtro WooCommerce redireciona para a loja a partir da categoria: correção

Você filtra em uma página de categoria de produtos e o resultado parece a loja do WooCommerce: o título diz Loja (Shop), a descrição da categoria e o breadcrumb sumiram, o cabeçalho de categoria do tema desaparece e a aba do navegador mostra o título SEO da loja. Parece que o filtro WooCommerce redireciona da página de categoria para a página da loja, mas olhe a barra de endereço: na maioria dos casos ela ainda mostra a URL da categoria. A página não mudou; o WordPress é que deixou de tratá-la como uma categoria. A seguir: por que o HUSKY faz isso por padrão, as duas configurações que mantêm a página de categoria intacta e o que fazer com breadcrumbs, descrições, templates do tema e redirecionamentos reais.

Por que uma página de categoria filtrada vira a loja

Quando um filtro é aplicado, a URL recebe o parâmetro de busca (swoof=1 por padrão) mais os valores selecionados, por exemplo /product-category/shoes/?swoof=1&pa_color=red&really_curr_tax=15-product_cat. Por padrão, o plugin então converte a consulta principal do WordPress em um arquivo de produtos: define o post type da consulta como produtos, marca-a como um arquivo de post type e desliga seus indicadores de taxonomia. Isso garante que o filtro pesquise produtos onde quer que o formulário esteja. O efeito colateral é que, nessa requisição, a página deixa de ser um arquivo de categoria para quem quer que pergunte:

O que você vêO que decideResultado após filtrar
Título da páginaO WooCommerce imprime o nome do termo apenas em um arquivo de taxonomiaO título da página Loja
Texto acima dos produtosDescrição da categoria nos arquivos de taxonomia, conteúdo da página Loja no arquivo de produtosO conteúdo da página Loja em vez da descrição da categoria
BreadcrumbsO WooCommerce verifica "isto é uma categoria de produtos?" antes de "isto é a loja?"Início / Loja
Título SEO e meta descriptionYoast SEO, Rank Math e outros leem o arquivo atualOs da loja
Blocos do tema, imagens de cabeçalho, templates de arquivo do Elementor ou Divi, condições do Widget LogicCondições como is_product_category() e is_tax()Os elementos exclusivos de categoria desaparecem; o template da loja pode ser usado

Os produtos em si permanecem corretos: a categoria ainda vem da URL, e o parâmetro really_curr_tax diz ao filtro de qual categoria o visitante partiu. Apenas o que cerca os produtos vem do lugar errado. O mesmo acontece nos arquivos de tag, marca e taxonomias personalizadas. No modo AJAX, você pode notar isso somente depois de um recarregamento ou ao abrir um link filtrado compartilhado, porque uma atualização via AJAX substitui os produtos, não o título.

A correção: Desativar a influência do swoof

  1. Vá para WooCommerce → Configurações → Products Filter → Avançado → Opções (WooCommerce → Settings → Products Filter → Advanced → Options).
  2. Defina Desativar a influência do swoof (Disable swoof influence) como Sim (Yes) e salve.
  3. Limpe o cache de página e teste em uma janela privada: filtre em uma categoria e depois recarregue a página.

Com Sim (Yes), o plugin deixa o tipo de página em paz. Uma página de categoria filtrada continua sendo um arquivo de categoria, de modo que o WooCommerce, o tema, o construtor de páginas e o plugin de SEO mostram o título, a descrição, o template e os metadados da própria categoria. A filtragem continua funcionando, porque os valores selecionados são aplicados à própria consulta de produtos, e não por meio do tipo de página. Você não precisa da extensão SEO URL request para isso.

A configuração é global. Depois de ativá-la, teste a filtragem na página da loja, em uma categoria, em um arquivo de tag ou marca, nos resultados da busca de produtos e em qualquer página que use [woof_products]. As páginas criadas com [woof_products] não são afetadas, porque o plugin nunca transforma uma página do WordPress no arquivo de produtos. Se um tema deixa de mostrar produtos ou quebra o layout nos arquivos filtrados com Sim (Yes), esse tema depende do template da loja durante uma busca: volte a opção para Não (No) e use as correções específicas mais adiante.

Se o filtro esquece a categoria: Verificação adicional da página de categoria

Em um arquivo de categoria, o filtro lembra a categoria em que o visitante está. Ele a usa para listar apenas as subcategorias no bloco de categorias, para contar apenas os produtos dessa categoria e para adicionar really_curr_tax aos links do filtro. Quando o plugin não consegue detectá-la, você vê isto após a primeira filtragem: o bloco de categorias volta para as categorias de nível superior de toda a loja, as contagens deixam de corresponder à categoria e uma escolha nesse bloco leva para fora dela. Essa é a outra metade de "ele vai para a página da loja".

Defina Verificação adicional da página de categoria (Additional check of the category page) (Avançado → Opções, logo abaixo de Desativar a influência do swoof (Disable swoof influence)) como Sim (Yes). O plugin então lê a categoria atual do WordPress no momento em que monta o filtro, em vez de depender do valor que salvou antes. Os temas de blocos recebem essa verificação automaticamente; temas clássicos e construtores que montam arquivos à sua própria maneira, o Avada por exemplo, podem precisar dela ativada junto com Desativar a influência do swoof (Disable swoof influence). O que o bloco de categorias mostra em cada tipo de página é explicado em por que o filtro de categorias mostra apenas subcategorias.

Breadcrumbs ainda ocultos: o CSS do próprio plugin

Enquanto um filtro está ativo, o plugin adiciona a classe woof_search_is_going à tag <body>, e sua folha de estilos oculta o breadcrumb do WooCommerce (nav.woocommerce-breadcrumb) e um h1.page-title colocado logo depois dele. Com a configuração padrão, esse breadcrumb diria Início / Loja (Home / Shop) em uma página de categoria, então ocultá-lo era o mal menor. Com Desativar a influência do swoof (Disable swoof influence) = Sim (Yes), o breadcrumb está correto, e você pode exibi-lo novamente:

/*
 * HUSKY: keep the WooCommerce breadcrumb (and a title right after it)
 * visible on filtered pages.
 * Products Filter → Advanced → Code → Custom CSS code, or Appearance → Customize → Additional CSS.
 */
body.woof_search_is_going nav.woocommerce-breadcrumb,
body.woof_search_is_going nav.woocommerce-breadcrumb + h1.page-title {
    display: block;
}

Se o seu tema organiza o breadcrumb com flexbox, use display: flex; em vez de block. Os breadcrumbs impressos pelo Yoast SEO, pelo Rank Math ou pela função própria do tema não são ocultados pelo plugin; eles simplesmente seguem o tipo de página, portanto mostram a categoria assim que a configuração estiver em Sim (Yes).

Se você precisa manter a configuração padrão

Quando o seu tema exige Desativar a influência do swoof (Disable swoof influence) = Não (No), restaure as partes que faltam uma a uma:

  • Descrição da categoria. O FAQ descrição da categoria não aparece em uma página filtrada tem um snippet pronto que lê a categoria de really_curr_tax e imprime sua descrição acima dos produtos.
  • Breadcrumbs. O CSS acima os mostra, mas eles dirão Início / Loja (Home / Shop).
  • Condições em widgets, hooks do tema e código personalizado. is_product_category() retorna false durante a filtragem. Use uma função auxiliar que também leia a categoria do link do filtro:
/**
 * True on a product category archive, also while HUSKY filters it
 * with "Disable swoof influence" = No.
 * Usage: my_is_product_cat() or my_is_product_cat( 'shoes' ), e.g. in Widget Logic.
 * Child theme functions.php or a code snippets plugin.
 */
function my_is_product_cat( $slug = '' ) {
    if ( is_product_category( $slug ) ) {
        return true;
    }
    if ( empty( $_GET['really_curr_tax'] ) ) {
        return false;
    }
    // Format: "15-product_cat" (term ID, dash, taxonomy)
    $parts = explode( '-', sanitize_text_field( wp_unslash( $_GET['really_curr_tax'] ) ), 2 );
    if ( count( $parts ) !== 2 || 'product_cat' !== $parts[1] ) {
        return false;
    }
    $term = get_term( (int) $parts[0], 'product_cat' );
    if ( ! $term instanceof WP_Term ) {
        return false;
    }
    return '' === $slug || $term->slug === $slug;
}

Para verificar apenas se um filtro está ativo, o plugin tem uma função global, is_woof_search_going(). Imagens de cabeçalho e outros elementos do tema que existem apenas em arquivos reais só voltam com Sim (Yes).

Quando a URL realmente muda para a página da loja

Se a barra de endereço mostra a URL da loja depois de filtrar, trata-se de um redirecionamento real, com outra causa. Em uma página que não é um arquivo de produtos, por exemplo uma página do WordPress desenhada como landing page de categoria, o filtro procura uma lista de produtos que possa atualizar. Quando não encontra nenhuma, envia o visitante à loja. Três saídas:

  • Use o arquivo de categoria real (/product-category/...) e desenhe-o com o template de arquivo do seu tema ou construtor, e depois aplique as configurações acima.
  • Mantenha a página e mostre seus produtos com [woof_products] limitado à categoria, como descrito em o filtro de produtos em uma página personalizada.
  • Se uma grade do construtor na página já reage ao filtro, mas usa marcação própria, diga ao script para permanecer na página com woof_not_redirect; o snippet está em a URL do filtro muda, mas os produtos não.

Mais um caso não é um redirecionamento. Escolher uma categoria no filtro da página da loja restringe a loja; não abre o arquivo dessa categoria. A URL continua sendo a da loja, e os elementos exclusivos de arquivo, como uma imagem de cabeçalho da categoria, não aparecem. Se os visitantes devem chegar à própria categoria, ofereça links de categoria em um menu ou em um bloco de navegação e mantenha o filtro para restringir.

Checklist

  • Depois de filtrar, a barra de endereço ainda mostra /product-category/...: é o tipo de página, não um redirecionamento.
  • Desativar a influência do swoof (Disable swoof influence) = Sim (Yes), cache de página limpo, testado em uma janela privada e após um recarregamento.
  • O bloco de categorias ou as contagens voltam para a loja inteira: Verificação adicional da página de categoria (Additional check of the category page) = Sim (Yes).
  • Breadcrumbs: o CSS acima adicionado.
  • A página da loja, os arquivos de tag ou marca, os resultados de busca e as páginas com [woof_products] ainda filtram corretamente.

Se a página de categoria ainda perder o título ou o template depois desses passos, abra um tópico no fórum de suporte do HUSKY com o link da categoria, o link filtrado e o nome do seu tema ou construtor de páginas, e vamos analisar o caso.