Say what?? White Screen of Death? Is dat een ding? Ja! Dat is het zeker. Het witte scherm, dat men ook wel the White Screen of Death (WSoD) of het witte scherm des doods noemt, ontstaat vaak door een PHP conflict in een WordPress plug-in of theme. Benieuwd hoe je er van af komt? Lees snel verder!


Lees hieronder de andere delen uit deze serie

WordPress problemen: Deel 1 – Trage websites


In dit Blog

Omdat dit een blog is wat meerdere problemen in WordPress gaat behandelen, en ook mogelijke oplossingen zal bieden, heb ik besloten het op te delen in meerdere blogs. Vandaag deel 2: Het witte scherm, oftewel ‘The White Screen of Death’

Wat veroorzaakt een wit scherm?
Doe vooronderzoek
Schakel debug-functie in voor meer informatie
Je website overschrijdt de (PHP) “Memory Limit”
Check je plug-ins
Check je WordPress theme
Leeg je cache
WordPress herinstalleren
Conclusie

Het witte scherm

Misschien ken je het wel. Je gaat naar je website om in te loggen maar je ziet niets anders dan enkel een wit scherm. Ik zie je al denken! Hmm.. waar is mijn website nou gebleven?!

Als je het nog nooit meegemaakt hebt, lucky you! Het witte scherm is namelijk wel één van de meest voorkomende fouten in WordPress.

Het meest frustrerende is ook dat je vaak helemaal geen toegang meer hebt tot je website, en je ziet ook niet direct duidelijk waar het probleem nu eigenlijk vandaan komt. Een nachtmerrie voor iedere ondernemer! En kan het ook nog gebeuren dat er maar een deel van je website door geraakt wordt. Misschien werkt je website nog wel, maar kun je niet inloggen op je WordPress admin. Of juist andersom. Super verwarrend!

Wat veroorzaakt een wit scherm?

Het witte scherm krijg je doorgaans te zien wanneer je een bewerking op je site hebt gemaakt en deze wilt opslaan. De oorzaak hiervan ligt vaak in een PHP conflict in een WordPress plug-in, maar het kan ook in je theme zitten dat je voor je website gebruikt. Een andere oorzaak kan liggen in het maximale geheugen dat je gebruikt voor je WordPress website. Je hoort in alle gevallen een foutmelding van je server te krijgen, alleen kun je deze niet automatisch zien. Daar moet je eerst wat voor doen.

PHP is een scripttaal, die bedoeld is om op webservers dynamische webpagina’s te creëren

En dan nu, er is goed nieuws en slecht nieuws. Laat ik direct maar beginnen met het slechte nieuws. Dan ben je daar van af!

Het moge duidelijk zijn dat als je de ‘White Screen of Death’ ziet, er overduidelijk een fout is opgetreden. Probleem is, dat dit dan ook meteen wel het enige duidelijke is want een foutmelding valt in je browser niet zomaar te ontdekken. Aargh!

En dan het goede nieuws! Het is geen zeldzame fout, maar een vrij veel voorkomende fout. Dat het erg bekend is, zal je helpen met het snel oplossen van dit probleem. Het is uitgebreid gedocumenteerd door WordPress. Dus geen stress!

Wil je er meer over lezen op de website van WordPress? Het probleem wordt beschreven in het artikel “Common WordPress Errors” in de WordPress Codex, de officiële kennisgemeenschap van WordPress.orgen die ook als online handleiding fungeert.

Doe vooronderzoek

Ga in ieder geval niet direct beginnen met het maken van allerlei aanpassingen, zonder vooronderzoek te doen en zonder voorbereidingen te treffen.

Maak altijd, vóór je begint, een back-up van je website.
Vraag om ondersteuning als je niet weet hoe dit moet!

Heb je meerdere WordPress websites? Check dan eerst of het probleem met het witte scherm ook op je andere websites voor komt. Zo kun je uitsluiten of het probleem specifiek bij één domein ligt. Heb je meerdere websites bij de zelfde webhoster en hebben deze domeinen er ook last van? Dan ligt de fout zeer waarschijnlijk aan de kant van je webhoster.

Wanneer blijkt dat het probleem zich enkel op één website, of op één of meerdere pagina’s van je website voor doet, dan weet je zeker dat het bij je WordPress website zelf ligt.

