Di solito inizia con un’email di un cliente: “il sito ha un aspetto strano” o “il checkout non funziona più”. Guardi la bacheca e ovunque c’è scritto “aggiornamento riuscito”. Eppure il sito è rotto. Questa guida ti spiega cosa fare nei primi dieci minuti, come rimettere in piedi il sito senza perdere gli ordini o gli invii dei moduli di oggi, e come fare in modo che il prossimo aggiornamento non faccia lo stesso.
Il sito è fuori uso in questo momento? Parti dalla versione breve: riparare un sito rotto dopo un aggiornamento WordPress, in 7 passaggi.
I primi dieci minuti: scopri cosa si è rotto davvero
Resisti alla tentazione di cliccare subito “aggiorna” su qualcos’altro o di ripristinare tutto il sito. Prima stabilisci che tipo di guasto hai davanti. Ci sono tre tipi comuni, e ognuno ha una soluzione diversa.
- Schermata bianca o messaggio di “errore critico”. PHP si è fermato. Di solito un plugin incompatibile con la versione di PHP o con un altro plugin. WordPress invia un’email all’indirizzo dell’amministratore con il nome del plugin e il file che non ha funzionato; controlla prima quella casella.
- Il sito si carica, ma qualcosa non va nell’aspetto. Un menu che non si apre più su mobile, una griglia di prodotti che ha perso le colonne, un modulo che appare come testo semplice. Sono problemi di layout e di JavaScript, causati in genere dall’aggiornamento di un tema, di un page builder o di un plugin di cache.
- Il sito sembra a posto, ma qualcosa non funziona più. Moduli che non inviano, un checkout che si blocca, accessi che falliscono. Spesso un plugin che ha cambiato il modo in cui salva le impostazioni, o due plugin che caricano script in conflitto.
Apri il sito in una finestra privata su desktop e su un telefono, e guarda le cinque pagine più importanti: la homepage, le pagine del menu principale, il modulo di contatto, il negozio e il checkout se ci sono, e la pagina di accesso. Annota cosa vedi. Ti servirà di nuovo questa lista quando verifichi la soluzione.
Passo 1: individua l’aggiornamento che l’ha causato
Vai su Bacheca → Aggiornamenti, o su Plugin, e guarda quali plugin, temi o versioni del core sono cambiati oggi. Se sono partiti più aggiornamenti insieme, i sospetti più probabili sono, in questo ordine: il page builder o il tema, WooCommerce e le sue estensioni, i plugin di cache e ottimizzazione, e i plugin di sicurezza. Tutto ciò che tocca il modo in cui le pagine vengono costruite o gli script vengono caricati ha più probabilità di causare un guasto visibile di un piccolo plugin di utilità.
Se riesci ancora ad accedere all’area di amministrazione, attiva per poco il debug per vedere l’errore reale: aggiungi define('WP_DEBUG', true); e define('WP_DEBUG_LOG', true); a wp-config.php, ricarica la pagina rotta e leggi wp-content/debug.log. Le prime righe del log di solito nominano il plugin. Poi disattiva di nuovo il debug; non deve mai restare attivo su un sito live.
Passo 2: rimetti in piedi il sito nel modo meno distruttivo
Procedi dalla soluzione più piccola alla più grande. Ogni passo qui sotto è meno preciso e più invasivo del precedente, quindi fermati appena il sito funziona di nuovo.
- Svuota ogni cache. Cache delle pagine, cache degli oggetti, cache della CDN e il browser. Un numero sorprendente di aggiornamenti “rotti” è solo vecchio CSS servito con il nuovo HTML. Se il sito è a posto dopo un ricaricamento forzato di una pagina non in cache, hai finito.
- Disattiva il plugin sospetto. Se riesci ad accedere, disattivalo e ricontrolla le cinque pagine. Se non riesci ad accedere, rinomina la sua cartella via SFTP o nel file manager del tuo hosting (
wp-content/plugins/plugin-name→plugin-name-off); WordPress lo disattiverà al prossimo caricamento di pagina. - Riporta quel solo plugin alla versione precedente. La maggior parte dei plugin su WordPress.org conserva le versioni precedenti in “Vista avanzata” nella loro pagina. Scarica la versione precedente, elimina quella rotta, carica quella vecchia e riattivala. Per i plugin premium, l’area clienti del fornitore di solito ha le release precedenti. Così tutti i contenuti e gli ordini di oggi restano intatti, perché hai toccato solo i file del plugin.
- Solo dopo ripristina un backup. Un ripristino completo riporta file e database al momento del backup. Tutto ciò che il cliente ha fatto da allora, come ordini, invii di moduli e modifiche, va perso a meno che tu non lo reinserisca a mano. Prima di ripristinare, controlla quando è stato fatto il backup e chiedi al cliente cosa è successo sul sito da allora. Se possibile, ripristina solo i file e tieni il database attuale; molti strumenti di backup lo permettono.
Dopo ogni passo, ripercorri la tua lista di cinque pagine su desktop e mobile. “La homepage si carica” non è la stessa cosa di “il sito funziona”.
Passo 3: dillo al cliente prima che te lo dica lui
Manda un breve messaggio appena il sito è di nuovo su: cosa si è rotto, per quanto tempo, cosa hai fatto e cosa farai per evitarlo. I clienti perdonano un aggiornamento rotto; non perdonano di saperlo da un loro cliente. Basta un messaggio di due righe. Tieni i dettagli tecnici per le tue note.
Passo 4: fai in modo che non succeda più
Ogni aggiornamento rotto in questa guida ha la stessa causa: l’aggiornamento è andato sul sito live, e il primo controllo è avvenuto quando era già online. La soluzione è cambiare l’ordine, non smettere di aggiornare. Una routine che funziona per agenzie con molti siti clienti:
- Tieni un backup fresco, ogni notte. File e database. Un backup da cui puoi davvero ripristinare, il che significa che hai testato un ripristino almeno una volta.
- Esegui prima l’aggiornamento su una copia del sito. Non sul sito live. Se il tuo hosting non ha una funzione di staging, per la maggior parte dei siti va bene una copia in una sottocartella dello stesso server; vedi la nostra guida su come testare gli aggiornamenti WordPress prima di andare live.
- Confronta le pagine chiave, su desktop e mobile, prima e dopo. La maggior parte dei guasti è visiva e non genera errori. Gli screenshot prima e dopo li intercettano; la nostra guida sui test di regressione visiva per WordPress spiega come.
- Aggiorna il sito live solo dopo che la copia ha superato i controlli, e ricontrollalo un’altra volta. La routine completa, compreso cosa fare dopo l’aggiornamento, è nella nostra checklist di aggiornamento WordPress per agenzie.
- Aggiorna a piccoli gruppi. Un singolo aggiornamento del page builder ti dice più di dodici aggiornamenti insieme. Quando qualcosa si rompe, sai cosa l’ha causato.
Domande frequenti
Posso annullare l’aggiornamento di un plugin WordPress?
Sì. WordPress non ha un pulsante per annullare, ma puoi installare a mano la versione precedente del plugin (le versioni più vecchie sono sulla pagina del plugin su WordPress.org in “Vista avanzata”, o nell’area clienti del fornitore per i plugin premium), oppure usare uno strumento per riportare indietro i plugin. Disattiva o elimina prima la versione attuale, poi carica quella più vecchia. Le tue impostazioni di norma restano nel database.
Ripristinare un backup mi farà perdere gli ordini recenti del cliente?
Un ripristino completo riporta il database al momento del backup, quindi ordini, invii o modifiche successivi spariscono a meno che tu non li reinserisca a mano. Per questo riportare indietro un solo plugin è la prima mossa migliore, e un ripristino dovrebbe essere solo l’ultima risorsa. Se devi ripristinare, ripristina solo i file e tieni il database attuale quando il tuo strumento di backup lo consente.
La bacheca diceva “aggiornamento riuscito”, allora perché il sito è rotto?
“Riuscito” significa solo che i nuovi file sono stati copiati al loro posto. WordPress non controlla se layout, moduli o checkout funzionano ancora dopo. Quel controllo va fatto sul sito stesso, pagina per pagina, su desktop e mobile. Farlo su una copia prima dell’aggiornamento live è ciò che evita fin dall’inizio l’email del cliente.
Come impedisco a WordPress di aggiornare automaticamente i plugin?
Nella schermata Plugin, ogni plugin ha un link “Abilita/Disabilita aggiornamenti automatici”. Disattivare gli aggiornamenti automatici per page builder, WooCommerce e plugin legati al tema è ragionevole; lasciali attivi per i piccoli plugin di sicurezza se non aggiorni spesso. Ancora meglio è una routine in cui ogni aggiornamento, automatico o no, viene prima testato su una copia.
Vuoi che l’aggiornamento venga testato prima che possa rompere qualcosa?
Ogni aggiornamento viene controllato, e quelli rischiosi vengono prima testati su una copia del sito: Verploy confronta le pagine chiave su desktop e mobile e va live solo quando niente sembra fuori posto. Se qualcosa si rompe dopo la pubblicazione, torna indietro da solo. Inizia gratis, senza carta di credito.