De foutmelding WordPress White Screen of Death (WSoD), ook wel bekend als het wordpress wit scherm, is een probleem dat vaak voorkomt bij WordPress. Je opent je website of probeert in te loggen op je dashboard en ziet alleen een leeg wit scherm. Dit kan qua oorzaak lijken op de bekende http error 500, maar het is niet precies hetzelfde: bij een http error 500 zie je een duidelijke foutmelding, terwijl bij WSoD alleen een leeg scherm verschijnt. In dit artikel leggen wij stap voor stap uit waarom dit gebeurt, welke oorzaken er zijn en vooral hoe je het probleem kunt oplossen.
Wat betekent het WordPress White Screen of Death?
Het WordPress White Screen of Death betekent dat er iets misgaat in de achtergrond van je website. WordPress kan de pagina niet laden en geeft daarom geen inhoud weer. Dit kan op drie manieren gebeuren:
- Alleen de voorkant van de website is wit, maar het dashboard werkt nog.
- Alleen het dashboard is wit, maar de website zelf werkt nog.
- Beide, dus website én dashboard zijn niet bereikbaar. Dit is het lastigst om op te lossen.
Om dit probleem goed aan te pakken, moeten we eerst weten wat de oorzaak is. Hieronder bespreken we alle mogelijke oorzaken één voor één, met uitleg en oplossingen.
Oorzaak 1: Fout in PHP-code
Veel WordPress-sites draaien op PHP. Als er een fout in de code zit, bijvoorbeeld in een plugin of thema, stopt WordPress met laden. Omdat de foutmelding niet zichtbaar is, krijg je alleen een wit scherm te zien.
Oplossing: Debug-modus inschakelen
Met debug-modus kunnen we foutmeldingen zichtbaar maken. Open via File Manager in je hosting het bestand wp-config.php en voeg deze regel toe of pas hem aan:
define('WP_DEBUG', true);Na opslaan en verversen van je website zie je in plaats van een wit scherm een melding zoals:
Fatal error: Cannot redeclare function_name() in /home/user/public_html/wp-content/plugins/voorbeeld-plugin/plugin.php on line 45Deze melding geeft precies aan in welk bestand en op welke regel de fout zit. We kunnen dat bestand openen en aanpassen of de plugin tijdelijk uitschakelen. Als je zelf niet kunt programmeren, kun je de pluginmap hernoemen zodat deze wordt uitgeschakeld, of de plugin volledig verwijderen en vervangen door een alternatief.
Wil je meer weten over de debug-modus in WordPress? Lees dan de officiële uitleg in de WordPress codex debug-modus.
Oorzaak 2: Plugins veroorzaken conflicten
Plugins zijn handig, maar soms werken ze niet goed samen. Eén verkeerde plugin kan je hele site platleggen.
Oplossing via dashboard
Kun je nog inloggen in je dashboard? Ga dan naar Plugins > Geïnstalleerde plugins. Selecteer alle actieve plugins en kies Deactiveren. Daarna activeer je ze één voor één opnieuw. Elke keer ververs je je website. Als bij het activeren van een plugin het witte scherm terugkomt, weten we dat die plugin het probleem veroorzaakt.
Oplossing via File Manager
Kun je niet inloggen in het dashboard? Ga via je hosting naar File Manager en open de map /public_html/wp-content/. Daar zie je een map plugins. Hernoem deze naar bijvoorbeeld plugins_old. Hierdoor worden alle plugins gedeactiveerd. Controleer daarna of je weer toegang hebt tot je site of dashboard.
- Als het probleem is opgelost: hernoem de map weer terug naar plugins en activeer de plugins één voor één om te zien welke plugin het probleem veroorzaakt.
- Als het probleem niet is opgelost: dan ligt de oorzaak niet bij de plugins. Zet de mapnaam terug naar plugins zodat alles weer normaal staat en ga verder met de volgende stap.
Oorzaak 3: Fout in het thema
Een thema kan net als een plugin fouten bevatten of conflicteren met WordPress.
Oplossing via dashboard
Kun je inloggen? Ga naar Weergave > Thema’s en activeer een standaard WordPress-thema zoals Twenty Twenty-Five. Ververs je site om te controleren of het witte scherm weg is.
Oplossing via File Manager
Kun je niet inloggen? Ga naar /public_html/wp-content/themes/ en hernoem de map van je actieve thema. WordPress schakelt automatisch over naar een standaardthema.
- Als het probleem opgelost is, weten we dat het thema de oorzaak is. Controleer de code van je thema of neem contact op met de ontwikkelaar.
- Is het probleem niet opgelost, dan ligt de oorzaak elders en moeten we verder zoeken.
Oorzaak 4: Te weinig geheugen
WordPress heeft geheugen nodig om scripts en pagina’s te laden. Als de limiet te laag staat, krijg je vaak een WordPress White Screen of Death of zelfs een http error 500.
Oplossing via wp-config.php
Open het bestand wp-config.php, scrol naar beneden tot vlak voor de regel waar staat:
/* That's all, stop editing! Happy publishing. */Voeg de onderstaande code net boven deze regel toe:
define('WP_MEMORY_LIMIT', '512M');Oplossing via .htaccess
Open het bestand .htaccess in de rootmap. Plaats de code helemaal bovenaan het bestand, direct na eventuele bestaande regels zoals # BEGIN WordPress. Voeg daarna deze regel toe:
php_value memory_limit 512MOplossing via php.ini
Bestaat er nog geen bestand php.ini in de rootmap (public_html)? Maak dit bestand dan zelf aan. Voeg daarna deze regel toe:
memory_limit = 512MNa opslaan en verversen van je site kan het probleem verdwenen zijn.
Oorzaak 5: Verkeerde bestands- en maprechten
Als bestanden en mappen verkeerde rechten hebben, kan WordPress ze niet goed laden.
Oplossing
Controleer in File Manager of de rechten zo staan:
- Bestanden: 644
- Mappen: 755
- wp-config.php: 600 of 660
Als dit niet klopt, pas je de rechten aan. Daarna vernieuw je je site.
Wil je hier dieper op ingaan? Lees dan ons uitgebreide artikel over bestands- en mappermissies in WordPress.
Oorzaak 6: Mislukte update
Tijdens een update of migratie kan er een tijdelijk bestand .maintenance blijven staan in je rootmap.
Heb je jouw website net verhuisd en krijg je nu een wit scherm? Lees dan onze handleiding WordPress site overzetten van local naar server. Zo leer je hoe je jouw website correct migreert zodat dit probleem in de toekomst niet meer voorkomt.
Oplossing
Ga naar File Manager, open de root (public_html) en verwijder het bestand .maintenance. Ververs je site. Vaak werkt je site dan meteen weer.
Als dit door een thema- of plugin-update komt, volg dan de stappen bij plugins of thema’s om de fout op te lossen.
Conclusie
Het WordPress White Screen of Death (WSoD) en de bijbehorende http error 500 klinken spannend, maar in de praktijk kun je ze meestal zelf oplossen. Je begint met de debug-modus inschakelen om te zien waar de fout zit. Daarna probeer je plugins en thema’s tijdelijk uit te schakelen, het geheugen te verhogen en de bestandsrechten te controleren. Werkt dit allemaal niet, dan is de kans groot dat het probleem bij de server ligt en is het verstandig je hostingpartij of een WordPress-specialist in te schakelen.
Veelgestelde vragen
1. Wat is het verschil tussen een wit scherm en http error 500?
Een wordpress wit scherm toont helemaal niets, terwijl een http error 500 een duidelijke foutmelding geeft. Beide betekenen dat er een fout in WordPress of de server zit.
2. Kunnen wij dit zelf oplossen zonder technische kennis?
Ja, de meeste stappen zoals plugins uitschakelen of het thema wisselen kunnen jullie zelf doen via File Manager of dashboard. Voor codeproblemen is het verstandig om hulp in te schakelen.
3. Hoe herkennen wij dat geheugen het probleem is?
Als het witte scherm verschijnt bij grote pagina’s of tijdens updates, is dat vaak een teken dat de geheugenlimiet te laag is.
4. Wat als debug-modus geen fout laat zien?
Soms verschijnt er zelfs met debug-modus geen duidelijke foutmelding. In dat geval moet je stap voor stap plugins en thema’s uitsluiten en het geheugen verhogen.
5. Wat gebeurt er als ik een pluginmap hernoem?
Door een pluginmap te hernoemen wordt de plugin automatisch gedeactiveerd. Als de site daarna weer werkt, weet je dat deze plugin de boosdoener was. Daarna kun je de plugin updaten of vervangen.
6. Hoe weet ik of een thema de fout veroorzaakt?
Door tijdelijk over te schakelen naar een standaardthema. Blijft de fout weg, dan zat het probleem in het vorige thema. Zo niet, dan ligt de fout ergens anders.
7. Wat als geen enkele oplossing werkt?
Blijft het witte scherm ondanks alle stappen terugkomen, dan kan het probleem bij de server liggen. In dat geval is het verstandig de hostingprovider of een WordPress-specialist in te schakelen.