Een WordPress wit scherm betekent bijna altijd dat er een fout optreedt die niet zichtbaar wordt gemaakt. Meestal zit de oorzaak in een plugin, het thema, de cache of een fout in een configuratiebestand. Begin met vaststellen wáár het scherm wit is: op de hele site, alleen in het dashboard, op één pagina of alleen in de editor. Daarna weet je waar je moet zoeken.
Door Ronald van den Berg, oprichter bij GetForward.
Waarom zie je een wit scherm en geen foutmelding?
Sinds WordPress 5.2 vangt WordPress de meeste fatale PHP-fouten op. Je ziet dan de melding over een kritieke fout en krijgt een herstelmail. Zie je die melding? Volg dan het stappenplan in kritieke fout in WordPress oplossen.
Een écht leeg scherm krijg je nog steeds in een paar situaties:
- de fout gebeurt vóórdat WordPress zijn foutafhandeling heeft gestart, bijvoorbeeld in
wp-config.php; - de foutafhandeling is uitgezet met de regel
WP_DISABLE_FATAL_ERROR_HANDLERinwp-config.php, of een plugin onderdrukt hem; - de server toont fouten niet en geeft een lege pagina terug;
- de pagina wordt wel geladen, maar een JavaScript-fout in je browser houdt de opbouw tegen, wat je vaak ziet in de blokeditor of een page builder;
- je ziet een lege versie uit de cache, terwijl de site zelf alweer werkt.
Stap 1: bepaal waar het scherm wit is
| Wat zie je? | Waarschijnlijke oorzaak | Waar zoek je? |
|---|---|---|
| Hele site en dashboard wit | Plugin, thema, PHP-fout, fout in wp-config.php | Stap 3 en 4 |
| Website werkt, dashboard wit | Plugin die alleen in de beheeromgeving laadt, geheugen | Stap 3 |
| Dashboard werkt, website wit | Thema, cache, page builder | Stap 2 en 3 |
| Eén pagina wit | Shortcode, blok of widget op die pagina, geheugen bij zware pagina’s | Stap 5 |
| Alleen de editor wit | JavaScript-fout, conflict met een plugin of browserextensie | Stap 6 |
| Wit na een update | Mislukte of halve update | Stap 4 |
Bekijk de site ook in een privévenster en op je telefoon via mobiele data. Is hij daar wel zichtbaar, dan zit het probleem in je browser of in de cache.
Stap 2: leeg alle caches
Een cache kan een lege pagina bewaren en blijven tonen, ook als de fout al weg is.
- Leeg de cache van je cacheplugin, zoals WP Rocket, LiteSpeed Cache of W3 Total Cache. Kun je niet inloggen, hernoem dan de map van die plugin in
wp-content/plugins/. - Leeg de servercache in het controlepaneel van je hoster, als die er is.
- Gebruik je een CDN zoals Cloudflare, leeg daar ook de cache.
- Laad de pagina opnieuw in een privévenster.
Stap 3: schakel plugins en thema uit
Dit is dezelfde methode als bij een kritieke fout: hernoem via het bestandsbeheer van je hoster of via SFTP de map wp-content/plugins naar plugins-uit. Komt je site terug, zet de plugins dan één voor één terug. Helpt dat niet, doe hetzelfde met je actieve thema in wp-content/themes. De uitgebreide stappen staan in kritieke fout in WordPress oplossen.
Kijk ook in de map wp-content/mu-plugins. Plugins daarin laden altijd en zie je niet in je pluginlijst. Hosters en beveiligingsplugins zetten daar soms code neer.
Stap 4: zoek de fout in de logs
Een wit scherm is een fout die je niet ziet. De log laat hem wel zien.
- Serverfoutlog. Bij de meeste hosters vind je in het controlepaneel een foutlog of “error log”. Daar staat de PHP-fout, ook als WordPress zelf niets logt.
- WordPress-debuglog. Zet de debugregels uit het stappenplan bij een kritieke fout in
wp-config.phpen leeswp-content/debug.log. - Controleer
wp-config.phpzelf. Heb je hem net aangepast? Een ontbrekende puntkomma, een aanhalingsteken te veel of een spatie vóór<?phpkan al genoeg zijn. Zet de vorige versie terug. - Mislukte update. Staat er een bestand
.maintenancein de hoofdmap terwijl de update klaar is, verwijder het dan. Is WordPress zelf half bijgewerkt, upload dan de mappenwp-adminenwp-includesopnieuw vanuit een verse download van dezelfde versie. Laatwp-contentenwp-config.phpmet rust.
Staat er in de log “Allowed memory size exhausted”, dan is het geheugen op. Hoe je dat verhoogt, staat ook in de blog over de kritieke fout. Gaat het om een melding over de PHP-versie, lees dan de PHP-versie van je website updaten.
Stap 5: één pagina wit
Werkt de rest van de site wel, dan zit het op die ene pagina:
- Open de pagina in de editor en kijk welke blokken, shortcodes of widgets erop staan. Een shortcode van een plugin die niet meer actief is, is een bekende boosdoener.
- Maak een kopie van de pagina en haal blokken één voor één weg tot de kopie wel laadt.
- Bij zeer lange pagina’s met een page builder kan het geheugen opraken. Kijk in de log.
Stap 6: alleen de editor is wit
Laadt de site goed, maar blijft de blokeditor, Elementor of een andere page builder wit? Dan is het meestal een JavaScript-probleem.
- Open de ontwikkelaarstools van je browser (F12 of rechtermuisknop en Inspecteren) en kijk in het tabblad Console naar rode foutmeldingen. Vaak staat de naam van de plugin in het pad van het bestand.
- Probeer een privévenster zonder browserextensies. Adblockers en vertaalextensies breken soms de editor.
- Zet plugins één voor één uit vanuit het dashboard, te beginnen bij plugins die iets aan de editor toevoegen.
- Leeg de cache van je cache- of optimalisatieplugin. Het samenvoegen en uitstellen van JavaScript breekt editors vaker dan je denkt.
Voorbeeld
Stel: een rijschool in Deventer ziet na een drukke week een volledig wit scherm, zonder melding en zonder herstelmail. In de foutlog van de hoster staat een PHP-fout in wp-config.php. Een collega had daar de avond ervoor een regel toegevoegd voor een plugin en het afsluitende aanhalingsteken vergeten. Omdat wp-config.php laadt vóór de foutafhandeling van WordPress, kwam er geen melding. Na het herstellen van de regel en het legen van de servercache staat de site weer online. Sindsdien gaan aanpassingen eerst naar een staging-omgeving.
Een WordPress wit scherm voorkomen
- Maak dagelijks een back-up en test updates eerst. Zie WordPress updaten en back-ups maken.
- Pas
wp-config.phpenfunctions.phpnooit live aan zonder kopie. - Gebruik zo min mogelijk plugins die hetzelfde doen, zoals twee cache- of optimalisatieplugins tegelijk.
- Laat je site bewaken met uptime monitoring. Let op: een wit scherm geeft soms gewoon een “200 OK” terug. Kies een monitor die ook controleert of er een bepaald woord op de pagina staat.
Veelgestelde vragen
Wat betekent een wit scherm in WordPress?
Er treedt een fout op die niet getoond wordt, meestal in een plugin, het thema, de cache of een configuratiebestand. Je inhoud staat nog gewoon in de database.
Wat is het verschil met een kritieke fout?
Bij een kritieke fout vangt WordPress de fout op, toont een melding en stuurt een herstelmail. Bij een wit scherm gebeurt dat niet, bijvoorbeeld omdat de fout te vroeg optreedt of omdat het om een cache- of JavaScript-probleem gaat.
Mijn dashboard is wit, maar mijn site werkt. Wat nu?
Waarschijnlijk loopt een plugin vast die alleen in de beheeromgeving laadt, of is het geheugen op. Hernoem de pluginmap via het bestandsbeheer van je hoster en kijk in de foutlog.
Waarom blijft de editor wit?
Meestal door een JavaScript-fout van een plugin, een browserextensie of een optimalisatieplugin. Kijk in de console van je browser naar rode meldingen en zet plugins één voor één uit.
Kan mijn hoster een wit scherm oplossen?
Vaak wel. Een hoster kan de serverfoutlog lezen, caches legen en een back-up terugzetten. Bij managed WordPress-hosting hoort die hulp meestal bij het pakket.
Liever geen witte schermen meer?
We hosten en onderhouden je WordPress-site met back-ups, geteste updates en monitoring, en lossen het op als er toch iets misgaat.
Plan een kennismaking → · Website hosting