HUSKY - WooCommerce Product Filter Professional

Modalità Turbo di HUSKY non funziona: filtro grigio e prodotti mancanti

Quando la Modalità Turbo di HUSKY non funziona, i sintomi sembrano scollegati: il filtro resta grigio, una categoria non restituisce prodotti, i nuovi prodotti non compaiono mai, i conteggi sono sbagliati oppure la modalità AJAX non si riesce a disattivare. Quasi tutti derivano da un'unica scelta di progetto: in Modalità Turbo il filtraggio avviene nel browser del visitatore, su un file di dati dei prodotti costruito in anticipo. Qui sotto trovi come viene creato e usato quel file e la soluzione per ogni sintomo.

Come funziona la Modalità Turbo e quando conviene usarla

In modalità normale ogni clic sul filtro fa eseguire al server una query WooCommerce e contare i prodotti per ogni termine. La Modalità Turbo sposta questo lavoro nel browser. HUSKY scrive tutti i prodotti pubblicati e le loro varianti in un unico file JSON (per impostazione predefinita in wp-content/uploads/uploads_woof_turbo_mode/) con ID, titolo, SKU, prezzi, stato delle scorte, i termini di ogni tassonomia dei prodotti e i valori dei campi del filtro Meta. Il browser lo scarica in ogni pagina del front-end in cui il plugin è attivo (limita queste pagine con Inizializza il plugin solo nelle pagine del sito seguenti (Init plugin on the next site pages only) nella scheda Avanzate (Advanced)), trova i prodotti corrispondenti e disegna i conteggi; il server si limita a generare l'output dei prodotti trovati a partire dai loro ID.

Quindi i risultati sono aggiornati quanto il file, un prodotto assente dal file non può essere trovato, vengono applicate solo le condizioni che il browser comprende e ogni visitatore scarica l'intero catalogo: con decine di migliaia di prodotti e varianti significa megabyte e un avvio lento sugli smartphone. La Modalità Turbo conviene su un server poco potente con un catalogo di dimensioni moderate che cambia di rado. Se il server riesce a eseguire le query, prova prima la modalità normale con le cache descritte in come velocizzare il filtraggio dei prodotti nei cataloghi di grandi dimensioni.

Attivala nell'ordine giusto

  1. WooCommerce → Impostazioni (Settings) → Products Filter → Estensioni (Extensions): seleziona Modalità Turbo (Turbo mode) e salva.
  2. Avanzate (Advanced) → Modalità Turbo (Turbo mode): imposta Abilita la modalità Turbo (Enable turbo mode) su Sì (Yes) e salva.
  3. Fai clic su Aggiorna ora! (Update now!) sotto Ricostruisci ora i dati dei prodotti! (Reassemble products data now!) e tieni aperta la pagina finché non compare File aggiornato!!! (File updated!!!). Senza il file il filtro non può cercare.
  4. Scegli il Periodo di WordPress Cron (WordPress Cron period) e Dove conservare il file dei dati dei prodotti (Where to keep products data file), poi salva.
  5. Nella scheda Opzioni (Options) imposta Mostra conteggio (Show count), Riconteggio dinamico (Dynamic recount) e Nascondi i termini vuoti (Hide empty terms), che in Modalità Turbo sono copie separate (spiegate più avanti), quindi svuota la cache delle pagine e l'eventuale cache della CDN.

Il filtro è grigio e non diventa mai cliccabile

Il livello grigio è un elemento con la classe woof_turbo_mode_overlay. Copre il filtro fin dal primo istante e lo script della Modalità Turbo lo rimuove dopo che il file è stato caricato e i conteggi sono stati disegnati. Se il livello resta, quello script non ha terminato:

  • Script ritardati, differiti o combinati. Le funzioni di ottimizzazione di WP Rocket, LiteSpeed Cache e plugin simili possono avviare gli script in ritardo, nell'ordine sbagliato o non avviarli affatto. La Modalità Turbo ha bisogno di ext/turbo_mode/js/turbo_mode.js e ext/quick_search/js/alasql/alasql.min.js dalla cartella wp-content/plugins/woocommerce-products-filter/, dopo jQuery. Escludi la cartella del plugin da ritardo, differimento e combinazione, poi svuota tutte le cache; il filtro con WP Rocket e il caching spiega le esclusioni.
  • Un errore JavaScript. Apri la console del browser (F12) e ricarica la pagina. Il primo errore rosso indica lo script che ha bloccato tutti gli altri.
  • Un file grande con una connessione lenta. Nella scheda Network controlla dimensione e tempo di data_0000_xxx.json. Se il download tiene il filtro grigio per diversi secondi, il catalogo è troppo grande per la Modalità Turbo.

