Manutenzione WooCommerce: cosa controllare dopo ogni aggiornamento

La manutenzione WooCommerce ha una regola che nei siti vetrina non esiste: ogni minuto di checkout rotto è un incasso perso, e spesso nessuno se ne accorge finché un cliente non scrive o gli ordini calano. Aggiornare è indispensabile per sicurezza e compatibilità, ma un negozio ha più parti in movimento di un sito normale: gateway di pagamento, spedizioni, email automatiche, tema con template personalizzati, processi in background. La procedura che uso per aggiornare un negozio senza sorprese prevede controlli prima, durante e dopo.

Perché la manutenzione di WooCommerce è diversa?

Perché in un negozio il database cambia di continuo e gli errori colpiscono direttamente gli incassi. Su un sito vetrina, se un aggiornamento va male ripristini il backup di ieri e hai perso poco; su un negozio, lo stesso ripristino cancella gli ordini arrivati nel frattempo.

Ci sono poi alcune caratteristiche tipiche di WooCommerce che rendono gli aggiornamenti più delicati:

• molte estensioni collegate: gateway di pagamento, spedizioni, fatturazione, abbonamenti, filtri prodotto, ognuna con la sua compatibilità;
• template sovrascritti dal tema: il tema può contenere copie modificate delle pagine di WooCommerce, che invecchiano a ogni aggiornamento;
• servizi esterni: pagamenti, corrieri e marketplace comunicano con il sito tramite webhook e API, e un errore lì non si vede aprendo la home;
• lavori in background: email, rinnovi, sincronizzazioni e pulizie girano tramite processi programmati che possono bloccarsi in silenzio.

Per questo i controlli generali descritti nella checklist di manutenzione WordPress restano validi, ma per un negozio vanno completati con quelli specifici del negozio.

Cosa preparare prima di aggiornare?

Un backup completo appena fatto, una copia di staging su cui provare e il tempo per testare. Senza queste tre cose un aggiornamento su un negozio è una scommessa.

Backup appena fatto, non quello di stanotte

Fai un backup di file e database immediatamente prima di iniziare e verifica che sia scaricabile. Se qualcosa va storto e devi ripristinare, un backup vecchio di dodici ore significa dodici ore di ordini da ricostruire a mano. La guida ai backup di WordPress spiega come impostarli e come provarne il ripristino.

Staging: la prova generale

Lo staging è una copia privata del negozio, di solito su un sottodominio protetto, dove puoi aggiornare e testare senza toccare il sito vero. Molti hosting lo creano con un clic. Nella copia disattiva o metti in modalità test i gateway di pagamento e blocca l’invio delle email ai clienti reali, altrimenti rischi addebiti veri o messaggi indesiderati.

Leggere i changelog

Prima di aggiornare, apri le note di rilascio di WooCommerce e delle estensioni principali. Cerca parole come “breaking change”, “deprecated”, “requires”, “database update”: ti dicono dove concentrare i test. Controlla anche i requisiti minimi di versione di PHP e WordPress della nuova release.

Scegliere il momento

Aggiorna nella fascia oraria con meno ordini, mai il venerdì sera o prima di una promozione, e solo quando qualcuno potrà controllare il negozio nelle ore successive.

In che ordine aggiornare WordPress, WooCommerce e plugin?

Uno alla volta, partendo dalla base: prima il core di WordPress, poi WooCommerce, poi le sue estensioni, poi gli altri plugin e per ultimo il tema. Aggiornare tutto insieme con un clic rende impossibile capire quale componente ha causato un problema.

Dopo l’aggiornamento di WooCommerce può comparire l’avviso che il database deve essere aggiornato. È normale: l’aggiornamento gira in background tramite le azioni programmate. Su negozi grandi può richiedere un po’ di tempo, ed è un motivo in più per farlo prima in staging. I principi generali sono gli stessi descritti nella guida su come aggiornare WordPress senza rompere il sito.

Come controllo i template del tema sovrascritti?

Vai in WooCommerce, Stato, Stato del sistema e scorri fino alla sezione del tema: se il tema contiene copie non aggiornate dei template di WooCommerce, lì trovi l’elenco dei file con la versione del tema e quella attuale, e un avviso che vanno aggiornati.

I template sono i file che disegnano pagina prodotto, carrello, checkout, email e area cliente. Un tema può copiarli nella propria cartella per personalizzarli; quando WooCommerce aggiorna l’originale, la copia del tema resta indietro. A volte non succede nulla, a volte un campo del checkout sparisce o un’email perde informazioni.

Come intervenire, secondo la documentazione ufficiale di WooCommerce:

1. controlla se esiste un aggiornamento del tema: spesso l’autore ha già allineato i template;
2. se i file sono nel tuo tema child, fanne una copia di sicurezza;
3. copia la versione aggiornata del template da wp-content/plugins/woocommerce/templates/ nella stessa posizione del tema;
4. riapplica a mano le personalizzazioni che avevi fatto sulla vecchia copia;
5. ripeti il test d’acquisto e controlla le email generate.

