Indice della guida
Qui affrontiamo un malfunzionamento tecnico del carrello, distinto dall’abbandono volontario dell’acquisto. Se gli articoli sono presenti e l’errore compare durante l’addebito, passa alla guida sui pagamenti WooCommerce non riusciti. Individuare il punto del blocco evita di intervenire su componenti che non sono coinvolti.
1. Descrivi quando il carrello perde il contenuto
Registra il percorso preciso: pagina di partenza, prodotto, eventuale variante, quantità, pulsante premuto e pagina successiva. Controlla se l’errore riguarda l’aggiunta iniziale, un aggiornamento della quantità o il passaggio alla cassa. Annota anche dispositivo, browser e presenza di un account autenticato.
Confronta pagina carrello, mini carrello e riepilogo della cassa. Se il numero nell’intestazione è fermo ma gli articoli compaiono nel riepilogo, il problema può riguardare l’aggiornamento della visualizzazione. Se invece ogni pagina mostra un elenco vuoto, la diagnosi deve verificare anche conservazione e recupero dei dati.
Esempio ipotetico: l’amministratore aggiunge un prodotto senza problemi, mentre un cliente ospite lo perde aprendo il carrello. La differenza è utile perché gli utenti autenticati possono seguire regole di cache diverse. Non considerare una prova effettuata dal solo pannello amministrativo come verifica dell’esperienza di acquisto pubblica.
2. Verifica prodotto, varianti e disponibilità
Se il blocco riguarda soltanto alcuni articoli, confrontali con un prodotto semplice disponibile. Controlla il tipo di prodotto e il percorso previsto: un articolo esterno può rimandare a un altro sito, mentre un prodotto variabile richiede la scelta delle opzioni configurate. La documentazione WooCommerce sulla gestione dei prodotti descrive queste differenze.
Per una variante verifica prezzo, disponibilità e combinazione selezionata. Una quantità superiore a quella vendibile, una variante non disponibile o un campo obbligatorio aggiunto da un’estensione possono impedire l’inserimento. Leggi i messaggi della pagina: talvolta sono presenti ma poco visibili nel modello grafico.
Non alterare inventario e prezzi di articoli reali solo per tentare una soluzione. Prepara un prodotto di prova nell’ambiente separato. Se la configurazione è corretta ma i clienti non capiscono quali opzioni scegliere, valuta anche la chiarezza delle schede prodotto dell’ecommerce: un problema di comprensione va distinto da un errore del carrello.
3. Controlla le pagine assegnate a carrello e cassa
Apri WooCommerce > Impostazioni > Avanzate e verifica le pagine assegnate alle funzioni del negozio. Le impostazioni avanzate ufficiali spiegano che WooCommerce usa queste associazioni per indirizzare i clienti. Controlla che le destinazioni siano pubblicate, raggiungibili e contengano la funzione corretta.
Apri la pagina nell’editor per riconoscere se usa i blocchi Carrello e Cassa oppure la versione classica basata sugli shortcode. Le personalizzazioni e le estensioni devono essere compatibili con la modalità effettiva. Un titolo “Carrello” dentro una pagina disegnata a mano non garantisce che sia presente la funzionalità WooCommerce.
Segui anche il collegamento usato dal cliente. Dopo un restyling un pulsante può continuare a puntare a una vecchia pagina, mentre la destinazione corretta funziona. Confronta menu, collegamento dopo l’aggiunta e pulsante verso la cassa. Evita di rigenerare o sostituire tutte le pagine prima di aver individuato l’associazione errata.
4. Esamina la cache su tutti i livelli del sito
La cache conserva copie di contenuti per servirli più rapidamente, ma il carrello contiene informazioni specifiche del visitatore. Le indicazioni WooCommerce sulla cache prevedono l’esclusione delle pagine Carrello, Cassa e Il mio account dalla cache delle pagine.
Verifica i percorsi reali, soprattutto se sono tradotti o personalizzati. Chiedi al tecnico di controllare plugin, hosting e l’eventuale rete CDN: cancellare la cache di un solo livello può lasciare attiva la regola che produce l’errore. Servono inoltre regole coerenti per sessioni, cookie e richieste dinamiche, secondo la documentazione del sistema impiegato.
Una prova utile confronta lo stesso percorso prima e dopo una variazione mirata della configurazione. La correzione deve sopravvivere alla normale ricostruzione della cache. Se il problema ritorna dopo poco, la semplice pulizia non è sufficiente. Non rendere il negozio permanentemente privo di ogni ottimizzazione senza aver isolato il meccanismo coinvolto.
5. Controlla la continuità della sessione del cliente
WooCommerce utilizza cookie per collegare il visitatore ai dati del suo carrello. La documentazione dei cookie WooCommerce descrive, fra gli altri, wp_woocommerce_session_, woocommerce_items_in_cart e woocommerce_cart_hash. Il tecnico può verificarne presenza e comportamento durante la sequenza che fallisce.
Controlla se il sito passa inaspettatamente fra domini, sottodomini o versioni diverse dell’indirizzo. Fai esaminare anche eventuali modifiche recenti al sistema di gestione del consenso o alle protezioni del sito, senza disattivarle indiscriminatamente. Il risultato da dimostrare è che il carrello resti associato allo stesso visitatore durante il percorso.
Prova una finestra nuova e un secondo browser per raccogliere indizi. Svuotare i dati del browser può azzerare il carrello e rende quindi necessario ricominciare il test. Distingui inoltre una perdita immediata da un carrello ritrovato vuoto dopo molto tempo: scadenza della sessione e impostazioni del browser richiedono verifiche diverse.
6. Isola errori e conflitti in un ambiente di prova
Se i controlli precedenti non bastano, ricostruisci cosa è cambiato: tema, estensioni, ottimizzazione degli script, aggiornamenti o regole dell’hosting. Chiedi di collegare gli errori del browser e del server all’orario del tentativo. Un errore visibile nella console è un indizio da interpretare, non una prova automatica contro l’ultimo plugin installato.
Segui un test dei conflitti in una copia del sito, con backup disponibile. Il confronto con una configurazione essenziale e la riattivazione progressiva dei componenti aiutano a individuare la combinazione coinvolta. Le prove devono ripetere gli stessi passaggi e includere le funzioni necessarie al caso.
Prima di operare sulla copia, controlla che pagamenti, email e collegamenti ai gestionali non producano attività reali. Non cancellare tutte le sessioni dei clienti come primo tentativo sul negozio pubblico. Se l’errore segue un aggiornamento, approfondisci la guida a WordPress che non funziona dopo un aggiornamento.
7. Verifica l’intero carrello dopo la correzione
Il controllo finale deve coprire più di una singola aggiunta riuscita. Usa una lista ripetibile e registra gli esiti su desktop e smartphone, come ospite e come cliente autenticato quando entrambe le modalità sono disponibili.
- Aggiungi un prodotto semplice e una variante disponibile.
- Aggiungi un secondo articolo e aggiorna una quantità.
- Rimuovi un articolo e confronta mini carrello e pagina completa.
- Visita un’altra pagina, poi torna al carrello.
- Passa alla cassa e verifica articoli, quantità e totali.
- Ripeti il percorso con le normali impostazioni di cache attive.
- Collauda l’ordine nell’ambiente di test, comprese le comunicazioni previste.
Se l’ordine viene registrato ma la conferma non arriva, prosegui con la guida alle email degli ordini WooCommerce. Conserva causa individuata, modifica applicata e prove eseguite: saranno utili per il prossimo intervento di manutenzione.
Fonti ufficiali e approfondimenti
Domande frequenti
Il mini carrello segna zero: significa che il prodotto non è stato aggiunto?
Non necessariamente. Confronta il mini carrello con la pagina carrello e il riepilogo della cassa. Potrebbe non aggiornarsi soltanto il contatore, oppure il contenuto potrebbe essere davvero assente: i due casi richiedono verifiche diverse.
Perché il carrello funziona per l’amministratore ma non per i clienti?
Utenti autenticati e visitatori ospiti possono seguire percorsi e regole di cache differenti. Ripeti la prova senza accesso amministrativo e confronta sessione, risposte e contenuto delle pagine.
Basta svuotare la cache per risolvere?
Può aiutare nella diagnosi, ma se una regola continua a memorizzare contenuti dinamici il problema può tornare. Occorre verificare esclusioni e configurazione su plugin, hosting ed eventuale CDN.
Posso disattivare tutti i plugin sul negozio aperto?
Per le prove sui conflitti usa una copia separata con backup e integrazioni controllate. Disattivare componenti sul sito pubblico può interrompere pagamenti, spedizioni o altre funzioni mentre i clienti acquistano.