Nascondere il livello con il CSS (.woof_turbo_mode_overlay{display:none;}) nasconde solo il sintomo: il filtro diventa cliccabile, ma senza un file caricato non può cercare.

Quando il file non può essere caricato, il filtro viene sostituito dall'avviso Oh no! Sembra che il filtro non riesca ad aprire il file di ricerca. (Oh no! It looks like the filter can't open the search file.) Verifica che:

  • il file esista. Un file conservato nella cartella del plugin (plugins\woocommerce-products-filter\ext\turbo_mode\data) viene eliminato da ogni aggiornamento del plugin, quindi ricostruiscilo dopo gli aggiornamenti, oppure conservalo in wp-uploads\uploads_woof_turbo_mode;
  • nessuna regola del server o plugin di sicurezza blocchi i file .json in uploads: apri direttamente l'indirizzo del file dalla scheda Network;
  • l'indirizzo sia corretto. Il plugin richiede wp-content/uploads/uploads_woof_turbo_mode/, quindi su un sottosito multisite, o con la cartella uploads spostata altrove, la richiesta restituisce 404. In quel caso conserva il file nella cartella del plugin.

Nessun prodotto trovato o prodotti mancanti dopo il filtraggio

La Modalità Turbo restituisce solo i prodotti presenti nel file, confrontati con i dati lì memorizzati. Controlla entrambe le cose dalla console del browser, in una pagina con il filtro, dopo che si è caricato:

woof_turbo_mode_file.length                  // records in the file: products + variations
woof_turbo_mode_file.find(p => p.id == 123)  // what is stored for product 123

Confronta il primo numero con i tuoi prodotti pubblicati più le varianti; con WP-CLI lo ottieni con wp post list --post_type=product,product_variation --post_status=publish --format=count. Se per un prodotto compare undefined, non è nel file. Se invece c'è, guarda i suoi valori taxonomies e stock.

Il file è obsoleto

Nuovi prodotti, categorie, attributi, prezzi e scorte modificati arrivano al filtro solo con la ricostruzione successiva. Segnali tipici: un nuovo prodotto è elencato nella pagina del negozio ma sparisce dopo il primo clic sul filtro, i nuovi termini mostrano un conteggio pari a 0, le ultime pagine della paginazione sono vuote, oppure un elemento del filtro Meta aggiunto dopo l'ultima ricostruzione non trova nulla. Ricostruisci il file dopo le importazioni e dopo aver modificato gli elementi del filtro.

Il limite di 15.000

Aggiorna ora! (Update now!) si ferma dopo 15.000 record, e le varianti contano. Un negozio con 2.000 prodotti variabili da otto varianti ciascuno ne ha già 18.000. Il pulsante elabora prima i prodotti più recenti, quindi i prodotti lasciati fuori sono i più vecchi. Se il contatore accanto al pulsante si è fermato a Prodotti e varianti: 15000 (Products and Variants: 15000), hai raggiunto il limite. Aumentalo con l'hook woof_turbo_mode_products_limit e ricostruisci il file:

/*
 * HUSKY Turbo mode: let "Update now" write up to 40,000 products and variations.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_turbo_mode_products_limit', function ($limit) {
    return 40000;
});

La ricostruzione pianificata non è limitata da questo hook: elabora l'intero catalogo.

I prodotti nelle sottocategorie non vengono trovati

Il file memorizza solo le categorie selezionate in ogni prodotto e il browser le confronta alla lettera; non conosce l'albero delle categorie. WordPress mostra i prodotti delle sottocategorie in una categoria padre, ma la Modalità Turbo no: un prodotto selezionato solo in Scarpe da corsa è elencato nella pagina Scarpe fino al primo clic sul filtro e poi sparisce, il termine Scarpe del filtro non lo trova e il conteggio di Scarpe lo esclude. Seleziona ogni livello della catena (Scarpe e Scarpe da corsa) in questi prodotti, per esempio con la modifica di massa in Prodotti → Tutti i prodotti (Products → All Products), poi ricostruisci il file.

Prodotti nascosti ed esauriti

I prodotti con Visibilità nel catalogo (Catalog visibility) impostata su Solo negozio (Shop only) o Nascosto (Hidden) sono considerati nascosti alla ricerca e la Modalità Turbo non li restituisce mai dopo il filtraggio, qualunque sia il valore di Rispetta la visibilità nel catalogo (Listen catalog visibility). Un prodotto Solo negozio (Shop only) compare quindi nella pagina del negozio e svanisce dopo il primo clic; impostalo su Negozio e risultati di ricerca (Shop and search results) se deve poter essere filtrato. Con l'opzione di WooCommerce Nascondi gli articoli esauriti dal catalogo (Hide out of stock items from the catalog) attiva, i prodotti esauriti vengono lasciati fuori dal file, e un prodotto tornato disponibile resta assente fino alla ricostruzione successiva.

Lingue WPML

Con WPML, HUSKY scrive un file per ogni lingua (data_0000_en.json, data_0000_de.json) e carica il file della lingua corrente. Un prodotto senza traduzione manca nel file di quella lingua, quindi ricostruisci il file dopo aver tradotto.

Come mantenere aggiornato il file di ricerca

Aggiorna ora! (Update now!) costruisce il file in lotti di dieci prodotti o varianti, al massimo un lotto al secondo, con un contatore Prodotti e varianti (Products and Variants). Ogni lotto riscrive l'intero file, quindi 15.000 record richiedono almeno 25 minuti. A differenza della ricostruzione pianificata, il pulsante elimina prima il file attuale e, finché non termina, il sito filtra con dati incompleti: eseguilo in un momento di poco traffico, tieni aperta la pagina e non disattivare la Modalità Turbo a metà.

Periodo di WordPress Cron (WordPress Cron period) imposta la ricostruzione automatica: giornaliero (daily), settimanale (weekly) (il valore predefinito), due volte al mese (twicemonthly), mensile (monthly), min1 oppure senza aggiornamento (without update). Nonostante il nome, non è un evento di WP-Cron. HUSKY mantiene una propria pianificazione (l'opzione woof_turbo_init_wpcrone_): quando una ricostruzione è dovuta, ogni richiesta che carica WordPress con il plugin, al massimo una ogni cinque secondi, aggiunge i dieci record successivi a un file temporaneo, che sostituisce il file in uso dopo l'ultimo lotto. Fino ad allora i visitatori continuano a ricevere i dati precedenti. Ne derivano queste conseguenze:

  • WP Crontrol e strumenti simili non la elencano e DISABLE_WP_CRON non la ferma.
  • La velocità dipende dalle richieste che raggiungono PHP; le pagine servite da una cache delle pagine non contano. 20.000 record richiedono almeno 2.000 richieste a distanza di cinque secondi, circa tre ore di traffico costante, e su un sito con poco traffico giorni.
  • La prima ricostruzione automatica arriva un intero periodo dopo il salvataggio della pianificazione, quindi fai clic su Aggiorna ora! (Update now!) dopo averla abilitata.
  • Il periodo si conta dalla fine della ricostruzione precedente. min1 avvia la successiva un minuto dopo, quindi il sito si ricostruisce di continuo; usalo solo per cataloghi piccoli.
  • Un clic su Aggiorna ora! (Update now!) durante una ricostruzione automatica elimina anche il suo file temporaneo; quando l'esecuzione automatica termina, sostituisce il tuo file completo con la parte costruita dopo. Se i prodotti tornano a mancare ore dopo una ricostruzione manuale, fai clic di nuovo sul pulsante.

Su un sito con poco traffico può fornire le richieste un cron job del server; le FAQ perché gli aggiornamenti cron automatici falliscono mostrano la configurazione e i limiti di PHP. Eseguilo ogni minuto, non una volta al giorno, perché ogni chiamata aggiunge un solo lotto. Se hai limitato il plugin con Inizializza il plugin solo nelle pagine del sito seguenti (Init plugin on the next site pages only), fagli richiedere /wp-admin/admin-ajax.php, dove il plugin viene sempre caricato. Anche così aggiunge solo 600 record all'ora, quindi per i cataloghi che cambiano in blocco fai clic su Aggiorna ora! (Update now!) dopo ogni importazione.

Altri periodi possono essere aggiunti con l'hook woof_turbo_mode_schedules, senza modificare i file del plugin; poi scegli il nuovo periodo e salva:

/*
 * HUSKY Turbo mode: add "every 12 hours" to WordPress Cron period.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_turbo_mode_schedules', function ($schedules) {
    $schedules['every_12_hours'] = array(
        'name'  => 'every 12 hours',
        'value' => 12 * HOUR_IN_SECONDS,
    );
    return $schedules;
});

Il file mantiene lo stesso indirizzo dopo ogni ricostruzione. Se una CDN o il browser memorizzano nella cache i file .json, i visitatori possono continuare a ricevere dati vecchi: escludi la cartella uploads_woof_turbo_mode dalla cache della CDN, oppure svuotala dopo le ricostruzioni.

La Modalità Turbo richiede AJAX e ha impostazioni di conteggio proprie

Finché la Modalità Turbo è abilitata, HUSKY reimposta quattro opzioni a ogni caricamento di pagina: Prova a rendere il negozio AJAX (Try to ajaxify the shop) diventa Sì (Yes), mentre i normali Mostra conteggio (Show count), Riconteggio dinamico (Dynamic recount) e Nascondi i termini vuoti (Hide empty terms) diventano No. La scheda Opzioni (Options) mostra allora le copie proprie della Modalità Turbo di queste tre opzioni con gli stessi nomi, e Riconteggio dinamico (Dynamic recount) offre Sì, per tutti i dispositivi (Yes, for all devices) oppure Sì, solo per PC (Yes, only for PC).

  • AJAX non si può disattivare finché la Modalità Turbo è attiva. Imposta Abilita la modalità Turbo (Enable turbo mode) su No, salva e solo dopo modifica Prova a rendere il negozio AJAX (Try to ajaxify the shop).
  • Se la griglia dei prodotti del tema si rompe dopo il filtraggio AJAX (un prodotto per riga, colonne perse, paginazione rotta), la Modalità Turbo la eredita: vedi impostare il numero di colonne in modalità AJAX e problemi di paginazione in modalità AJAX, oppure tieni disattivata la Modalità Turbo per quel tema.
  • Dopo aver disattivato la Modalità Turbo, imposta di nuovo Mostra conteggio (Show count), Riconteggio dinamico (Dynamic recount) e Nascondi i termini vuoti (Hide empty terms): sono ancora su No, ed è per questo che in quel momento i contatori spariscono.
  • Nascondi i termini vuoti (Hide empty terms) funziona solo con Mostra conteggio (Show count) e Riconteggio dinamico (Dynamic recount) attivi; disattivando Mostra conteggio (Show count) si disattivano anche le altre due.
  • Cache del numero di riconteggio dinamico per ogni elemento nel filtro (Cache dynamic recount number for each item in filter), Cache dei termini (Cache terms) e Ottimizza il filtro prezzo (Optimize price filter) scompaiono da Avanzate (Advanced) → Opzioni (Options) finché la Modalità Turbo è attiva; non si applicano a essa.

Cosa non può fare la Modalità Turbo

  • L'elemento Menu a discesa gerarchico (Hierarchy drop-down) non funziona con essa, come indicato nella pagina dell'estensione Modalità Turbo.
  • I conteggi e Nascondi i termini vuoti (Hide empty terms) funzionano per gli elementi standard (checkbox, radio, menu a discesa, colore, immagine, etichetta, cursore). Gli elementi creati con Smart Designer non hanno conteggi.
  • Disponibile (In stock) considera solo lo stato delle scorte del prodotto stesso; l'impostazione che controlla le varianti non ha effetto, quindi un filtro per taglia può comunque mostrare varianti esaurite.
  • La ricerca testuale confronta le parole digitate solo con i titoli dei prodotti, anche se l'elemento di ricerca testuale è impostato per cercare nelle descrizioni o in altri campi. L'elemento SKU separato funziona.
  • Le condizioni aggiunte in PHP non partecipano alla ricerca, perché è il browser a decidere quali prodotti corrispondono. Il codice personalizzato su woof_products_query o pre_get_posts, le estensioni personalizzate e i plugin che limitano i prodotti per venditore o gruppo di clienti possono al massimo nascondere in seguito alcuni prodotti trovati, e questo manda fuori sincronia conteggi e paginazione.

Se il tuo negozio ha bisogno di una di queste funzioni, oppure prezzi e scorte cambiano ogni ora, disattiva la Modalità Turbo e velocizza la modalità normale con il caching.

Checklist

  • Nessun errore rosso nella console; gli script del plugin esclusi da ritardo, differimento e combinazione.
  • woof_turbo_mode_file.length corrisponde ai prodotti pubblicati più le varianti; il contatore non si è fermato al limite.
  • File ricostruito dopo l'ultima importazione o modifica del filtro; cache delle pagine e CDN svuotate.
  • Prodotti selezionati in tutta la catena delle categorie, con visibilità Negozio e risultati di ricerca (Shop and search results).
  • Impostazioni di conteggio configurate nelle copie della Modalità Turbo, e di nuovo dopo aver disattivato la Modalità Turbo.

Se il filtro continua a comportarsi in modo anomalo, apri un argomento nel forum di supporto di HUSKY con il link della pagina, gli errori della console, il valore di woof_turbo_mode_file.length e il numero di prodotti e varianti del tuo negozio.