Installare o aggiornare un plugin può causare un errore fatale se ci sono incompatibilità con WordPress, PHP, il tema o altri plugin. Se il sito va in crash, la cosa più importante è ripristinare l’accesso senza fare modifiche casuali.
1. Controlla se WordPress ha attivato la Recovery Mode
In caso di errore fatale, WordPress può inviare all’email amministrativa un messaggio con un link alla Recovery Mode. Se lo ricevi, puoi entrare nel backend in modalità di recupero e disattivare il plugin che ha causato il problema.
2. Se non accedi al backend, disattiva il plugin via file
Accedi via SFTP/FTP o File Manager, vai in wp-content/plugins/ e rinomina temporaneamente la cartella del plugin appena installato o aggiornato.
Esempio: plugin-esempio → plugin-esempio-disabled. WordPress non troverà più il plugin e lo considererà disattivato.
3. Leggi l’errore prima di reinstallare
Se il sito torna online, non limitarti a riattivare subito il plugin. Controlla i log PHP del server o il file di debug per capire quale funzione, classe o requisito ha generato l’errore.
Su produzione evita di mostrare gli errori ai visitatori. Se abiliti il debug, meglio registrarli in un file e disattivarlo una volta terminata l’analisi.
4. Verifica compatibilità e requisiti
- versione PHP supportata;
- versione minima di WordPress;
- compatibilità con il tema e gli altri plugin;
- eventuali dipendenze richieste;
- changelog dell’ultima versione;
- issue note o problemi noti del plugin.
5. Ripristina un backup solo quando serve
Se rinominare il plugin risolve il problema, spesso non serve ripristinare tutto il sito. Il restore completo ha senso quando l’aggiornamento ha modificato anche database, configurazioni o altri componenti e non è possibile tornare indietro in modo pulito.
6. Non lasciare il plugin rinominato come soluzione definitiva
Una volta individuata la causa, scegli se aggiornare, sostituire o rimuovere definitivamente il plugin. Lasciare cartelle disattivate e dimenticate sul server aumenta solo confusione e superficie di attacco.
Se il crash è iniziato dopo un aggiornamento o non riesci a capire quale componente lo provoca, puoi leggere anche 5 errori comuni di WordPress oppure contattarmi per un’analisi tecnica.
