Filtro prodotti WooCommerce non funziona con WP Rocket e la cache
Quando un filtro prodotti WooCommerce non funziona con WP Rocket o con un altro plugin di ottimizzazione, lo schema è quasi sempre lo stesso: tutto funziona finché sei connesso e, per i visitatori, i clic non fanno nulla, il loader gira all'infinito o lo slider del prezzo compare come un semplice campo di testo. HUSKY invia lo stesso codice a entrambi. La differenza è che cache e ottimizzazione JavaScript di solito saltano gli amministratori connessi, quindi non vedi mai la pagina ottimizzata che ricevono i tuoi visitatori. Qui trovi come leggere l'errore in un minuto, che cosa escludere esattamente in WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer e Cloudflare, e come evitare che la cache delle pagine blocchi il filtraggio AJAX con un nonce error.
Perché il filtro funziona per gli amministratori e non per i visitatori
Il front end del filtro non è un singolo file di script, ma una catena che deve essere eseguita in un ordine preciso:
- jQuery, da cui dipende ogni script del filtro.
- Un blocco di impostazioni inline stampato nella pagina (nel sorgente è
<script id="woof_front-js-before">). Definisce le variabili di cui il filtro ha bisogno:woof_current_values,woof_is_ajax,swoof_search_slug,woof_ext_init_functions, il token di sicurezzawoof_front_noncee altre. - I file del plugin in
/wp-content/plugins/woocommerce-products-filter/:js/front.js, che legge quelle variabili, gli script degli elementi del filtro e delle estensioni, e i componenti aggiuntivi jQuery come iCheck (stili per le checkbox), ion.rangeSlider (slider) e plainOverlay (l'overlay di caricamento).
Ottimizzazione e cache spezzano questa catena in tre modi. L'ottimizzazione cambia l'ordine, per esempio ritardando i file ma non il blocco inline, o viceversa. Sposta o riscrive il blocco inline durante l'unione o la minificazione. E una cache delle pagine memorizza HTML che contiene un dato con scadenza: il token di sicurezza. La maggior parte dei plugin di cache e ottimizzazione serve agli utenti connessi una pagina né in cache né ottimizzata, quindi la vista da amministratore dimostra soltanto che il filtro in sé funziona.
Leggi prima la console del browser
Apri il negozio in una finestra privata, dove non sei connesso. Premi F12 (Cmd+Option+I su Mac), apri la scheda Console, ricarica la pagina e fai clic su un filtro. Il primo errore in rosso ti indica dove cercare.
| Messaggio della console | Che cosa significa |
|---|---|
woof_current_values is not defined, lo stesso per woof_is_ajax, swoof_search_slug, woof_ext_init_functions (Firefox: assegnazione a variabile non dichiarata (assignment to undeclared variable), Safari: variabile non trovata (Can't find variable)) | Il blocco di impostazioni inline non è stato eseguito prima di front.js: è stato ritardato, spostato, rimosso o danneggiato |
jQuery is not defined | jQuery è ritardato o posticipato, ma il codice che ne ha bisogno è stato eseguito prima |
iCheck is not a function, plainOverlay is not a function, ionRangeSlider is not a function | Il file del componente aggiuntivo non è stato caricato, oppure una seconda copia di jQuery è stata caricata dopo di esso e ha sostituito l'oggetto jQuery |
woof_husky_txt is not defined | Il blocco di dati della ricerca testuale è stato eliminato o separato dal suo file |
SyntaxError riferito al blocco inline | Codice non valido nel blocco inline, spesso proveniente dal campo JavaScript personalizzato del plugin (vedi sotto) |
Identifier 'woof_front_nonce' has already been declared | Il blocco di impostazioni è stato eseguito due volte: un ottimizzatore o un tema con transizioni di pagina AJAX ha rieseguito gli script inline |
"nonce error" is not valid JSON | La pagina proviene da una cache e il suo token di sicurezza è scaduto |
Unexpected token '<' ... is not valid JSON | Il server ha risposto alla richiesta del filtro con HTML: un avviso PHP, una pagina del firewall o una pagina in cache |
Bad escaped character in JSON | Qualcosa ha riscritto la risposta AJAX durante il tragitto verso il browser |
Nessun errore, ma lo slider è un normale input, mancano i simboli + per aprire gli elenchi gerarchici e i clic non fanno nulla: gli script non sono ancora stati eseguiti. È l'aspetto tipico delle funzioni "ritarda JavaScript fino all'interazione dell'utente". Visualizza il sorgente della pagina e cerca woof_front: se i tag script hanno un tipo come rocketlazyloadscript o litespeed/javascript, un ottimizzatore li sta trattenendo. Se woof_front non compare affatto nel sorgente, controlla il campo Inizializza il plugin solo nelle pagine del sito indicate (Init plugin on the next site pages only) (Avanzate → Codice): se elenca delle pagine, il plugin viene caricato solo lì.
Che cosa escludere dall'ottimizzazione JavaScript
La regola è la stessa in ogni strumento: jQuery, i blocchi inline e i file del plugin devono restare insieme e nel loro ordine originale. Escludere solo front.js è una mezza soluzione molto comune che non funziona, perché il blocco di impostazioni e jQuery restano comunque ritardati. Queste tre righe coprono tutto:
/wp-includes/js/jquery/
woocommerce-products-filter
woof_
La prima riga corrisponde a jQuery e jQuery UI (lo slider del prezzo in stile WooCommerce lo utilizza). La seconda corrisponde a ogni file del plugin e delle sue estensioni. La terza corrisponde ai blocchi inline: i loro id e le variabili al loro interno iniziano con woof_. I campi di esclusione dei plugin di ottimizzazione di solito confrontano una parola chiave sia con l'URL del file sia con il contenuto degli script inline.
- WP Rocket. In Ottimizzazione dei file (File Optimization), aggiungi le righe ai file esclusi di Ritarda l'esecuzione di JavaScript (Delay JavaScript execution); se il filtro continua a non funzionare, aggiungile anche alle esclusioni di Carica JavaScript in modo differito (Load JavaScript deferred), oppure disattiva quell'opzione. Se Ottimizza il caricamento del CSS (Optimize CSS delivery) è impostato per rimuovere il CSS inutilizzato, aggiungi gli stili del plugin e le classi
.woofalla sua safelist CSS: molte classi del filtro compaiono solo dopo l'esecuzione di JavaScript, quindi la scansione della pagina statica le considera inutilizzate. - LiteSpeed Cache. Combina JS (JS Combine) e Carica JS in modo differito (Load JS Deferred) (differito o ritardato) sono le cause più frequenti; aggiungi le righe alle esclusioni JS e alle esclusioni per il caricamento differito/ritardato. Se la richiesta del filtro ha esito positivo ma i prodotti non si aggiornano e la console mostra
Bad escaped character in JSON, disattiva Mappatura CDN (CDN Mapping): nei casi confermati riscriveva la risposta AJAX. - Autoptimize. Quando JavaScript viene aggregato, jQuery passa nel file combinato in fondo alla pagina, mentre il codice inline resta dov'era e viene eseguito troppo presto. Mantieni
js/jquery/jquery.min.jsewoocommerce-products-filterin Escludi script da Autoptimize (Exclude scripts from Autoptimize). - SiteGround Speed Optimizer, WP-Optimize e simili. Le opzioni di unione, differimento e "ritarda gli script inline" richiedono tutte le stesse esclusioni, oppure devono essere disattivate.
- Cloudflare Rocket Loader. Carica tutti gli script in modo asincrono, blocchi inline compresi, e impedisce anche l'avvio dell'estensione Filter front builder. Disattivalo nelle impostazioni di velocità di Cloudflare, poi svuota la cache di Cloudflare.
- La minificazione dell'HTML che "rimuove i caratteri non necessari" può danneggiare gli script inline. Disattiva la minificazione del JavaScript inline.
- Codice del tema o snippet sul filtro
script_loader_tag. WordPress fa passare il blocco inline attraverso questo filtro insieme al tag dello script, quindi il codice che rimuove attributi o sostituisce le virgolette in quel punto può corromperlo. Rimuovi questo codice o limitalo ad altri handle.
Due impostazioni all'interno del filtro
Codice JavaScript dopo il completamento di AJAX (JavaScript code after AJAX is done) (WooCommerce → Impostazioni → Products Filter → Avanzate → Codice) viene inserito nel blocco di impostazioni inline come corpo di una funzione. Un errore di battitura, come una parentesi non chiusa, rompe l'intero blocco e ogni variabile del filtro risulta "not defined". Svuota il campo per fare una prova; per eseguire del codice dopo il filtraggio, l'evento woof_ajax_done è un posto più sicuro.
Ottimizza il caricamento dei file JavaScript di HUSKY (Optimize loading of HUSKY JavaScript files) (Avanzate → Opzioni) alterna due modalità di caricamento: No carica front.js più quattro script separati per radio button, checkbox e menu a discesa; Sì (Yes) carica un unico file compresso, js/front_comprssd.js, nel footer. Alcune configurazioni dell'ottimizzatore funzionano con un valore e non con l'altro. Prova entrambi, svuotando tutte le cache dopo ogni modifica.
Cache delle pagine e "nonce error"
In modalità AJAX (Prova a rendere il negozio AJAX (Try to ajaxify the shop) nella scheda Opzioni, oppure una pagina [woof_products is_ajax=1]) e con l'attributo ajax_redraw, il filtro chiede al server i nuovi prodotti e invia il token woof_front_nonce preso dalla pagina. Il server lo verifica e, se non è valido, risponde con il testo semplice nonce error. Lo script si aspetta JSON, non riesce a leggere quella risposta e il loader resta sullo schermo.
Il token viene creato quando si genera l'HTML. Per i visitatori non connessi i nonce di WordPress sono validi per almeno 12 e al massimo 24 ore. Una pagina servita da una cache più vecchia di così contiene un token scaduto. Ecco perché il problema compare sulle pagine in cache un giorno dopo la creazione della cache, e perché a volte un ricaricamento aiuta: capita di ottenere una copia aggiornata. Svuotare la cache risolve solo per qualche ora. Soluzioni durature:
- Mantieni la durata della cache delle pagine HTML sotto le 12 ore. La durata predefinita di WP Rocket, 10 ore, è sicura; la cache HTML di lunga durata su una CDN è il colpevole tipico.
- Non mettere in cache l'HTML del negozio e delle categorie sulla CDN. Con Cloudflare, aggiungi una regola di cache che esclude la cache per il negozio, per gli URL
/product-category/e per ogni altra pagina con il filtro, e mantieni la cache delle pagine di WordPress, che rispetta la propria durata. Escludere solo gli URL filtrati non basta: il token usato dal visitatore proviene dalla pagina in cui inizia il filtraggio. - Estendi la durata di questo singolo token. Da WordPress 6.1 il filtro nonce_life riceve il nome dell'azione, quindi il token del filtro può vivere più a lungo senza toccare alcun altro nonce del sito. Il token protegge soltanto la richiesta pubblica dell'elenco prodotti.
/*
* HUSKY: keep the filter token valid longer than the page cache lifespan.
* A token is valid for at least half of this time (here: 2 days).
* Child theme functions.php or a code snippets plugin.
*/
add_filter('nonce_life', function ($life, $action = -1) {
if ('woof_front_nonce' === $action) {
return 4 * DAY_IN_SECONDS;
}
return $life;
}, 10, 2);
La semplice modalità redirect, senza AJAX e senza ajax_redraw, non usa affatto il token: ogni modifica del filtro carica un nuovo URL e la cache delle pagine può servire gli URL filtrati come qualsiasi altra pagina. Se richiami il filtro dal tuo codice, per esempio con una richiesta jQuery personalizzata a woof_draw_products, i dati della richiesta devono includere nonce_filter: woof_front_nonce, altrimenti il server risponde nonce error anche senza alcuna cache.
Filtri non aggiornati e altri effetti collaterali della cache
- Le impostazioni modificate del filtro non compaiono. Le impostazioni fanno parte dell'HTML in cache e del blocco inline. Svuota ogni livello di cache dopo averle salvate: il plugin di cache, la cache del server (Varnish, Nginx, cache dell'hosting), la CDN, e poi aggiorna il browser forzando il ricaricamento (Ctrl+F5, Cmd+Shift+R su Mac).
- Un link filtrato si apre senza nulla di selezionato, oppure un negozio pulito si apre con vecchie selezioni. La cache tratta gli URL con query string diverse come un'unica pagina. Ogni URL
?swoof=1&...deve essere messo in cache separatamente o per nulla, quindi non impostare mai la cache in modo che ignori le query string sugli URL del negozio. - Il filtro mobile compare sul desktop, o viceversa. La modalità mobile del filtro e alcune estensioni decidono sul server, in base allo user agent del browser, che cosa stampare. Una pagina messa in cache per un telefono non deve essere servita a un desktop: attiva file di cache separati per i dispositivi mobili.
- La prima visita a una nuova combinazione di filtri è più lenta: quell'URL non ha ancora una copia in cache. Per la velocità in generale, vedi come velocizzare il filtraggio nei cataloghi di grandi dimensioni.
Un ordine sicuro per i test
- Lavora in una finestra privata, senza essere connesso, con la console aperta.
- Disattiva tutta l'ottimizzazione JavaScript (minificazione, unione, differimento, ritardo, Rocket Loader) e svuota ogni livello di cache. Se ora il filtro funziona, la causa è l'ottimizzazione. Se continua a non funzionare, la causa è altrove: leggi il primo errore della console e prova con un tema predefinito su una copia di staging.
- Riattiva le opzioni una alla volta, svuota la cache e verifica dopo ciascuna. Quando una di esse rompe il filtro, aggiungi le tre righe di esclusione a quell'opzione, oppure lasciala disattivata.
- In modalità AJAX, controlla di nuovo il filtro su una pagina che è rimasta in cache per un giorno. Nessun nonce error significa che la durata della cache o del token è corretta.
- Prova sia su un telefono sia su un desktop, e anche nella seconda pagina dei risultati.
Se dopo questi passaggi il filtro continua a funzionare solo per gli utenti connessi, apri una discussione sul forum di supporto di HUSKY con il link della pagina, il primo errore della console e l'elenco delle opzioni di ottimizzazione che hai attivato, e ce ne occuperemo.