Als je intensief met WordPress werkt, kom je vroeg of laat waarschijnlijk een fenomeen tegen dat het White Screen of Death wordt genoemd: In plaats van je website krijg je ineens alleen een witte pagina te zien. Veel website-eigenaren maken zich zorgen als ze voor het eerst met dit probleem worden geconfronteerd. De situatie is echter niet zo hopeloos als de naam doet vermoeden. In dit artikel laten we zien wat er achter de fout zit en welke oplossingen er zijn voor een WordPress White Screen of Death .

Wat is het White Screen of Death? 

Er is sprake van een WordPress "White Screen of Death" (WSOD) als er in plaats van een WordPress website in de frontend en/of backend (wp-admin gedeelte) gewoon een leeg, wit scherm wordt weergegeven – zonder verdere informatie of foutmeldingen.

Deze fout is een van de meest voorkomende fouten bij WordPress en kan de hele website of alleen afzonderlijke onderdelen treffen, afhankelijk van de oorzaak.

Wat veroorzaakt een White Screen bij WordPress?

Er kunnen verschillende redenen zijn voor een WordPress White Screen of Death, waaronder:

• Defecte of incompatibele plugins of thema's
• Fout in database
• Problemen met de PHP-code
• Geheugenlimiet uitgeput
• Caching
• Beschadigde bestanden
• Servers uitgevallen

Het lastige van WSOD is dat het op het eerste gezicht geen aanwijzingen geeft over de werkelijke oorzaak. Je moet dus een beetje creatief worden om je WordPress website weer aan de praat te krijgen. We laten je zo meteen precies zien wat je kunt doen om het probleem bij de wortel aan te pakken. Zoveel kunnen we vooraf al verklappen: Vaak is het gewoon een plugin of thema dat niet goed werkt. Zodra je de boosdoener hebt gedeactiveerd, zie je je pagina weer.

Hoe los je het White Screen of Death bij WordPress op?

Klaar voor probleemoplossing? Ook al klinkt het triviaal, je moet eerst begrijpen wat je het laatst hebt veranderd op je website voordat de WSOD optrad. Vaak kan de oorzaak dan sneller worden achterhaald en verholpen. Dus vraag jezelf af:

• Wat heb ik veranderd of toegevoegd aan de website voordat het White Screen verscheen?
• Heeft iemand anders aan de website gewerkt? Zo ja, wat heeft die persoon gedaan?

Als je kunt vaststellen hoe het witte scherm is ontstaan, dan weet je waar je moet beginnen en kun je direct naar de juiste oplossing springen. Als het probleem echter niet zo eenvoudig te achterhalen is, kun je de volgende zeven oplossingen voor het WordPress White Screen of Death in volgorde doorlopen.

#1 Cache wissen

Als je alleen een witte pagina ziet in de voorkant, maar je kunt nog wel bij je WordPress Dashboard in backend, dan kan het zijn dat caching het probleem veroorzaakt.

Probeer daarom eerst je cache te legen.Als je een caching plugin hebt geïnstalleerd zoals WP Rocket of WP Super Cache, kan dit meestal snel en met een paar klikken via de instellingen van de plugin. Daarnaast moet je de cache van je browser leegmaken.

Als je onze server-side caching hebt geactiveerd in plaats van een plugin, kun je je cache ook eenvoudig legen via het WordPress Dashboard – dit kan via het menu-item Raidboxes in de header.

Je kunt de cache ook verwijderen via je Raidboxes Dashboard: navigeer hiervoor naar het item Overzicht in je Box of ga naar de Instellingen van je Box en klik op Cache legen (in het Overzicht kun je dit doen via het bijbehorende symbool in het vak Cache).

#2 Plugins deactiveren

Als het niet de caching is en je kunt je Dashboard openen via jedomein.com/wp-admin zoals gewoonlijk, dan is de kans groot dat je maar één plugin hoeft te deactiveren om alles weer correct weer te geven.

Als je direct weet welke plugin je het laatst hebt geactiveerd of bewerkt, moet je deze deactiveren via je Dashboard. Dit lost het probleem vaak op. Als de defecte plugin niet direct kan worden geïdentificeerd, kun je het volgende doen:

1. Deactiveer alle plugins door van het Dashboard naar de Plugins navigeren, ze allemaal selecteren en als een massa-actie deactiveren selecteren.
   
2. Controleer of dit het probleem in de frontend oplost.
3. Zo ja, activeer dan de afzonderlijke plugins na elkaar opnieuw. Herlaad je website na elke activering. Zo kun je zien welke plugin ervoor zorgt dat de website weer instort en deze plugin verwijderen.

Als je niet in je Dashboard kunt komen, kun je al je plugins deactiverenvia FTP (kort voor File Transfer Protocol):

1. Maak verbinding met de server via een FTP-client. Je ontvangt de inloggegevens van je hostingprovider.
2. Zoek dan in de map naar de map wp-content en daarin de submap plugins.
3. Om alle plugins te deactiveren, hernoem je dit naar iets als plugins_old.
4. Controleer daarna je website opnieuw in de frontend.
5. Als dit werkt, verander dan de mapnaam terug naar plugins en hernoem vervolgens elke submap in de plugin map afzonderlijk zoals beschreven totdat je de defecte plugin vindt.

#3 Thema deactiveren

Als geen van je plugins het WordPress White Screen of Death veroorzaakt, kan het ook aan het actieve thema liggen. Je kunt dit op twee manieren controleren, vergelijkbaar met de plugins – afhankelijk van of je toegang hebt tot je Dashboard of niet.

Als je backend werkt, moet je tijdelijk een standaard WordPress thema activeren, zoals Twenty Twenty van het Dashboard via Uiterlijk → Thema's. Test daarna je website opnieuw. Als het weer werkt met het standaardthema, dan weet je dat jouw thema het probleem is.

Als je geen toegang meer hebt tot je backend, kun je via FTP verbinding maken met de server, net zoals je met de plugins hebt gedaan. Daar hernoem je de submap wp-content/themes naar iets anders. WordPress zal dan automatisch het laatste standaardthema gebruiken.

#4 Debugmodus inschakelen 

Je kunt je probleemanalyse ook uitbreiden door een kijkje te nemen in het error.log van je server of het debug log van WordPress. Beide bevatten alle fouten die op je website voorkomen en zijn standaard uitgeschakeld. Je kunt lezen hoe je ze kunt activeren via het wp-config.php bestand in ons gedetailleerde artikel over de WordPress Debug modus. In ons magazine kun je ook meer tips en trucs vinden om de vier meest voorkomende WordPress fouten op te lossen.

Als je de debug log hebt geactiveerd en je roept de problematische pagina opnieuw op, dan zie je ook de redenen voor de fouten (of in ieder geval aanwijzingen daarvoor) op het witte scherm. Meestal veroorzaken foutmeldingen die beginnen met Fatal Error of Parse Error het White Screen of Death.

Belangrijk: Vergeet niet het debug logboek weer uit te schakelen als je het niet meer gebruikt. Als het actief blijft, schrijft WordPress elke foutmelding naar het debug.log bestand. Als er regelmatig fouten optreden, kan het snel te groot worden en beslag leggen op je opslagruimte.

#5 Controleer op problemen met automatische updates 

Soms veroorzaken automatische updates in WordPress ook problemen – vooral als de server het laat afweten. Vaak lost dit zichzelf op, maar soms leidt het ook tot een white screen of death. In deze gevallen moet je je WordPress directory controleren (via FTP client) om te zien of je een .maintenance bestand hebt. WordPress uploadt deze bestanden meestal tijdens updates en verwijdert ze daarna weer.

Als je het bestand vindt, kun je proberen het te verwijderen. Laad vervolgens je website opnieuw. Als de actie succesvol was, zou je WordPress website nu weer moeten werken.

#6 PHP Memory Limit aanpassen

Heb je een aantal van de bovenstaande oplossingen geprobeerd en zit je nog steeds voor het WordPress White Screen of Death? En je debug log klaagt over te weinig geheugen? Dan moet je je geheugenlimiet van PHP verhogen. Dit werkt meestal via het wp-config.php bestand. Daar voeg je de volgende regel toe:

define('WP_MEMORY_LIMIT','256M')

De specificatie '256M' staat voor de grootte van het benodigde RAM-geheugen in megabytes (MB). Bijvoorbeeld '512M' voor 512 MB is ook denkbaar. Houd er echter rekening mee dat je je limiet alleen naar boven moet bijstellen als je hostingpakket een overeenkomstige grote hoeveelheid RAM bevat.

Als alternatief kun je op Raidboxes eenvoudig de PHP geheugenlimiet van een starter Box aanpassen via je Box instellingen. Daar navigeer je naar PHP → PHP Memory Limit, selecteer je de gewenste limiet in de dropdown en bevestig je deze door op Wijzigen te klikken.

#7 Back-up herstellen

Als al het andere faalt en de WordPress WSOD aanhoudt ondanks talloze pogingen om het op te lossen, kun je ook een volledige back-up van je WordPress website maken met een WordPress back-up of WordPress resetten.

Het volgende geldt: Maak altijd een handmatige back-up van de huidige status voordat je een oudere versie terugzet – ook al lijkt dat in eerste instantie contra-intuïtief. Als er iets fout gaat tijdens het terugzetten, heb je nog steeds alle gegevens en kun je verder gaan met de foutdiagnose.

Als je je website host bij Raidboxes wordt er standaard elke nacht een automatische back-up gemaakt. Daarnaast kun je de back-up tot drie keer handmatig activeren met één klik – via het Dashboard in je Box:

Je kunt ook op elk moment een vorige versie van je website herstellen met slechts één klik via je Box.

Conclusie: Blijf kalm en neem voorzorgsmaatregelen

Het komt erop neer dat het als website-eigenaar behoorlijk frustrerend kan zijn om plotseling voor een wit scherm te zitten. Vooral omdat het op het eerste gezicht niet duidelijk is wat de werkelijke oorzaak is van het WordPress White Screen of Death. Het is echter nog steeds geen reden tot paniek.

In plaats daarvan moet je systematisch problemen oplossen met een koel hoofd en de ene oplossing na de andere proberen. Meestal is de onderliggende fout minder ernstig dan hij lijkt en zorgt een eenvoudige controle van de plugins en/of thema's ervoor dat alles weer werkt.

Daarnaast kun je een aantal maatregelen nemen om een WordPress WSOD in de toekomst te voorkomen:

• Beveilig je website met dagelijkse back-ups. Zo kun je hem snel herstellen als het ergste gebeurt.
• Installeer alleen plugins en themes van betrouwbare bronnen die goed zijn beoordeeld en regelmatig worden bijgewerkt.
• Werk met een staging site en test plugins, thema's en andere wijzigingen voordat je ze doorvoert naar je live website.
• Scan regelmatig op probleembestanden op je WordPress website.
• Zorg ervoor dat er niet te veel mensen aan je website werken. Hoe meer mensen toegang hebben, hoe moeilijker het is om wijzigingen bij te houden.

Veelgestelde vragen over het WordPress White Screen

Waarom wordt mijn WordPress pagina niet weergegeven?

Dat een WordPress pagina niet wordt weergegeven kan verschillende oorzaken hebben. De meest voorkomende oorzaken zijn plugins of themes die niet goed werken, fouten in de code van de site, caching, corrupte bestanden of een serverstoring.

Hoe kom ik terug op mijn WordPress website?

Als toegang tot het WordPress Dashboard niet mogelijk is vanwege een White Screen, kun je via FTP verbinding maken met je server om toegang te krijgen tot je gegevens. Op deze manier kun je problemen oplossen en de toegang tot de website herstellen.

Hoe kan ik WordPress resetten?

Als het nodig is om je WordPress website te resetten, heb je in principe drie opties: handmatig, met een plugin of met WP-CLI. Je moet altijd van tevoren een volledige back-up maken. Als je je website host bij Raidboxes kun je jezelf vaak zelfs het eigenlijke resetten besparen door te werken met back-ups en/of een kloon van je website. Je kunt hier meer lezen over dit onderwerp.