Schakel debug-functie in voor meer informatie

Dat je het witte scherm ziet, geeft al aan dat er fouten aanwezig zijn. Je ziet echter niet wát er precies aan de hand is. Wat je dan kunt doen is de debug-functie van WordPress aanzetten, zodat aanwezige fouten zichtbaar worden gemaakt. Deze debug-functie kun je aan zetten in het wp-config.php bestand van je WordPress website. Lees hier hoe je dat kunt doen.

PHP errors worden dan wel op je website weergegeven. Het wp-config.php bestand kan je aanpassen met een FTP-programma. Het bestand staat in de hoofdmap van je WordPress website en kun je van daaruit bewerken. Standaard staat WP_DEBUG op ‘false’, zet deze op ‘true’ zodat je de foutmeldingen kunt zien.

define( 'WP_DEBUG', true );

Assistentie nodig? Je kunt mijn hulp inroepen.

Je website overschrijdt de (PHP) “Memory Limit”

Een andere veroorzaker van het witte scherm kan te maken hebben met het overschrijden van je PHP ‘memory limit’. De reden achter dit probleem kan verschillend zijn. Misschien werkt je thema of een plug-in niet goed, of heb je last van een slecht ingestelde hosting-server. Sowieso is het handig om contact op te nemen met je webhoster. Een webhoster kan in de logs kijken om te zien wat het probleem veroorzaakt.

Je kunt vaak wel zelf het limiet verhogen via je FTP programma tot een zekere hoogte. Maar ik zeg hier maar even bij: Als je geen idee hebt hoe FTP werkt, of als dit sowieso allemaal wat te technisch lijkt, kun je beter hulp inroepen.

Het limiet verhoog je door de volgende regel aanbrengen in het configuratiebestand wp-config.php of als deze al aanwezig is, aan te passen.

define( 'WP_MEMORY_LIMIT', '64M' ); 

Je kan er ook voor kiezen om het limiet te verhogen naar 256MB of 512MB.

Als je geluk hebt werkt je website na het verhogen van het limiet weer. Sommige webhosting bedrijven laten niet toe dat het geheugenlimiet door jezelf aangepast kan worden, of niet zo hoog. Mocht dat het geval zijn neem dan contact op met je webhoster.

Check je plug-ins

Als je in bovenstaande tekst geen oplossing hebt gevonden wordt het tijd om verder te kijken. Het volgende wat je kunt doen is alle plug-ins op je website deactiveren. Begin, als je nog wel in kan loggen in je WordPress admin, met de plug-in die je als laatste geactiveerd of gewijzigd hebt, en kijk vervolgens of het probleem opgelost is.

Werkt dat niet? Deactiveer dan alles en zet ze dan één voor één weer aan. Kijk na het activeren steeds of het probleem terug is of niet, om er achter te komen welke plug-in het probleem veroorzaakt.

Kan je niet meer inloggen op je WordPress website? Dan kun je wederom je website via FTP beheren. Dat kun je doen door de map naam van je plug-ins te hernoemen naar iets anders. Hiervoor ga je naar de map /wp-content/. Daarin zal je een map genaamd ‘plugins’ zien. Hernoem deze map naar iets anders (bijvoorbeeld plugins-oud). WordPress kan dan je plugins niet meer vinden en zal ze automatisch deactiveren. Met een beetje geluk kun je vervolgens weer inloggen.

Als dat het probleem wel oplost, en je dus weer in kan loggen, moet je nog steeds kijken welke plug-in het euvel veroorzaakt. Dat doe je door de map via FTP weer te hernoemen naar plugins, zoals het was. Je plugins zijn dan weer zichtbaar in het plug-in overzicht van je admin-panel, maar nog steeds gedeactiveerd. Activeer ze nu als hierboven omschreven weer één voor één.

Heb je de problemen gevende plug-in gevonden? Het is het beste om deze te verwijderen en naar een alternatieve plug-in op zoek te gaan.

Check je WordPress theme

Mochten de plug-ins niet de reden van je probleem zijn, kijk dan naar je WordPress theme. Is deze wel up-to-date? Heb je een gratis theme of een betaalde? Waar heb je je gratis theme vandaan? Veel gratis themes (en dan vooral degene die niet in de repository op WordPress.org staan) kunnen slecht gemaakt of onbetrouwbaar zijn.