Nella stessa pagina di Stato del sistema controlla anche versioni di PHP e database, limite di memoria e l’elenco dei plugin: è la fotografia più utile da conservare prima e dopo ogni aggiornamento.

Come si fa un test d’acquisto completo?

Si compra davvero un prodotto dal negozio, come farebbe un cliente, con ogni metodo di pagamento attivo, e si verifica che l’ordine arrivi nello stato giusto con le email corrette. È l’unico controllo che dimostra che il negozio incassa.

1. Da una finestra anonima, così non sei loggato come amministratore e vedi quello che vede il cliente.
2. Aggiungi al carrello un prodotto semplice e uno variabile; applica un coupon se ne usi.
3. Controlla le spedizioni: costi corretti per l’Italia e per almeno una destinazione diversa, soglia di spedizione gratuita.
4. Completa il checkout con ogni gateway: carta, PayPal, bonifico, contrassegno, pagamenti rateali. Dove possibile usa la modalità test del gateway in staging; sul sito reale fai un acquisto di importo basso e poi rimborsalo.
5. Verifica l’ordine nel pannello: stato corretto (in lavorazione, in attesa), importi, indirizzi, note.
6. Controlla il ritorno dal gateway: se l’ordine resta “in attesa di pagamento” anche se il pagamento è andato a buon fine, spesso il problema è il webhook.
7. Prova l’area cliente: registrazione, accesso, elenco ordini, recupero password.

Per i gateway più diffusi le impostazioni mostrano anche lo stato del collegamento: per esempio l’estensione Stripe indica se i webhook risultano configurati sia in modalità reale sia in modalità test, come spiega la documentazione dei webhook Stripe. Se il test fallisce, trovi le cause più frequenti e le soluzioni nella guida al checkout WooCommerce che non funziona.

Le email d’ordine partono ancora?

Verificalo a ogni aggiornamento, perché un’email di conferma che non arriva genera richieste di assistenza, ordini duplicati e clienti preoccupati. Le email transazionali sono quelle automatiche: nuovo ordine per il negozio, conferma, ordine completato, rimborso, nuovo account.

• Durante il test d’acquisto controlla che arrivino sia l’email al negozio sia quella al cliente, e che non finiscano in spam.
• In WooCommerce, Impostazioni, Email verifica che le email necessarie siano attive e con il destinatario giusto.
• Invia le email tramite SMTP autenticato o un servizio transazionale, non con la funzione di invio predefinita del server, che è la causa più comune di email perse.
• Controlla che il dominio abbia record SPF, DKIM e DMARC corretti: senza, molti provider rifiutano o spostano in spam i messaggi.
• Se usi un plugin di log delle email, guarda gli ultimi invii: vedi subito se qualcosa ha smesso di partire.

Cos’è HPOS e cosa devo verificare?

HPOS (High-Performance Order Storage) è il sistema con cui WooCommerce salva gli ordini in tabelle dedicate invece che nelle tabelle generiche degli articoli di WordPress. Secondo la documentazione di WooCommerce, è attivo di default sulle nuove installazioni dalla versione 8.2.

I negozi nati prima possono ancora usare il vecchio sistema. Nella manutenzione conta verificare tre cose:

• quale sistema è attivo, in WooCommerce, Impostazioni, Avanzate, Funzionalità;
• la compatibilità dei plugin: WooCommerce segnala lì le estensioni non dichiarate compatibili, e se ce ne sono non permette di attivare HPOS;
• la modalità di compatibilità, che tiene sincronizzati i due sistemi: utile durante la migrazione, da disattivare quando tutto è verificato, perché raddoppia le scritture.

Il passaggio a HPOS va fatto in staging e con un backup, perché sposta i dati di tutti gli ordini. Per la procedura vedi la guida su come ottimizzare il database di un WooCommerce lento.

Perché controllare cron e Action Scheduler?

Perché molte funzioni di WooCommerce non avvengono quando clicchi, ma vengono messe in coda ed eseguite dopo: aggiornamenti del database, alcune email, rinnovi degli abbonamenti, sincronizzazioni con marketplace e gestionali. Se la coda si blocca, il negozio sembra funzionare ma qualcosa smette di succedere.

La coda si chiama Action Scheduler e la trovi in WooCommerce, Stato, Azioni programmate. Dopo ogni aggiornamento controlla:

• le azioni “In attesa” scadute: se ce ne sono molte con data passata, la coda non gira;
• le azioni “Non riuscite”: apri il log di ciascuna, spesso indica il plugin responsabile;
• il WP-Cron: di base WordPress esegue i processi programmati solo quando qualcuno visita il sito. Su negozi con molto traffico o con cache aggressiva conviene disattivarlo e sostituirlo con un cron reale del server.

