Disabilitare i Cart Fragments in WooCommerce: Conflitti e AJAX Fallite
WooCommerce è una piattaforma potente ed estremamente versatile. Tuttavia, la gestione predefinita delle risorse AJAX può rallentare notevolmente il tuo negozio online.
Lo script nativo cart-fragments.js genera continue richieste al server. Per questa ragione, disabilitare i cart fragments in woocommerce è diventata una procedura comune per migliorare le prestazioni TTFB.
Quando questa operazione non viene eseguita correttamente, possono emergere gravi problemi funzionali. In questa guida analizziamo cause, soluzioni tecniche e le migliori pratiche per evitare errori nel checkout.
Cosa sono i Cart Fragments e perché causano rallentamenti
WooCommerce include una funzionalità nativa per sincronizzare il carrello. Questa routine sfrutta chiamate AJAX asincrone verso l’endpoint /?wc-ajax=get_refreshed_fragments.
Il funzionamento dell’endpoint get_refreshed_fragments
A ogni caricamento di pagina, il browser invia una richiesta HTTP POST. Questa chiamata verifica se il carrello dell’utente contiene elementi aggiornati.
Il server deve caricare l’intero ambiente WordPress per rispondere. Questo processo aggira completamente la page cache del server, sovraccaricando il database.
Se hai mille visitatori simultanei, il server elaborerà mille richieste PHP dinamiche. Questo collo di bottiglia degrada velocemente il tempo di risposta del server (TTFB).
Perché valutare la disattivazione dello script
La maggior parte dei visitatori naviga sul sito senza aggiungere subito prodotti. Inviare richieste AJAX continue per utenti anonimi con carrello vuoto è inutile.
Scegliere di disabilitare i cart fragments in woocommerce riduce istantaneamente il carico sulla CPU. Di conseguenza, le pagine statiche e le schede prodotto diventano fulminee.
Attenzione: disattivare i fragments senza predisporre un’alternativa dinamica renderà statico il conteggio degli articoli nel mini-cart dell’header.
Come disabilitare correttamente lo script in WordPress
Esistono vari metodi per rimuovere questo script dalle pagine che non ne necessitano. La soluzione ideale consiste nell’uso di hook PHP mirati nel file functions.php.
Snippet PHP essenziale per rimuovere lo script
Per deregisterare lo script, usiamo l’azione standard wp_enqueue_scripts. Possiamo limitare l’esecuzione solo alle pagine dove il carrello non serve.
Ecco il codice consigliato per implementare la disattivazione in sicurezza:
- Verifica l’esistenza dei cookie del carrello WooCommerce.
- Rimuovi la coda dello script solo se il carrello è vuoto.
- Mantieni attivi i fragment nella pagina carrello e checkout.
Un’implementazione scorretta del codice può generare errori critici durante il bootstrap. Ti consigliamo di leggere il nostro tutorial su come prevenire schermata bianca e fatal error da dequeue errato di wc-cart-fragments.
Disattivazione selettiva tramite plugin di ottimizzazione
Se preferisci non modificare il codice PHP, puoi utilizzare plugin specifici. Strumenti avanzati come Perfmatters o WP Rocket permettono di disabilitare l’opzione con un clic.
Questi plugin gestiscono la rimozione automatica dello script nelle pagine non-eCommerce. Questa modalità tutela l’esperienza utente riducendo drasticamente il margine di errore manuale.
Risolvere i conflitti tipici e il mini-cart bloccato
La rimozione dei fragments elimina le chiamate AJAX superflue. Tuttavia, crea spesso incongruenze visive nell’interfaccia utente.
Il problema del mini-cart non aggiornato
Quando un cliente clicca su “Aggiungi al carrello”, il conteggio dell’header potrebbe non variare. L’utente pensa che l’azione sia fallita e clicca ripetutamente.
Questo disallineamento accade perché il markup HTML del counter non riceve più la risposta automatica. Per risolvere questo specifico intoppo, segui la nostra guida sul mini-cart bloccato dopo la disattivazione dei fragments.
La soluzione prevede l’ascolto di trigger JavaScript personalizzati sull’evento added_to_cart. In questo modo la chiamata AJAX parte esclusivamente quando l’utente compie un’azione reale.
Conflitti con la Page Cache e carrelli fantasma
La combinazione di caching aggressivo e assenza di fragments produce spesso carrelli apparentemente vuoti. Questo avviene quando il plugin di cache memorizza le risposte HTTP personalizzate.
I cookie di sessione non vengono riconosciuti in tempo dai sistemi di reverse proxy come Varnish. Approfondisci l’argomento nella nostra guida per risolvere il bug del carrello vuoto in presenza di page cache.
Regolare correttamente le regole di bypass della cache è indispensabile per la stabilità del negozio online.
Procedura passo-passo per verificare lo stato delle chiamate AJAX
Prima e dopo le modifiche, devi sempre monitorare il comportamento del network. Segui attentamente questa procedura di diagnostica:
- Apri il tuo negozio online in una finestra di navigazione anonima.
- Accedi agli Strumenti per Sviluppatori del browser premendo il tasto F12.
- Spostati sulla scheda denominata Network o Rete.
- Filtra le richieste inserendo il termine
wc-ajaxnel campo di ricerca. - Ricarica una pagina archivio o una scheda prodotto qualsiasi.
- Verifica che la chiamata a
get_refreshed_fragmentsnon venga inviata. - Aggiungi un prodotto al carrello e controlla il corretto aggiornamento del counter.
Se la chiamata compare ancora, la cache del browser o del server potrebbe mostrare file obsoleti. Svuota sempre la cache dopo qualsiasi intervento tecnico sul codice.
Strategia definitiva: quando disattivare i Cart Fragments
La scelta di disabilitare i cart fragments in woocommerce non è una soluzione universale obbligatoria per ogni e-commerce. Ogni piattaforma possiede architetture e necessità differenti.
Quando è assolutamente consigliato procedere
Dovresti disabilitare la funzionalità se il tuo catalogo riceve molto traffico organico. Se la maggioranza degli utenti legge solo articoli informativi, la disattivazione porta benefici immediati.
Anche i server condivisi con scarse risorse beneficiano enormemente da questo intervento. Il carico computazionale crolla, riducendo gli errori 503 e 504 del server web.
Quando mantenere i Cart Fragments nativi
Se il tuo tema non supporta il ricaricamento asincrono personalizzato, mantieni l’impostazione predefinita. Risparmierai ore di complessa configurazione e debug JavaScript.
Inoltre, valuta di non disabilitare i cart fragments in woocommerce se utilizzi già un hosting enterprise con micro-caching Redis e risorse dedicate ampie.
Domande Frequenti (FAQ)
Disabilitare i cart fragments impedisce l’acquisto dei prodotti?
Assolutamente no. Il processo di checkout e la pagina carrello continuano a funzionare regolarmente. L’unica differenza riguarda l’aggiornamento automatico dell’icona del carrello nelle altre pagine.
Posso disattivare lo script solo su smartphone?
Sì, puoi usare funzioni condizionali PHP come wp_is_mobile(). Tuttavia, è preferibile una soluzione universale basata sulla presenza effettiva di articoli nel carrello.
Perché il punteggio Google PageSpeed migliora dopo questa operazione?
La rimozione dello script riduce l’esecuzione di codice JavaScript durante il caricamento iniziale. Questo abbatte il parametro Total Blocking Time (TBT) e velocizza l’interattività del sito web.