HUSKY - WooCommerce Product Filter Professional

Paginazione del filtro WooCommerce non funzionante: cause e soluzioni

La paginazione del filtro WooCommerce che non funziona di solito si manifesta in uno di questi modi: link alle pagine che puntano a /wp-admin/admin-ajax.php?paged=2, una pagina bianca con un solo 0, pagine vuote o un errore 404 alla fine dei risultati filtrati, il filtro dimenticato nella pagina 2, oppure uno scorrimento infinito che si ferma dopo il primo filtraggio. Ogni sintomo ha la sua causa, e la maggior parte deriva da come il tema costruisce la paginazione, non dal filtro. Parti dalla tabella, poi passa alla sezione corrispondente.

Cosa vediCausa probabile
Link a admin-ajax.php?paged=2, pagina bianca con 0Modalità AJAX con markup di paginazione non standard
Due paginazioni o due righe "Visualizzazione di 1–12 su 40" dopo il filtraggioIl tema stampa propri elementi fuori dall'area che HUSKY aggiorna
Più pagine che prodotti, ultime pagine 404 o vuoteNumeri diversi di "prodotti per pagina" in HUSKY, nel tema e nel builder
Griglia vuota dopo aver cambiato un filtro mentre si è nella pagina 3Il vecchio numero di pagina viene riportato nel nuovo link del filtro
Filtro inattivo o senza stile dopo il passaggio alla pagina 2La paginazione AJAX, il "carica altro" o lo scorrimento infinito del tema
Filtro assente nella pagina 2, o la pagina 2 mostra prodotti non filtratiFiltro inserito nel contenuto della pagina, oppure link di paginazione che perdono il filtro
Nessuna paginazione dopo il filtraggioTemplate personalizzato o tema che stampa la paginazione fuori dagli hook del ciclo

Link a admin-ajax.php: modalità AJAX e markup del tema

Con Prova a rendere il negozio AJAX (Try to ajaxify the shop) impostato su Sì (Yes) (oppure [woof_products is_ajax=1] in una pagina), HUSKY non ricarica la pagina. Chiede al server i nuovi prodotti tramite admin-ajax.php e sostituisce il blocco dei prodotti, paginazione compresa. Poiché quella nuova paginazione viene generata all'interno della richiesta AJAX, i suoi link puntano a admin-ajax.php?paged=2. Non sono mai pensati per essere seguiti: HUSKY intercetta i clic su .woocommerce-pagination a.page-numbers, legge il numero di pagina e carica quella pagina tramite AJAX.

Se il tema cambia il markup della paginazione (una classe diversa sul contenitore, link senza la classe page-numbers, una propria funzione di paginazione), il clic non viene intercettato e il browser apre il link grezzo. WordPress risponde a una richiesta a admin-ajax.php senza un'azione con 0, ed è la pagina bianca. Il markup che HUSKY si aspetta è quello di 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/">&rarr;</a></li>
  </ul>
</nav>

Ispeziona la tua paginazione nel browser e confrontala. Un tema che sovrascrive woocommerce/loop/pagination.php o usa una paginazione propria può essere corretto in un child theme (basta persino un refuso come woocmmerce-pagination nella classe del contenitore per romperla), ma la soluzione affidabile non richiede codice: passa alla modalità reindirizzamento. Apri le impostazioni del plugin, scheda Opzioni (Options), imposta Prova a rendere il negozio AJAX (Try to ajaxify the shop) su No e salva; nelle pagine con lo shortcode usa is_ajax=0. Ogni filtraggio ricarica allora la pagina e la paginazione è la normale paginazione del tema. L'AJAX non può essere disattivato solo per la paginazione. Vedi anche problemi di paginazione in modalità AJAX.

Se l'opzione risulta salvata ma torna su Sì (Yes), la modalità Turbo è attiva. La modalità Turbo funziona solo con l'AJAX e riporta l'opzione su attivo a ogni caricamento di pagina; disattiva prima la modalità Turbo.

Paginazione duplicata o conteggio dei risultati che non si aggiorna