Per sostituire il WP-Cron si aggiunge in wp-config.php:

define( 'DISABLE_WP_CRON', true );

e poi si crea nel pannello dell’hosting un’operazione pianificata che richiami wp-cron.php ogni pochi minuti. Fallo solo dopo aver creato il cron del server, altrimenti i processi programmati si fermano del tutto.

Ogni quanto va fatto il backup del database?

Tanto più spesso quanti più ordini ricevi: il backup giornaliero, sufficiente per un sito vetrina, su un negozio attivo lascia scoperte fino a 24 ore di ordini. Il criterio è quanti ordini puoi permetterti di perdere.

Il backup dei file (immagini, plugin, tema) cambia poco e può restare giornaliero; è il database a contenere ordini, clienti e scorte. Conserva le copie fuori dal server del sito e prova periodicamente il ripristino in staging. Il ripristino ha un limite: riportare indietro il database dopo un aggiornamento andato male cancella gli ordini arrivati nel frattempo, quindi prima di ripristinare esporta gli ordini recenti o valuta di correggere il problema in avanti.

Cosa controllare nei giorni dopo l’aggiornamento?

Il numero di ordini, i log degli errori e le segnalazioni dei clienti. Alcuni problemi emergono solo con un certo prodotto, un certo metodo di pagamento o un certo browser.

• Confronta gli ordini dei giorni successivi con lo stesso periodo della settimana precedente: un calo improvviso è un campanello d’allarme.
• Guarda i log in WooCommerce, Stato, Log, in particolare gli errori fatali e quelli dei gateway.
• Controlla che non ci siano ordini bloccati in “in attesa di pagamento” o “falliti” in numero insolito.
• Tieni d’occhio la velocità di carrello e checkout: un plugin aggiornato può aver aggiunto script pesanti.

La checklist riassuntiva

Questi sono i controlli da ripetere a ogni aggiornamento del negozio.

1. Backup completo di file e database appena fatto e scaricabile.
2. Aggiornamenti provati prima in staging, con pagamenti in modalità test ed email bloccate.
3. Changelog e requisiti di PHP e WordPress letti.
4. Aggiornamenti uno alla volta: core, WooCommerce, gateway, estensioni, altri plugin, tema.
5. Aggiornamento del database di WooCommerce completato.
6. Stato del sistema senza template obsoleti né avvisi critici.
7. Test d’acquisto completo con ogni gateway, ordine nello stato corretto.
8. Email al negozio e al cliente ricevute e fuori dallo spam.
9. Azioni programmate senza code bloccate o errori ripetuti.
10. Monitoraggio di ordini e log nei giorni successivi.

Se prepari il negozio per un picco di vendite, a questi controlli si aggiungono il blocco degli aggiornamenti e i test di carico: trovi tutto nella checklist per il Black Friday su WooCommerce.

Quando conviene affidarsi a un tecnico?

Quando il negozio produce un fatturato che non puoi permetterti di interrompere, quando hai template personalizzati o molte estensioni, o semplicemente quando non hai il tempo di fare tutti questi test a ogni aggiornamento.

La manutenzione fatta bene è ripetitiva, con gli stessi controlli ogni volta, ed è la parte che si tende a trascurare quando si è presi dalla gestione quotidiana del negozio. Se preferisci delegarla, nei piani di assistenza WooCommerce di Dottor WP gli aggiornamenti vengono provati in staging e seguiti da un test del checkout, con backup del database ogni poche ore o più frequenti in base al volume di ordini. Per un quadro dei costi della manutenzione in generale puoi leggere quanto costa la manutenzione di un sito WordPress.

Domande frequenti

Posso attivare gli aggiornamenti automatici su WooCommerce?

Per le versioni minori di sicurezza del core di WordPress sì, per WooCommerce e i gateway di pagamento è sconsigliato. Un aggiornamento automatico notturno che rompe il checkout può restare inosservato per ore, mentre i clienti non riescono a pagare.

Ogni quanto va aggiornato un negozio WooCommerce?

Controlla gli aggiornamenti almeno una volta alla settimana e applica subito quelli di sicurezza. Gli aggiornamenti di funzionalità possono attendere qualche giorno, così eventuali problemi vengono segnalati e corretti prima che arrivino sul tuo negozio.

Cosa faccio se dopo l’aggiornamento il checkout non funziona?

Disattiva l’ultimo componente aggiornato o ripristina la sua versione precedente, invece di ripristinare tutto il database, così non perdi gli ordini ricevuti. Poi verifica gateway, cache ed errori JavaScript con calma in staging.

Lo staging serve anche per un negozio piccolo?

Sì, perché il rischio non dipende dalla dimensione ma dal fatto che il checkout smetta di funzionare. Molti hosting lo offrono gratuitamente e crearlo richiede pochi minuti.