Il “White Screen of Death” (la famigerata schermata bianca) è il modo in cui WordPress ti dice che qualcosa è andato storto, senza però dirti cosa. Attivare il debug significa smettere di tirare a indovinare tra plugin e temi e iniziare a leggere i messaggi che il sistema ci invia.

perché dovresti farlo?

Non serve essere uno sviluppatore senior. Attivare il debug è utile quando:

• Il sito rallenta improvvisamente dopo un aggiornamento.
• Un plugin non si comporta come dovrebbe.
• Appaiono avvisi (Notice) o errori (Fatal Error) che bloccano la navigazione.
• Vuoi semplicemente pulire il codice del tuo tema da funzioni deprecate.

come attivare la modalità debug

Tutto avviene nel file wp-config.php, il cuore pulsante delle impostazioni di WordPress.

1. Accedi ai file del tuo sito tramite FTP o File Manager dell’hosting.
2. Scarica e apri il file wp-config.php.
3. Cerca la riga: define( 'WP_DEBUG', false );
4. Cambia false in true: define( 'WP_DEBUG', true );

il debug “silenzioso” (scelta consigliata)

Mostrare gli errori direttamente sul sito non è il massimo, sia per l’estetica che per la sicurezza (mostri i percorsi dei tuoi file a chiunque). La soluzione elegante è scrivere gli errori in un file di log nascosto.

Aggiungi o modifica queste righe sotto WP_DEBUG:

PHP

// Attiva il debug
define( 'WP_DEBUG', true );

// Scrive gli errori nel file /wp-content/debug.log
define( 'WP_DEBUG_LOG', true );

// Impedisce la visualizzazione degli errori a video
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

dove trovare le risposte

Una volta attivato il WP_DEBUG_LOG, troverai un file chiamato debug.log dentro la cartella /wp-content/. Aprirlo è come accendere la luce in una stanza buia: vedrai esattamente quale plugin sta causando il conflitto e in quale riga di codice si trova l’errore.

una nota di cautela

Il debug non deve restare attivo per sempre. Una volta risolto il problema, riporta i valori su false. Tenere il debug attivo occupa risorse del server (il file log può diventare enorme) e, come detto, espone informazioni tecniche che è meglio tenere per sé.