Alcuni temi stampano il conteggio dei risultati, l'ordinamento o la paginazione fuori dal blocco che HUSKY sostituisce. Dopo il filtraggio AJAX vedi allora l'elemento obsoleto del tema accanto a quello aggiornato, oppure un conteggio che descrive ancora il negozio non filtrato. Per il conteggio, inserisci il suo selettore, di solito .woocommerce-result-count, in Avanzate → Opzioni → Selettore CSS del conteggio dei risultati (Advanced → Options → Result count css selector); HUSKY lo ridisegna allora dopo ogni filtraggio (Selettore CSS del menu di ordinamento (Order dropdown css selector) fa lo stesso per l'ordinamento). Se restano duplicati, la modalità reindirizzamento li elimina.

Pagine in più e un 404 alla fine dei risultati

WordPress decide se /page/7/ esiste in base alla query principale della pagina: se la query principale ha sei pagine, la pagina 7 è un 404, qualunque cosa mostri una griglia di prodotti in quella pagina. I problemi iniziano quando la griglia visibile e la query principale contano i prodotti per pagina in modo diverso, per esempio un widget del builder che ne mostra 30 per pagina mentre la query principale usa i 12 del tema: la paginazione e i numeri di pagina esistenti non coincidono più, e le pagine risultano vuote o finiscono in un 404 a metà percorso. L'impostazione di HUSKY, Avanzate → Opzioni → Prodotti per pagina (Advanced → Options → Products per page), si applica solo mentre un filtro è attivo (il valore predefinito, -1, significa "non gestire"), quindi una discrepanza con essa compare solo dopo il filtraggio.

  1. Trova tutti i punti in cui viene impostato il numero: le impostazioni del catalogo del tema o di WooCommerce, il widget dei prodotti del builder e Prodotti per pagina (Products per page) di HUSKY.
  2. Imposta lo stesso numero in tutti, oppure imposta quello di HUSKY su -1 perché non interferisca.
  3. Prova senza il filtro: disattiva HUSKY per un momento e apri direttamente una pagina alta, come /shop/page/17/. Se ora è un 404, la discrepanza è tra il tema e il builder, non nel filtro.

Se il numero di pagine resta troppo alto solo durante il filtraggio, probabilmente il tema calcola la paginazione da una query diversa; risolvere la paginazione che mostra troppe pagine contiene uno snippet che forza il totale dalla query filtrata. Avada ha un caso a parte, descritto in Avada: filtro perso nella paginazione.

Pagina vuota dopo aver cambiato un filtro nella pagina 2 o successive

Un visitatore nella pagina 3 cambia un filtro. Il nuovo risultato ha una sola pagina, quindi se il nuovo link chiede ancora la pagina 3, la griglia è vuota o la pagina è un 404. HUSKY lo evita per la paginazione standard: rimuove /page/N/ e il parametro product-page di WooCommerce dal link che costruisce, e in modalità AJAX torna alla pagina 1 a ogni modifica. Altri parametri di pagina nella query string vengono copiati nel nuovo link insieme al resto dell'indirizzo, per esempio ?paged=3 nei siti con permalink semplici o il parametro di paginazione proprio di un page builder. Usa permalink leggibili (Impostazioni → Permalink (Settings → Permalinks), qualsiasi struttura tranne Semplice (Plain)) e la paginazione standard di WooCommerce, e controlla l'indirizzo dopo una modifica del filtro: non deve contenere alcun numero di pagina.

Paginazione AJAX del tema, carica altro e scorrimento infinito

Molti temi hanno un proprio negozio AJAX: paginazione, pulsanti "carica altro", scorrimento infinito, ordinamento AJAX o un selettore griglia/elenco che sostituiscono i prodotti e la barra laterale senza ricaricare la pagina. HUSKY inizializza il proprio modulo quando la pagina si carica (e dopo il proprio aggiornamento AJAX). Quando il tema inserisce nuovo HTML nella barra laterale, i nuovi elementi del filtro non vengono mai inizializzati, quindi il filtro smette di reagire, perde il proprio stile o invia valori errati. Anche la richiesta "carica altro" di un tema costruisce una propria query per "la pagina successiva" e non conosce il filtro, motivo per cui può aggiungere prodotti non filtrati a un elenco filtrato.

  • Disattiva la paginazione AJAX, il negozio AJAX, lo scorrimento infinito e le opzioni "carica altro" del tema e prova con la paginazione standard. Questo risolve la maggior parte dei casi.
  • Per lo scorrimento infinito, HUSKY ha il supporto integrato per il plugin gratuito YITH Infinite Scrolling: dopo ogni filtraggio AJAX reinizializza lo scorrimento e corregge il link alla pagina successiva. Usa i selettori elencati in scorrimento infinito per i prodotti filtrati.
  • Qualsiasi altro script che deve ripartire dopo il filtraggio AJAX può ascoltare l'evento woof_ajax_done, descritto in l'evento woof_ajax_done. Quale chiamata lo riavvii dipende da quello script; chiedilo al suo autore.
/*
 * 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
});

Invece di un file del tema, il corpo di quella funzione può essere inserito in Avanzate → Codice → Codice JavaScript dopo il completamento dell'AJAX (Advanced → Code → JavaScript code after AJAX is done).

Filtro assente o dimenticato nella pagina 2

  • Il filtro scompare nella pagina 2. Era stato inserito nel contenuto della pagina del negozio o nella descrizione di una categoria. WooCommerce stampa entrambi solo nella prima pagina di un archivio. Metti il filtro in un widget della barra laterale, in un'area del tema che compare in ogni pagina oppure in un blocco del builder fuori dalla descrizione.
  • La pagina 2 mostra prodotti non filtrati. In modalità reindirizzamento la paginazione standard di WooCommerce mantiene il filtro nei suoi link (/shop/page/2/?swoof=1&pa_color=red). Passa il mouse su un link di pagina: se mancano swoof=1 e i valori del tuo filtro, il tema costruisce propri link senza la query string; passa alla paginazione standard o correggi la funzione dei link del tema.
  • La pagina 2 reindirizza al negozio o perde la categoria. I plugin e il codice personalizzato che riscrivono gli URL dei prodotti o gli slug degli archivi possono entrare in conflitto con i link del filtro. Prova con essi disattivati; per un caso noto vedi HUSKY e Permalinks Manager Pro.

Nessuna paginazione dopo il filtraggio

In modalità AJAX il blocco aggiornato contiene tutto ciò che WooCommerce stampa sull'hook woocommerce_after_shop_loop, ed è lì che si trova la paginazione di WooCommerce. Un tema che rimuove la paginazione da quell'hook e ne stampa una propria altrove la perde dopo il primo filtraggio AJAX; la modalità reindirizzamento evita il problema. Se hai creato un tuo template di archivio, stampa tu stesso la paginazione dopo il ciclo dei prodotti:

<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>

Un template personalizzato richiede inoltre gli hook standard del ciclo del negozio perché la modalità AJAX funzioni; l'URL del filtro cambia ma i prodotti no spiega quali.

Per riportare i visitatori all'inizio dei prodotti dopo un cambio di pagina, vedi scorrimento automatico dopo il filtraggio AJAX oppure, in modalità reindirizzamento, scorrimento automatico ai prodotti in modalità reindirizzamento.

Checklist quando la paginazione del filtro WooCommerce non funziona

  • Testato in modalità reindirizzamento (Prova a rendere il negozio AJAX (Try to ajaxify the shop) = No, modalità Turbo disattivata, is_ajax=0 negli shortcode) dopo aver svuotato tutte le cache.
  • Il markup della paginazione è nav.woocommerce-pagination con link a.page-numbers.
  • Il numero di prodotti per pagina è lo stesso nel tema, nel builder e in HUSKY, oppure quello di HUSKY è -1.
  • La paginazione AJAX, il "carica altro" e lo scorrimento infinito del tema sono disattivati, oppure reinizializzati su woof_ajax_done.
  • I link di paginazione in una pagina filtrata contengono swoof=1 e i valori del filtro, e nessun vecchio numero di pagina sopravvive a una modifica del filtro.
  • Il filtro si trova in una barra laterale o in un'area del template, non nella descrizione del negozio o della categoria.

Se la paginazione continua a non funzionare in modalità reindirizzamento con la paginazione standard del tema, apri una discussione nel forum di supporto di HUSKY con il link alla pagina e l'indirizzo di una pagina che non funziona.