Ecranul alb al morții (WSOD) în WordPress: cum îl repari pas cu pas, fără programator

E genul de dimineață pe care nu ți-o dorești: deschizi site-ul și, în loc de pagina ta, vezi un ecran complet alb. Fără text, fără eroare, fără admin. Nimic. În engleză i se spune "White Screen of Death" (WSOD) și, deși pare catastrofal, în cea mai mare parte a cazurilor are o cauză banală și reparabilă.

Vestea bună: nu ai nevoie neapărat de un programator ca să treci de primul val de panică. Ai nevoie de un plan calm, în ordinea corectă, ca să nu strici și mai mult. Mai jos găsești exact pașii pe care îi urmează un profesionist când primește un astfel de apel de urgență - de la cel mai simplu la cel mai tehnic. Fă-i pe rând și, foarte probabil, site-ul revine.

Ce este de fapt WSOD și de ce apare

Ecranul alb înseamnă, aproape întotdeauna, că PHP-ul care generează pagina s-a oprit cu o eroare gravă ("fatal error"), iar WordPress nu a mai apucat să afișeze nimic. Din motive de securitate, mesajul de eroare e ascuns publicului - de aici pagina goală.

Cauzele cele mai frecvente sunt câteva și se repetă:

• un plugin sau o temă care intră în conflict, mai ales imediat după o actualizare;
• o limită de memorie PHP depășită;
• o eroare de cod într-un fișier editat manual (de multe ori în functions.php);
• rareori, o problemă la server sau la baza de date.

Cheia e să nu ghicești, ci să elimini pe rând suspecții. Înainte de orice altceva, dacă ai posibilitatea, fă o copie de siguranță a fișierelor și a bazei de date. Un backup înainte de intervenție îți salvează nervii dacă ceva merge prost.

Pasul 1: activează mesajele de eroare ca să vezi cauza

Un ecran alb nu îți spune nimic - dar îl poți face să vorbească. Ai nevoie de acces la fișiere prin FTP, prin File Manager-ul din cPanel sau din panoul găzduirii.

Deschide fișierul wp-config.php din rădăcina site-ului și caută linia:

`define('WP_DEBUG', false);`

Înlocuiește-o cu:

`define('WP_DEBUG', true);`

`define('WP_DEBUG_LOG', true);`

`define('WP_DEBUG_DISPLAY', false);`

Reîncarcă site-ul. Erorile se vor scrie într-un fișier numit debug.log, în folderul wp-content. Deschide-l și citește ultimele linii: de obicei îți spun exact ce plugin sau ce fișier a picat, cu numele și linia. Acesta e cel mai valoros indiciu din toată operațiunea. Când ai terminat reparația, pune WP_DEBUG înapoi pe false, ca vizitatorii să nu vadă erori.

Pasul 2: dezactivează pluginurile și schimbă tema

Cel mai frecvent vinovat e un plugin. Dacă poți intra în admin (wp-admin), dezactivează pluginurile pe rând și reîncarcă site-ul după fiecare, până când revine.

Dacă nu poți intra deloc în admin, o faci prin fișiere:

• intră prin FTP sau File Manager în wp-content;
• redenumește folderul plugins în ceva de genul plugins-off;
• verifică site-ul.

Dacă revine, un plugin era cauza. Redenumește folderul înapoi în plugins și apoi dezactivează pluginurile unul câte unul (redenumind subfolderele) până îl găsești pe vinovat.

Dacă problema persistă, testează tema: redenumește folderul temei active din wp-content/themes. WordPress va reveni pe o temă implicită (de exemplu Twenty Twenty-Something) și, dacă asta rezolvă, tema ta era problema.

Pasul 3: mărește limita de memorie PHP

Dacă în debug.log vezi un mesaj de tipul "Allowed memory size exhausted", site-ul a rămas fără memorie. E o reparație simplă.

În wp-config.php, adaugă înainte de linia care spune "That's all, stop editing":

`define('WP_MEMORY_LIMIT', '256M');`

Dacă nu e suficient sau nu ai voie să modifici din WordPress, poți crește limita din php.ini sau din panoul găzduirii (mulți hosteri din România au o setare de PHP unde alegi valoarea memoriei direct din interfață).

Dacă nu ai acces la aceste setări, e momentul potrivit să scrii un mesaj la suportul găzduirii: e o cerere frecventă și ți-o rezolvă repede. Memoria mică apare des pe planurile de hosting ieftine, mai ales pe site-uri cu multe pluginuri sau cu un magazin WooCommerce.

Pasul 4: revino la ultima versiune bună și când ceri ajutor

Dacă totul a pornit după o actualizare sau după o editare manuală, cel mai curat e să revii la starea de dinainte. De aceea backupul contează: cu o copie recentă, restaurezi fișierele și baza de date și site-ul e din nou online în câteva minute.

Dacă ai editat manual functions.php și ai primit ecran alb, cel mai probabil ai lăsat o paranteză sau un punct și virgulă în plus. Deschide fișierul și scoate ultima modificare pe care ai făcut-o.

Cere ajutor de la un profesionist când: nu găsești fișierele, erorile arată probleme la baza de date, sau site-ul îți aduce bani și fiecare oră oprit costă. Noi, la MPO Web Studio, lucrăm remote în toată țara și putem prelua o urgență de acest fel rapid - ne scrii pe WhatsApp, ne dai acces și îl repunem online. Iar pentru clienții noi construim site-uri cu o structură curată și un demo gata făcut înainte să plătești, tocmai ca astfel de sperieturi să fie rare.