Of je theme het probleem veroorzaakt kun je zien door even het standaard theme van WordPress te activeren. (Deze heet: Twenty Nineteen) Kun je niet meer inloggen op je site dan zal je ook dit weer via FTP kunnen doen.

Ga dan naar de folder /wp-content/themes/ en controleer of je de Twenty Nineteen theme hebt staan. Zo ja, hernoem dan de folder van de theme die nu actief is. (bijvoorbeeld van theme-naam naar theme-naam-2). WordPress zal nu automatisch terugvallen op een standaard theme Twenty Nineteen. Heb je de Twenty Nineteen niet meer? Je kunt hem hier gratis downloaden.

Heb je je theme gedeactiveerd en los je daarmee het probleem op? Dan kun je een kijkje nemen in het functions.php bestand van je gedeactiveerde theme.

Nogmaals een waarschuwing:
Zorg dat je altijd een backup hebt van je bestanden voordat je iets aan gaat passen. Of nog liever: vraag om ondersteuning als je niet zeker van je zaak bent.

Het lijkt maar iets kleins, maar soms staan er bijvoorbeeld een paar enters of spaties onderin het bestand, of er zit er slechte code in het bestand. Als het om slechte code gaat, wordt het oplossen van dit probleem een heel stuk lastiger. In dat geval raad ik je aan om over te stappen naar een andere theme.

Je kan ook proberen om de laatste versie van je theme te downloaden en deze te herinstalleren maar ook dit is maar een emergency-fix. Themes worden juist regelmatig ge-update om zwakke plekken te dichten, dus eigenlijk wil je die nieuwere versies niet overslaan.

Leeg je cache

Gebruik je een caching-plug-in om je WordPress website sneller te maken? Soms gebeurt het dat de cache een wit scherm veroorzaakt. Leeg, indien je in kan loggen op je WordPress website je cache. Leeg ook de cache in je browser om te kijken of je website dan weer werkt. Je kunt hier per browser lezen hoe je een cache kan legen.

WordPress herinstalleren

Heeft al het bovenstaande tot je spijt niet gewerkt? Bummer! Als laatste optie kan je WordPress opnieuw downloaden. Mogelijk is er een WordPress bestand corrupt geraakt. Klik je hier om WordPress te downloaden. Pak de bestanden uit, log in via FTP en vervang de mappen ‘wp-admin’ en ‘wp-includes’ op je website door de nieuw gedownloade versies.

Conclusie

Het is duidelijk dat het witte scherm een probleem is, een bekende en veelvoorkomende zelfs. Dat is een geluk bij ongeluk, want juist daardoor is er enorm veel documentatie over te vinden en kom je zo zeer waarschijnlijk snel aan een passende oplossing. Ik hoop dan ook dat je middels dit blog een oplossing hebt gevonden als je last hebt van een wit scherm.

Kom je er niet uit? Ik kan het helemaal begrijpen als dit blog net even te technisch was en je je er liever niet zelf aan waagt. Voel je vrij om contact met mij op te nemen voor ondersteuning!

Hopelijk heeft een van de gegeven manieren je probleem opgelost. Mocht je een andere manier hebben gevonden die het probleem bij jou heeft opgelost, laat het dan gerust weten in een reactie op dit bericht. Daarmee help je anderen ook weer die het ook kunnen uitproberen.


Meer lezen?


Volgende week

Volgende week donderdag 11 april kun je deel 3 lezen waarin ik diverse meldingen ga behandelen. Ik ga in dat blog wat verder in op de wat meer bekende HTTP 500 Internal Server Error plus andere meldingen die je wellicht vaker voorbij hebt zien komen.

Heb je er eerder van gehoord? Zelf wel eens meegemaakt? Of heb je totaal geen idee waar het over gaat? Ik zie je volgende week graag terug!

Wat vond je van dit artikel?

Je beoordeling is waardevol

Wil je meer van dit soort artikelen lezen?

Volg Digitaal Design dan op Social Media

Wat jammer dat je dit geen leuk artikel vond!

Ik zal mijn best doen om mijn artikelen te verbeteren.