Paginação do filtro do WooCommerce não funciona: causas e soluções
A paginação do filtro do WooCommerce que não funciona costuma se manifestar de algumas formas: links de página que apontam para /wp-admin/admin-ajax.php?paged=2, uma página em branco com um único 0, páginas vazias ou um erro 404 no fim dos resultados filtrados, o filtro esquecido na página 2 ou uma rolagem infinita que para depois da primeira filtragem. Cada sintoma tem a sua própria causa, e a maioria delas vem de como o tema monta a paginação, e não do filtro. Comece pela tabela e depois vá para a seção correspondente.
| O que você vê | Causa provável |
|---|---|
Links para admin-ajax.php?paged=2, página em branco com 0 | Modo AJAX com marcação de paginação fora do padrão |
| Duas paginações ou duas linhas “Mostrando 1–12 de 40” depois de filtrar | O tema imprime elementos próprios fora da área que o HUSKY atualiza |
| Mais páginas do que produtos, últimas páginas com 404 ou vazias | Números diferentes de “produtos por página” no HUSKY, no tema e no builder |
| Grade vazia depois de mudar um filtro estando na página 3 | O número da página antiga é levado para o novo link do filtro |
| Filtro inoperante ou sem estilo depois de ir para a página 2 | A paginação AJAX do próprio tema, o “carregar mais” ou a rolagem infinita |
| Filtro ausente na página 2, ou a página 2 mostra produtos sem filtro | Filtro colocado no conteúdo da página, ou links de paginação que perdem o filtro |
| Nenhuma paginação depois de filtrar | Template personalizado ou tema que imprime a paginação fora dos hooks do loop |
Links para admin-ajax.php: modo AJAX e marcação do tema
Com Tentar usar AJAX na loja (Try to ajaxify the shop) definido como Sim (Yes) (ou [woof_products is_ajax=1] em uma página), o HUSKY não recarrega a página. Ele pede ao servidor os novos produtos por meio de admin-ajax.php e substitui o bloco de produtos, inclusive a paginação. Como essa nova paginação é gerada dentro da requisição AJAX, os seus links apontam para admin-ajax.php?paged=2. Eles nunca foram feitos para serem seguidos: o HUSKY captura os cliques em .woocommerce-pagination a.page-numbers, lê o número da página e carrega essa página por AJAX.
Se o tema altera a marcação da paginação (uma classe diferente no contêiner, links sem a classe page-numbers, uma função de paginação própria), o clique não é capturado e o navegador abre o link bruto. O WordPress responde a uma requisição a admin-ajax.php sem uma ação com 0, que é a página em branco. A marcação que o HUSKY espera é a do próprio WooCommerce:
<nav class="woocommerce-pagination">
<ul class="page-numbers">
<li><span aria-current="page" class="page-numbers current">1</span></li>
<li><a class="page-numbers" href="https://example.com/shop/page/2/">2</a></li>
<li><a class="next page-numbers" href="https://example.com/shop/page/2/">→</a></li>
</ul>
</nav>
Inspecione a sua paginação no navegador e compare. Um tema que sobrescreve woocommerce/loop/pagination.php ou usa uma paginação própria pode ser corrigido em um tema filho (até um erro de digitação como woocmmerce-pagination na classe do contêiner basta para quebrá-la), mas a correção confiável não precisa de código: mude para o modo de redirecionamento. Abra as configurações do plugin, aba Opções (Options), defina Tentar usar AJAX na loja (Try to ajaxify the shop) como Não (No) e salve; nas páginas com o shortcode, use is_ajax=0. Cada filtragem passa então a recarregar a página, e a paginação é a paginação normal do tema. Não é possível desativar o AJAX apenas para a paginação. Veja também problemas de paginação no modo AJAX.
Se a opção diz que foi salva, mas volta para Sim (Yes), o modo Turbo está ativado. O modo Turbo só funciona com AJAX e reativa a opção a cada carregamento de página; desative primeiro o modo Turbo.
Paginação duplicada ou contagem de resultados que não é atualizada
Alguns temas imprimem a contagem de resultados, a ordenação ou a paginação fora do bloco que o HUSKY substitui. Depois da filtragem por AJAX, você vê então o elemento desatualizado do tema ao lado do novo, ou uma contagem que ainda descreve a loja sem filtro. Para a contagem, informe o seu seletor, normalmente .woocommerce-result-count, em Avançado → Opções → Seletor CSS da contagem de resultados (Advanced → Options → Result count css selector); o HUSKY a redesenha então após cada filtragem (Seletor CSS da lista de ordenação (Order dropdown css selector) faz o mesmo com a ordenação). Se as duplicatas continuarem, o modo de redirecionamento as elimina.
Páginas extras e um 404 no fim dos resultados
O WordPress decide se /page/7/ existe a partir da consulta principal da página: se a consulta principal tem seis páginas, a página 7 é um 404, não importa o que uma grade de produtos nessa página mostre. Os problemas começam quando a grade visível e a consulta principal contam produtos por página de maneiras diferentes, por exemplo um widget de builder que mostra 30 por página enquanto a consulta principal usa os 12 do tema: a paginação e os números de página existentes deixam de concordar, e as páginas ficam vazias ou terminam em um 404 no meio do caminho. A configuração própria do HUSKY, Avançado → Opções → Produtos por página (Advanced → Options → Products per page), só se aplica enquanto um filtro está ativo (o seu valor padrão, -1, significa “não gerenciar”), de modo que uma divergência com ela só aparece depois de filtrar.
- Encontre todos os lugares que definem o número: as configurações de catálogo do tema ou do WooCommerce, o widget de produtos do builder e o Produtos por página (Products per page) do HUSKY.
- Defina o mesmo número em todos eles, ou defina o do HUSKY como
-1para que ele não interfira. - Teste sem o filtro: desative o HUSKY por um momento e abra diretamente uma página alta, como
/shop/page/17/. Se agora é um 404, a divergência está entre o tema e o builder, não no filtro.
Se a contagem de páginas ainda estiver alta demais somente durante a filtragem, o tema provavelmente calcula a paginação a partir de outra consulta; corrigir a paginação que mostra páginas demais traz um trecho que força o total a partir da consulta filtrada. O Avada tem um caso próprio, descrito em Avada: filtro perdido na paginação.
Página vazia depois de mudar um filtro na página 2 ou em uma posterior
Um visitante na página 3 muda um filtro. O novo resultado tem uma única página, então, se o novo link ainda pedir a página 3, a grade fica vazia ou a página é um 404. O HUSKY evita isso na paginação padrão: ele remove /page/N/ e o parâmetro product-page do WooCommerce do link que monta e, no modo AJAX, volta para a página 1 a cada mudança. Outros parâmetros de página na query string são copiados para o novo link junto com o resto do endereço, por exemplo ?paged=3 em sites com links permanentes simples ou o parâmetro de paginação próprio de um page builder. Use links permanentes amigáveis (Configurações → Links permanentes (Settings → Permalinks), qualquer estrutura exceto Simples (Plain)) e a paginação padrão do WooCommerce, e confira o endereço depois de uma mudança de filtro: ele não deve conter nenhum número de página.
Paginação AJAX do tema, “carregar mais” e rolagem infinita
Muitos temas têm a sua própria loja em AJAX: paginação, botões de “carregar mais”, rolagem infinita, ordenação por AJAX ou uma alternância entre grade e lista que substituem os produtos e a barra lateral sem recarregar. O HUSKY inicializa o seu formulário quando a página carrega (e depois da sua própria atualização por AJAX). Quando o tema troca o HTML da barra lateral por um novo, os novos elementos do filtro nunca são inicializados, e o filtro deixa de reagir, perde o estilo ou envia valores errados. A requisição de “carregar mais” de um tema também monta a sua própria consulta para “a próxima página” e não sabe nada do filtro, e é por isso que ela pode acrescentar produtos sem filtro a uma lista filtrada.
- Desative a paginação AJAX, a loja AJAX, a rolagem infinita e as opções de “carregar mais” do tema e teste com a paginação padrão. Isso resolve a maioria dos casos.
- Para a rolagem infinita, o HUSKY tem suporte integrado ao plugin gratuito YITH Infinite Scrolling: após cada filtragem por AJAX, ele reinicializa a rolagem e corrige o link da próxima página. Use os seletores listados em rolagem infinita para produtos filtrados.
- Qualquer outro script que precise reiniciar depois da filtragem por AJAX pode escutar o evento
woof_ajax_done, descrito em o evento woof_ajax_done. Qual chamada o reinicia depende desse script; pergunte ao autor dele.
/*
* Runs after every HUSKY AJAX filtering.
* Put it in a JavaScript file of your child theme.
*/
jQuery(document).on('woof_ajax_done', function () {
// call the init function of your infinite scroll or load-more script here
});
Em vez de um arquivo do tema, o corpo dessa função pode ir em Avançado → Código → Código JavaScript após a conclusão do AJAX (Advanced → Code → JavaScript code after AJAX is done).
Filtro ausente ou esquecido na página 2
- O filtro desaparece na página 2. Ele foi colocado no conteúdo da página da loja ou na descrição de uma categoria. O WooCommerce imprime ambos somente na primeira página de um arquivo. Coloque o filtro em um widget da barra lateral, em uma área do tema que aparece em todas as páginas ou em um bloco do builder fora da descrição.
- A página 2 mostra produtos sem filtro. No modo de redirecionamento, a paginação padrão do WooCommerce mantém o filtro nos seus links (
/shop/page/2/?swoof=1&pa_color=red). Passe o mouse sobre um link de página: seswoof=1e os valores do seu filtro não aparecem, o tema monta os próprios links sem a query string; mude para a paginação padrão ou corrija a função de links do tema. - A página 2 redireciona para a loja ou perde a categoria. Plugins e códigos personalizados que reescrevem URLs de produtos ou slugs de arquivos podem entrar em conflito com os links do filtro. Teste com eles desativados; para um caso conhecido, veja HUSKY e Permalinks Manager Pro.
Nenhuma paginação depois de filtrar
No modo AJAX, o bloco atualizado contém tudo o que o WooCommerce imprime no hook woocommerce_after_shop_loop, e é ali que fica a paginação do WooCommerce. Um tema que remove a paginação desse hook e imprime a sua própria em outro lugar a perde depois da primeira filtragem por AJAX; o modo de redirecionamento evita o problema. Se você criou o seu próprio template de arquivo, imprima você mesmo a paginação depois do loop de produtos:
<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>
Um template personalizado também precisa dos hooks padrão do loop da loja para que o modo AJAX funcione; a URL do filtro muda, mas os produtos não explica quais são.
Para levar os visitantes de volta ao topo dos produtos depois de uma troca de página, veja rolagem automática após a filtragem por AJAX ou, no modo de redirecionamento, rolagem automática até os produtos no modo de redirecionamento.
Lista de verificação quando a paginação do filtro do WooCommerce não funciona
- Testado no modo de redirecionamento (Tentar usar AJAX na loja (Try to ajaxify the shop) = Não (No), modo Turbo desativado,
is_ajax=0nos shortcodes) depois de limpar todos os caches. - A marcação da paginação é
nav.woocommerce-paginationcom linksa.page-numbers. - O número de produtos por página é o mesmo no tema, no builder e no HUSKY, ou o do HUSKY é
-1. - A paginação AJAX do tema, o “carregar mais” e a rolagem infinita estão desativados, ou são reinicializados em
woof_ajax_done. - Os links de paginação de uma página filtrada contêm
swoof=1e os valores do filtro, e nenhum número de página antigo sobrevive a uma mudança de filtro. - O filtro está em uma barra lateral ou em uma área do template, e não na descrição da loja ou da categoria.
Se a paginação ainda falhar no modo de redirecionamento com a paginação padrão do tema, abra um tópico no fórum de suporte do HUSKY com o link da página e o endereço de uma página que falha.