Reggel megnyitod a saját oldaladat, és a böngészőben csak egy üres fehér lap vár. Vagy egy rövid üzenet, hogy kritikus hiba történt a weboldalon. A fehér képernyő ijesztő, mert se hibakód, se kapcsolattartó nincs rajta, a fejlesztő pedig vagy nem veszi fel a telefont, vagy már régen nincs.
Ez a cikk azoknak szól, akik nem értenek a WordPresshez, és most azonnal tudni akarják, mit csináljanak. Végigmegyünk a leggyakoribb okokon, majd az első 30 percen lépésről lépésre, és külön leírjuk, mit ne tegyél, mert abból lesz a legtöbb baj. A végén megtudod, mikor érdemes szakembert hívni, és mit mondj neki, hogy gyorsabban a lényegre térhessen.
Mit takar a WordPress fehér képernyője?
A hivatalos WordPress-dokumentáció szerint mind a PHP-hibák, mind az adatbázis-hibák megjelenhetnek üres, fehér képernyőként. Ezt a WordPress közösségében a „White Screen of Death” néven emlegetik. Előfordul, hogy lap helyett egy üzenet jelenik meg: „There has been a critical error on this website” (magyar felületen a magyar megfelelője látható). Ugyanarról a jelenségről van szó: az oldal kódja valahol elakadt, ezért nem tud megjelenni.
Ebből még nem következik, hogy a tartalmad elveszett. A hibaüzenet viszont önmagában nem bizonyítja az ellenkezőjét sem, ezért az első teendők egyike a mentés.
Egy fontos részlet: 2019 óta (WordPress 5.2) a rendszer ilyenkor e-mailt küld az oldal adminisztrátori címére, benne egy titkos hivatkozással az úgynevezett helyreállítási módhoz. A WordPress fejlesztői közleménye szerint ebben a módban a rendszer az adott böngészőben szüneteltetni tudja a hibát okozó bővítményeket és sablonokat, így be lehet lépni az adminisztrációs felületre. Ha az oldalt egy régi fejlesztő hozta létre, ez az e-mail könnyen az ő címére megy, és ott senki nem olvassa.
A leggyakoribb okok laikus nyelven
A hivatalos hibakeresési útmutató a gyakori okok között négyet emel ki.
Bővítmény vagy sablon ütközése
Két bővítmény vagy egy bővítmény és a sablon nem fér meg egymással, jellemzően egy frissítés után. Az útmutató szerint különösen a sablon a gyanús, ha közvetlenül egy új sablon aktiválása után jelent meg a fehér képernyő.
Nem megfelelő PHP-verzió
A PHP az a programnyelv, amelyen az oldal fut, a verzióját pedig a tárhely állítja be. Ha a tárhely átváltott egy újabb verzióra, vagy egy bővítmény még nem bírja azt, az oldal elakadhat. A WordPress.org követelményoldala jelenleg a PHP 8.3-as vagy újabb verzióját ajánlja, a 7.4-es verzió viszont már elérte a támogatás végét, ezért biztonsági kockázat.
Elfogyott a memóriakeret
Az oldal több erőforrást kér a tárhelytől, mint amennyit megkap. Ez főleg olcsó, osztott tárhelyen gyakori, mert ott a memóriakorlát szűk.
Megszakadt vagy sérült frissítés
Ha a frissítés közben megszakadt a kapcsolat, vagy rosszak a fájljogosultságok, a WordPress hivatalos útmutatója szerint az oldal üres fehér képernyővel válaszolhat. Ilyenkor a frissítést általában kézzel kell befejezni. A frissítések kockázatáról külön cikkben írtunk.
Mit ne csinálj, mielőtt bármihez nyúlsz?
Pánikban könnyű többet elrontani a találgatással, mint amennyit maga a hiba okozott. Ezt a hatot kerüld:
- Ne töröld ki a bővítményeket találgatásból. A törlés végleges, a kikapcsolás nem. Ha mégis ki kell kapcsolni, a mappa átnevezése visszafordítható.
- Ne írj felül fájlokat mentés nélkül, akkor sem, ha egy fórumon „csak másold be” tanácsként szerepel.
- Ne telepítsd újra a WordPresst az oldal tetejére, mert elrontott beállítással elveszhet az, ami még megvan.
- Ne indíts el újabb frissítést abban a reményben, hogy az majd megjavítja.
- Ne kérj a tárhelytől azonnali visszaállítást anélkül, hogy tudnád, mi veszik el vele. Webshopnál a mentés óta beérkezett rendelések eltűnhetnek.
- Ne oszd meg a belépési adataidat bárkivel. Ha segítséget kérsz, külön, ideiglenes hozzáférést adj, és utána cseréld le a jelszót.
Az első 30 perc, sorrendben
Az alábbi sorrend azért ilyen, mert az elején olyan lépések vannak, amelyek semmit nem változtatnak az oldalon, a végén pedig azok, amelyek már igen.
0-5. perc: állapítsd meg, mi a helyzet
Töltsd be az oldalt másik eszközről és másik böngészőből, privát ablakban is. Próbáld megnyitni a bejelentkezési oldalt (általában a cegneved.hu/wp-admin cím), mert előfordul, hogy a nyilvános oldal elromlott, az adminisztráció viszont működik. Ha a belépés megy, könnyebb dolgod van, mert onnan a bővítmények kikapcsolhatók.
Ezután keresd meg a helyreállítási e-mailt. Ellenőrizd a levélszemét mappát is, és azt a postafiókot, amelyet az oldal adminisztrátori címeként adtak meg. Ha megtalálod a levelet, a benne lévő hivatkozás a helyreállítási módba visz.
Végül gondold végig, mi változott az utolsó órákban vagy napokban: frissítés, új bővítmény, új sablon, tárhelyváltás, PHP-verzióváltás. Írd fel, mert ez a leghasznosabb információ, amit később egy szakembernek átadhatsz. Készíts képernyőképet is a hibáról.
5-10. perc: mentés, mielőtt hozzányúlsz
Lépj be a tárhely felületére (cPanel vagy a szolgáltatód saját felülete), és ha van ott mentési funkció, készíts új mentést az oldal fájljairól és az adatbázisról. Ha nincs ilyen funkció, kérj segítséget a tárhely ügyfélszolgálatától. A mentésről szóló cikkünkben leírtuk, hogyan lehet megállapítani, hogy egy mentés tényleg visszaállítható-e.
10-20. perc: a bővítmények és a sablon kizárása visszafordítható módon
A hivatalos útmutató szerint, ha nem tudsz belépni az adminisztrációba, FTP-n (fájlátviteli programmal) vagy a tárhely fájlkezelőjében keresd meg a wp-content/plugins mappát, és nevezd át például plugins_old névre. Ezzel az összes bővítmény kikapcsolódik. Ha ezután az oldal betöltődik, a bővítmények között van a hibás, és a mappa nevét visszaállítva egyenként aktiválhatod újra őket, amíg a hiba vissza nem jön. Az utolsó, amelyet bekapcsoltál, a gyanúsított.
Ha az átnevezés nem segít, a sablon a következő gyanúsított. Ha nem éred el az adminisztrációt, a wp-content/themes mappában nevezd át az aktív sablon mappáját. Ezt a lépést is visszavonhatod: a mappát egyszerűen visszanevezed. Ha ezt nem mered vállalni, itt érdemes megállni és segítséget kérni.
20–25. perc: ellenőrizd a tárhely beállításait
Ha a hiba azután jelent meg, hogy a tárhely átállt egy újabb PHP-verzióra, a tárhely felületén általában vissza lehet állítani az előző verzióra. Ez ideiglenes megoldás, mert a régi verzió biztonsági kockázat, de segít kideríteni, hogy a PHP az ok. Ha memóriahibára gyanakszol, az útmutató szerint a wp-config.php fájlban megemelhető a memóriakeret, osztott tárhelyen viszont ezt gyakran csak a szolgáltató teheti meg.
25-30. perc: olvasd ki a pontos hibát, vagy add át
Ha otthonosan mozogsz a fájlokban, a hivatalos útmutató szerint a wp-config.php fájlban bekapcsolható a hibakeresési mód, és a wp-content/debug.log fájlból kiolvasható, mi ment félre. Előtte feltétlenül készíts másolatot a fájlról, utána pedig kapcsold ki a hibakeresést. Ha nem, ne erőltesd. A szakembernek az is elég, ha leírod, mikor kezdődött, mi változott előtte, mit próbáltál, és milyen hibaüzenetet látsz.
Mikor kell szakember a WordPress fehér képernyője miatt?
A fenti lépések sokszor megoldják a bajt, de az alábbi esetekben ne próbálkozz tovább egyedül:
- Webshopod van, és rendelések érkeznek. Minden elveszett óra pénzbe kerül, és egy rossz visszaállítás rendeléseket törölhet.
- Fehér képernyő marad a bővítmények kikapcsolása és a sablonváltás után is.
- Az oldalon olyan tartalmat vagy átirányítást látsz, amelyet nem te tettél oda. Ilyenkor lehet, hogy feltörték az oldalt, és a feltörés utáni teendők sorrendje más.
- Nincs mentésed, vagy nem tudod, hol van.
- Nincs kihez fordulnod, mert a fejlesztő eltűnt.
Ha a probléma elmúlt, de az oldal azóta lassabb, olvasd el ezt a cikket is.
Mit mondj a szakembernek?
Négy információ is sokat gyorsít: mikor vetted észre a hibát, mi változott előtte, mit próbáltál már ki, és mi a hibaüzenet pontos szövege vagy képernyőképe. Ha megvan a mentés és a helyreállítási e-mail is, ezt is említsd.
Hogyan előzheted meg legközelebb?
Egy fehér képernyőt teljesen kizárni nem lehet. Ha viszont rendben vannak az alapok, legközelebb sokkal kevesebb pénzbe és idegességbe kerül. A frissítések tesztelten mennek, van működő mentés, és az oldal hibaértesítői olyan címre érkeznek, amelyet valaki olvas.
A karbantartási szolgáltatásunk pontosan ezt a hátteret tartja rendben. A csomag nem 0–24 órás ügyelet, és a már bekövetkezett hiba javítása külön munka. Ha most van baj, írd meg röviden, mi történt, és megnézzük, mire van szükség.
Gyakori kérdések
Eltűnt a tartalmam, ha fehér képernyőt látok?
Önmagában nem. A fehér képernyő azt jelzi, hogy az oldal kódja elakadt, nem azt, hogy a tartalom törlődött. Azt viszont a hibaüzenet sem garantálja, hogy minden megvan, ezért érdemes az első lépések között mentést készíteni.
Meddig várjak, mielőtt segítséget kérek?
Webshopnál vagy időpontfoglalással működő oldalnál ne várj a teljes 30 percig, ha az első öt perc után sem látsz tisztán: minden óra megrendelésekbe kerülhet. Ha az oldal nem hoz közvetlen bevételt, nyugodtan végigmehetsz a lépéseken.
Megoldja a hibát, ha visszaállítok egy mentést?
Megoldhatja, de csak akkor, ha a mentés a hiba előtti állapotot tartalmazza és tényleg visszaállítható. Webshopnál a mentés óta érkezett rendelések elveszhetnek, ezért előbb tisztázd, mi lesz velük.
Kell-e ehhez feltétlenül WordPress-szakértő?
Az első lépések (e-mail, mentés, a bővítmények mappájának átnevezése) egy óvatos laikus számára is elvégezhetők. Ha elakadsz, vagy üzleti tét van a dolgon, érdemes szakembert hívni.