De ‘White Screen of Death’ (WSOD) in WordPress is een van de meest frustrerende problemen die je als website-eigenaar kunt tegenkomen. Het betekent dat je website plotseling een volledig wit scherm toont, zonder foutmeldingen of aanwijzingen over wat er misgaat. Dit kan zowel op de frontend als in het WordPress-dashboard gebeuren en wordt vaak veroorzaakt door fouten in code, serverproblemen of geheugenlimieten. Gelukkig zijn er verschillende methoden om dit probleem op te lossen.
Een van de eerste stappen is controleren of het probleem zich alleen voordoet op bepaalde pagina’s of overal op je website. Als alleen een specifieke pagina niet werkt, kan dat duiden op een probleem met een bepaalde plugin of het thema. Als het hele dashboard onbereikbaar is, is er mogelijk een ernstiger conflict in WordPress zelf. Een veelvoorkomende oorzaak is een recente wijziging in een plugin of thema. Als je recent een plugin hebt geïnstalleerd of bijgewerkt, kan het helpen om deze tijdelijk uit te schakelen. Dit kun je doen door via FTP of de bestandsbeheerder van je hostingprovider naar de map ‘wp-content/plugins’ te gaan en de naam van de pluginmap te wijzigen. Hierdoor wordt de plugin gedeactiveerd en kun je controleren of de website weer werkt.
Wij helpen je graag verder
Wanneer plugins niet de oorzaak lijken te zijn, kan het thema een probleem veroorzaken. Dit kun je testen door via FTP naar ‘wp-content/themes’ te gaan en de actieve themamap tijdelijk te hernoemen. WordPress zal dan automatisch terugvallen op het standaardthema, zoals Twenty Twenty-Four. Als de website daarna weer functioneert, ligt het probleem aan je thema en kun je overwegen om deze te vervangen of te repareren. Soms is de ‘White Screen of Death’ het gevolg van onvoldoende PHP-geheugen. WordPress heeft een standaard limiet voor hoeveel geheugen een website kan gebruiken, en als die limiet wordt overschreden, kan dat resulteren in een wit scherm. Dit kun je oplossen door het beschikbare geheugen te verhogen. Dit doe je door het bestand ‘wp-config.php’ te openen en de volgende regel toe te voegen of te wijzigen: define('WP_MEMORY_LIMIT', '256M');. Hierdoor krijgt WordPress meer geheugen, wat vaak het probleem verhelpt
Als het probleem nog steeds aanhoudt, kan het nuttig zijn om foutmeldingen in te schakelen. WordPress verbergt standaard technische foutmeldingen, maar je kunt deze zichtbaar maken door de ‘WP_DEBUG’-modus te activeren. Dit doe je door in ‘wp-config.php’ de volgende regels toe te voegen of te wijzigen:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Na het opslaan van deze wijzigingen worden fouten gelogd in het bestand ‘wp-content/debug.log’. Dit bestand kan waardevolle informatie bevatten over welke code de fout veroorzaakt. Een andere mogelijke boosdoener is een corrupte ‘.htaccess’-bestand. Dit bestand regelt belangrijke serverinstellingen en kan beschadigd raken door verkeerde configuraties. Je kunt testen of dit het probleem is door via FTP het ‘.htaccess’-bestand in de hoofdmap van je website te hernoemen naar bijvoorbeeld ‘.htaccess_old’. Vervolgens kun je in WordPress naar ‘Instellingen > Permalinks’ gaan en op ‘Wijzigingen opslaan’ klikken om een nieuw ‘.htaccess’-bestand te genereren. Soms wordt de ‘White Screen of Death’ veroorzaakt door problemen bij de hostingprovider. Dit kan bijvoorbeeld gebeuren als de server overbelast is of als er wijzigingen zijn aangebracht aan serverinstellingen. In dat geval kan het nuttig zijn om contact op te nemen met de hostingprovider en te vragen of zij een foutlog kunnen bekijken of serverproblemen kunnen bevestigen.
Als je alle bovenstaande stappen hebt geprobeerd en het probleem blijft bestaan, kan het helpen om een back-up van je website terug te zetten. Dit is vooral handig als je recente wijzigingen hebt aangebracht die niet eenvoudig te herstellen zijn. Een back-up kan ervoor zorgen dat je website weer in een werkende staat wordt teruggebracht zonder dat je handmatig fouten hoeft op te lossen. Door methodisch te werk te gaan en de bovenstaande stappen te volgen, kun je de ‘White Screen of Death’ in de meeste gevallen snel oplossen. Het is altijd verstandig om regelmatig back-ups te maken, zodat je snel kunt herstellen als er iets misgaat. Daarnaast helpt het om plugins en thema’s zorgvuldig te kiezen en alleen betrouwbare bronnen te gebruiken. Zo minimaliseer je de kans dat dit probleem in de toekomst opnieuw optreedt.
