„Beli zaslon smrti” (White Screen of Death, na kratko WSOD) je ena najbolj strašljivih napak WordPress: ob nalaganju strani se ne prikaže nič, le prazna, bela stran. Novejše različice WordPressa namesto tega pogosto izpišejo sporočilo: „Na tej spletni strani je prišlo do kritične napake.” Dobra novica je, da je težavo skoraj vedno mogoče odpraviti in se vsebina ne izgubi.

Kaj jo lahko povzroči?

Najpogostejši vzroki:

• napačen ali z različico WordPressa oziroma PHP nezdružljiv vtičnik,
• napačna ali zastarela predloga,
• prekoračitev omejitve pomnilnika PHP,
• prekinjena posodobitev,
• po menjavi različice PHP star vtičnik, ki na novi različici ne teče več.

Če se je napaka pojavila po posodobitvi ali namestitvi vtičnika, jo zelo verjetno povzroča ta.

1. Poglej obnovitveno e-sporočilo

WordPress od različice 5.2 o kritičnih napakah pošlje e-sporočilo na skrbniški naslov spletnega mesta. V sporočilu je navedeno, kateri vtičnik ali predloga je povzročila napako, in povezava za obnovitev, s katero se lahko prijaviš v nadzorno ploščo in izklopiš napačni vtičnik. Poglej tudi mapo z neželeno pošto.

2. Vklopi beleženje napak

Dejansko sporočilo o napaki pokaže dnevnik napak WordPress. V datoteki wp-config.php, pred vrstico /* That's all, stop editing! */, nastavi:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Znova naloži stran, nato odpri datoteko wp-content/debug.log: zadnje vrstice pokažejo pot napačne datoteke (na primer wp-content/plugins/bovitmeny-neve/...). Na koncu iskanja napak beleženje izklopi (vrednost WP_DEBUG false), ker lahko dnevnik sčasoma postane velik. O nastavitvi podrobneje piše naš članek o WP_DEBUG; kako dnevnik postaviš na mesto, ki ni dosegljivo s spleta, pokaže članek baze znanja o načinu za odpravljanje napak. Na gostovanju cPanel hude napake PHP tudi brez načina za odpravljanje napak pridejo v datoteko logs/php.error.log domačega imenika.

3. Izklopi vtičnike

V Upravitelju datotek cPanel ali prek FTP preimenuj mapo wp-content/plugins (na primer v plugins-old). To izklopi vse vtičnike. Če se stran s tem obnovi, mapo preimenuj nazaj, nato napačnega poišči s preimenovanjem vtičnikov enega za drugim. Z WP-CLI je preprosteje: wp plugin deactivate --all, nato enega za drugim wp plugin activate bovitmeny-neve. Če je po posodobitvi osumljen en sam vtičnik, ciljni izklop opisuje članek o napaki 500 po posodobitvi vtičnika.

4. Preveri predlogo

Če izklop vtičnikov ne pomaga, preimenuj mapo uporabljane predloge pod wp-content/themes. WordPress takrat preklopi na privzeto predlogo (na primer Twenty Twenty-Five), če je nameščena.

5. Povečaj omejitev pomnilnika PHP

Sporočilo o napaki „Allowed memory size exhausted” označuje prekoračitev omejitve pomnilnika. Vrednost memory_limit je mogoče povečati v datoteki .user.ini, o tem piše članek o uporabi datoteke .user.ini; na gostovanju cPanel jo lahko nastaviš tudi v vmesniku Select PHP Version.

6. Obnovi varnostno kopijo

Če vzroka ne najdeš ali je obnovitev nujna, obnovi stanje pred napako iz dnevne varnostne kopije; korake prikazuje članek o obnovitvi varnostne kopije WordPress.

Če težava tudi po tem ostane, piši naši podpori: iz dnevnikov na strani strežnika je vzrok običajno natančno viden.