In Support hebben we duizenden gesprekken per maand in de chat en helpen we onze klanten elke dag foutmeldingen en problemen op hun WordPress websites op te lossen. In ons artikel laten we je stap voor stap zien hoe je vier van de meest voorkomende WordPress fouten kunt herstellen.

Geen enkel ander content management systeem (CMS) is zo eenvoudig te gebruiken als WordPress: thema's en plugins worden met een paar klikken geïnstalleerd en beheerd, zonder dat je veel technische kennis nodig hebt. Met een marktaandeel van meer dan 40 procent is WordPress zowat het besturingssysteem van het internet geworden.

Met zijn gebruiksgemak, actieve community en vele manieren om je website te individualiseren, is WordPress perfect voor het web van vandaag. Het is dus des te frustrerender wanneer WordPress plots problemen begint te vertonen. Maar er is geen reden tot paniek! Vandaag zal ik je laten zien hoe je vier typische WordPress fouten snel, gemakkelijk en zelf kunt oplossen.

Onze tips voor het herstellen van typische WordPress fouten

Om je zo goed mogelijk te ondersteunen bij het oplossen van problemen en om de kennis van onze jarenlange support ervaring te delen, zal ik vandaag de mogelijke oorzaken en de bijbehorende oplossingen voor vier typische WordPress problemen toelichten.

WordPress Fout #1: White Screen of Death

Het "White Screen of Death" (WSOD) is een analogie van het Blue Screen of Death, dat in Windows verschijnt bij een systeemcrash. Zoals de naam al aangeeft, blijft met de WSOD de website, in de frontend of backend (wp-admin), gewoon wit – zonder foutmelding of verdere informatie.

Mogelijke oorzaken en oplossingen voor een White Screen of Death

Oorzaak 1: Onverenigbare plugins of themes

De fout wordt vaak veroorzaakt door een verkeerde combinatie van plugins of themes, zoals bijvoorbeeld:

• Een plugin is niet met een andere plugin of met het actieve theme compatibel.
• Een plugin/theme werd twee keer geüpload via S/FTP in verschillende versies.
• Een plugin/thema kan niet worden gebruikt met de ingestelde PHP-versie.

Door een van deze fouten wordt WordPress verlamd en lokt het het White Screen of Death uit.

Probleemanalyse: Zijn je plugins en themes niet compatibel?

De eerste aanpak is om jouw recente wijzigingen ongedaan te maken. Denk na over welke veranderingen je hebt aangebracht. Heb je misschien een nieuwe plugin geïnstalleerd of een theme veranderd? Updates van plugins en themes kunnen ook leiden tot dit wangedrag.

Eerst moet je bepalen of de fout op alle of alleen op bepaalde webpagina's optreedt. Wordt bijvoorbeeld alleen je contactpagina beïnvloed? Als je net een contactformulier hebt geïntegreerd, kan worden geconcludeerd dat deze contactformulier plugin verantwoordelijk is voor de WSOD.

Treedt het White Screen Of Death op in de hele frontend op alle URL's? Dan kan het gaan om het theme zelf of een plugin die op de hele website is geïntegreerd – bijvoorbeeld een widget in de footer, een slider in de header of een plugin voor de navigatie.

Als de backend (yourwebsite.com/wp-admin) nog steeds wit blijft, is het waarschijnlijk het theme of een verkeerde configuratie van de webserver.

Controleer je debugging log!

Vaak helpt een blik op het error.log van je server of het debug log van WordPress zelf (WP Debug Mode). Je kunt dit activeren door de wp-config.php van je WordPress installatie te bewerken en daar /* That’s all, stop editing! Happy blogging. */ toe te voegen aan de volgende regels:

<p>define('WP_DEBUG',true);</p>
<p>define('WP_DEBUG_DISPLAY',true);</p>

Als jouw installatie al een 'WP_DEBUG' item heeft, maar het is ingesteld op false, kun je deze waarde gewoon veranderen in true en de volgende regel eronder toevoegen:

define('WP_DEBUG_DISPLAY',true);

Als je dan opnieuw naar je probleempagina gaat, krijg je de overeenkomstige redenen voor fouten in plaats van de witte pagina. De fouten die beginnen met Fatal Error of Parse Error zijn meestal de fouten die het White Screen Of Death veroorzaken.

Nu kun je precies zien welk bestand op welk moment een fout genereert en waarom dat gebeurt. Ik heb een voorbeeld voor je om dit te illustreren. We zien de volgende informatie in de parse error:

Dus de fout treedt op:

• In het bestand /wp-content/plugins/contact-form-7/wp-contact-form-7.php
• In regel 12
• Blijkbaar staat daar een onverwacht bord, in dit geval een

  “<”

  .

In geval van incompatibele plugins & themes zijn de volgende oplossingen beschikbaar:

Oplossing 1: Herstel een back-up als je dat kunt doen. Dit zet gewoon je WordPress installatie terug naar de staat waarin het zich bevond voordat de fout optrad.

Oplossing 2: Als je geen backup hebt, heb je geen andere keuze dan de map van de verdachte plugin of theme te hernoemen via S/FTP. Dit zal het deactiveren. In ons voorbeeld, zou het de map van de Contact Form 7 plugin zijn.

Als je niet zeker weet welke plugin de fout veroorzaakt, probeer dan het volgende: Hernoem alle plugin/thema folders één voor één. Als de fout verdwijnt na het hernoemen van een map, heb je de boosdoener geïdentificeerd. Bij Raidboxes kun je ook gewoon het plugin- en themabeheer in het Dashboard gebruiken om de plugin te deactiveren. 

Tip: Vaak is het probleem gewoon een hernoemde themamap, dus je moet deze via S/FTP controleren op de juiste spelling!

Oorzaak 2: Serverfout

1) Probleem: te weinig geheugenlimiet voor PHP

De typische foutmelding in het error.log hiervoor is:

“Fatal error: Allowed memory size of XXXX bytes exhausted (tried to allocate XXXX bytes) in…”

Verder kan er een witte pagina zijn met de foutmelding Internal Server Error.

Wat hier gebeurt is het volgende:

Een PHP taak verbruikt meer geheugen dan de door de hoster ingestelde waarde toestaat.

Oplossing: In dit geval is het meestal voldoende om de volgende regel toe te voegen aan wp-config.php:

define('WP_MEMORY_LIMIT','256M')

De '256M' staat voor de verbruikte hoeveelheid RAM in MB. Zo zou bijvoorbeeld ook '512M' voor 512MB denkbaar zijn.

Je moet er echter rekening mee houden dat een te hoge waarde ertoe kan leiden dat je site volledig vastloopt. Daarom moet je de PHP Memory Limit alleen verhogen als je tarief het overeenkomstige RAM-geheugen biedt. Als je tarief maar weinig RAM bezit, moet je een tarief upgrade bij je hoster overwegen.

2) Probleem: Max Execution Time overschreden

Bij het installeren van grotere WordPress themes of plugins, of bij grotere imports of exports van gegevens, kan de volgende fout optreden, die meestal in de backend wordt weergegeven:

Fatal Error: Maximum Execution Time of XX Exceeded in XXX

Dit betekent dat de tijd die een PHP script mag draaien is overschreden. Dit gebeurt vaak wanneer veel producten worden geïmporteerd in WooCommerce of wanneer ordergegevens worden geëxporteerd.

Oplossing: Verhoog de max_execution_time. Een opmerking vooraf: normaal gesproken is de door de hoster opgegeven runtime voldoende. Om onnodig lange laadtijden en problemen te voorkomen, moet de maximale uitvoeringstijd alleen in individuele gevallen worden verhoogd (bijvoorbeeld voor het uploaden van een groot bestand) en daarna weer worden verlaagd.

Bij Raidboxes kun je de max_execution time voor de frontend en de backend afzonderlijk instellen via de Box instellingen:

Bij sommige hosts kun je de .htaccess bewerken via S/FTP en de regel php_value max_execution_time 300 toevoegen. Hier staat 300 voor het maximum aantal seconden dat een script mag lopen. In dit geval 5 minuten.

WordPress Fout #2: Problemen met SSL

Maximaal na de inwerkingtreding van de Algemene Verordening Gegevensbescherming (AVG) in mei 2018 zou een SSL-certificaat voor jou een must moeten zijn. Het is niet voor niets dat de meeste browsers nu een waarschuwing geven als een website niet versleuteld wordt weergegeven. Dit maakt het des te vervelender wanneer SSL-fouten optreden op je WordPress website.

Mogelijke oorzaken en oplossingen voor SSL-problemen

Oorzaak 1: Certificaat niet meer up-to-date

Ten laatste met de gratis certificaten van Let's Encrypt, zou deze fout eigenlijk tot het verleden moeten behoren. Er zijn echter bepaalde soorten certificaten die een geldigheidsduur hebben. Als deze verlopen is, kan er een SSL-fout optreden.

Oplossing: De gemakkelijkste manier is het integreren van een SSL-certificaat zonder termijn, dat sommige hosters en Raidboxes gratis leveren en automatisch vernieuwen. Als deze dienst niet door jouw hoster wordt aangeboden, moet je het certificaat handmatig vernieuwen. Hiervoor kun je het beste een herinnering instellen en tijdig contact opnemen met de leverancier van je certificaat om het te vernieuwen.

Oorzaak 2: Domein nog niet op het certificaat geregistreerd

Wanneer een SSL-certificaat wordt uitgegeven, specificeert men voor welke domeinen dit certificaat geldig moet zijn. Op deze manier kan een mogelijke registratie http://domain.com zijn. Als een forwarding van http://www.domain.com achteraf wordt opgezet, heeft dit domein geen SSL en wordt er een fout uitgegeven.

Oplossing: Het nieuwe domein moet aan het SSL-certificaat worden toegevoegd en vervolgens worden vernieuwd. Aangezien dit een vrij tijdrovend en ingewikkeld proces is, moet je hiervoor contact opnemen met je webhost.

Bij Raidboxes is het voldoende om SSL uit en weer aan te zetten in de Box instellingen na het toevoegen van de extra domeinen.

Oorzaak 3: Mixed Content Fout

Bij het instellen van SSL in WordPress, moet het http:// adres in de database standaard vervangen worden door https://. Bij Raidboxes gebeurt dit automatisch wanneer SSL wordt ingesteld. In ongeveer 5 tot 10 procent van de gevallen kan het toch voorkomen dat er bronnen zijn die via HTTP worden geladen. Dit kan bijvoorbeeld het geval zijn met hardcoded afbeeldingen of CSS/JS-bestanden. In Chrome is de URL dan grijs en niet groen.

Probleemanalyse en oplossing:

Ten eerste moet je controleren of je daadwerkelijk Mixed Content fouten op je website hebt.

1. Druk op F12 op je website (CMD+F12 op MAC) en de ontwikkelconsole wordt geopend. Onderaan de console verschijnen velden met "Mixed Content" met een gele achtergrond.".
   
2. Maak nu een back-up van je website.
3. Installeer de plugin  Better Search Replace. Na activering vind je de plugin onder "Tools" > "Better Search Replace".
   Voer in het veld "Zoeken naar" het volgende in: http://
   en in "Vervangen door": https://
   Selecteer vervolgens alle tabellen in het tabellenveld en vink onderaan "Test run" aan.
   

   

   
   Klik nu helemaal onderaan op "Start zoeken/vervangen".
4. Als de testrun enkele tabellen heeft gevonden, kun je het vinkje bij "Testrun?" weghalen en de echte run starten.
5. Nadat de echte run is voltooid, controleer je opnieuw op de website of je nog steeds mixed content fouten hebt (zie stap 1).
6. Als er nog steeds Mixed Content fouten optreden, controleer dan de broncode om te zien waar de bronnen nog steeds zijn opgenomen met "http" in plaats van "https" en vervang ze daarom.

WordPress Fout #3: 504 Gateway Time-out

Een 504 gateway time-out fout kan vrij vaak voorkomen als je een groot aantal plugins hebt die ook met externe diensten communiceren. De foutmelding betekent dat een PHP-proces langer dan 30 seconden duurt. Als je eigenaar bent van de website, wordt de fout vaak direct in verband gebracht met een probleem op de server. Dit is echter niet altijd het geval.

Mogelijke oorzaken en oplossingen voor 504 Gateway Time-out

Een 504 gateway time-out fout treedt op wanneer een server die als gateway fungeert, d.w.z. de server die een verbinding met een andere server tot stand brengt, deze andere server niet binnen een bepaalde tijd kan bereiken.

Deze fout kan worden veroorzaakt door een aantal verschillende elementen. Het kan je lokale netwerk zijn, je browser, ISP (Internet Service Provider), webserver of zelfs een plugin of theme van een derde partij.

Oorzaak 1: Plaatselijk probleem

Gewijzigde browserinstellingen, een geactiveerde proxy, problemen met je ISP, een verouderde lokale DNS-cache en vele andere mogelijkheden kunnen deze fout veroorzaken.

Oplossing: Test de URL op de website http://www.isitdownrightnow.com/. Als je een bericht krijgt dat de website online is ("yourwebsite.com" is UP and reachable), is er een lokaal probleem. Als het resultaat van de test echter is dat "yourwebsite.com" DOWN is, dan wijst dit op een probleem met je DNS, je webserver of een WordPress plugin of thema.

Oorzaak 2: DNS problemen

Het DNS (Domain Name System) is verantwoordelijk voor het omzetten van je URL (zoals raidboxes.de) in een IP.

In het geval van een nieuwe registratie of een verhuizing van het domein kan het enige tijd duren voordat alle computers, DNS-servers en providers de aanpassing hebben herkend. Onder bepaalde omstandigheden kan dit tot 24 uur duren.

Oplossing: Eerst moet je controleren of er een lokaal probleem is. Om dit te doen, moet je je DNS-cache wissen:

Om de DNS cache op je apparaat te wissen, open je eerst als volgt de opdrachtregel.

• Windows: Druk op [Win toets + R], cmd en klik op Enter
• Mac: Terminal starten vanaf het dock Programma's>Dienstrogramma's>Terminal

Dan voer je het volgende in:

• Windows: ipconfig /flushdns
• Mac: dscacheutil -flushcache

Daarna wordt je lokale DNS-cache gewist en kun je het opnieuw proberen. Als de fout blijft bestaan, controleer dan wat andere servers in de wereld erover zeggen. Ga hiervoor naar www.whatsmydns.net en voer de URL in de zoekregel in. Zorg ervoor dat A is geselecteerd in het tweede veld, zodat alleen het A-record wordt gecontroleerd. Deze is verantwoordelijk voor het juiste koppelen van de domeinnaam naar het IP-adres. Start dan de scan!

Als het DNS record voor alle servers up-to-date is, zou je een groen vinkje moeten zien en overal hetzelfde IP. In de meeste gevallen moet dit IP wijzen naar het IP van je server (uitzondering: als een CDN is gekoppeld).

Als er fouten worden weergegeven in de vorm van een rode X, heeft deze server nog niet de juiste invoer. Als er verschillende IP's zijn, heeft de server nog steeds de oude vermelding en is hij nog niet bijgewerkt naar de nieuwe. In dit geval is wachten het enige dat helpt.

Oorzaak 3: Serverzijdig probleem

Bezoekersintensieve websites en e-commerce websites zoals WooCommerce shops, genereren zeer veel verzoeken aan de server, die door hun inhoud niet in de cache kunnen worden opgeslagen en dus tot een hoge serverbelasting leiden – tot het instorten van de server toe.

Oplossing: Als de prestaties van je hostingpakket niet voldoende zijn voor je website, moet je misschien upgraden. Als alternatief helpt het vaak om over te schakelen naar een andere hoster wiens serverarchitectuur betere prestaties biedt. Je bent van harte welkom om een gratis testverhuizing uit te voeren met je WordPress website naar Raidboxes. Dit zal de werking van je live website niet verstoren, aangezien je een volledig gescheiden omgeving krijgt met een eigen URL, die niet geïndexeerd zal worden door zoekmachines. In meer dan 80 procent van de gevallen is er een aanzienlijke verbetering van de prestaties en een vermindering van de 504 fouten naar 0.

Oorzaak 4: Spamverkeer, DDoS-aanvallen, botaanvallen

DDoS-aanvallen en SPAM-verkeer kunnen je website laten crashen door zoveel (ongecachede) hits te genereren dat je server niet standhoudt.

Oplossing: Om dergelijke aanvallen te filteren, helpt het vaak om een CDN zoals Cloudflare te gebruiken, dat de toegang tot je website filtert en spambots en aanvallen blokkeert. In zeer hardnekkige gevallen kun je de IP-adressen van de aanvallers de toegang tot je website ontzeggen (blokkeren).

Bij Raidboxes kun je dit gemakkelijk doen via je Box-instellingen:

Oorzaak 5: Problemen met plugins en themes

In sommige gevallen kunnen zeer lange aanvragen van plugins of thema's leiden tot 504 gateway time-out fouten. Als je net een thema of plugin hebt geüpdatet, probeer deze dan eerst te deactiveren.

Bij Raidboxes kun je dit doen via je plugin/thema instellingen van je Box – zelfs als je niet meer in je WordPress backend kunt komen.

Als je geen toegang hebt tot je WordPress backend bij andere hosts, kun je verbinding maken via S/FTP en zoeken naar het overeenkomstige thema of plugin in de map ../wp-content/themes of ../wp-content/plugins en de map hernoemen. Dit zal automatisch het corresponderende element deactiveren.

Als je niet zeker weet welke plugin of welk theme het probleem veroorzaakt, schakel dan eerst over op een standaard thema zoals Twenty Twenty-Two.

Als dit het probleem oplost, ligt het waarschijnlijk aan het thema of een verbinding tussen het thema en de plugins. Neem contact op met de fabrikant van het theme. Zo niet, deactiveer dan alle plugins en reactiveer ze geleidelijk tot je de plugin in kwestie hebt geëlimineerd. Probeer dan deze plugin opnieuw te installeren. Als ook dit niet helpt, neem dan contact op met de fabrikant van de plugin.

WordPress Fout #4: Error Establishing a Database Connection

De Establishing a Database Connection Error is een bekende WordPress fout. De foutmelding betekent dat je server geen toegang meer hebt tot de database of deze niet meer kan bereiken.

Bijna alle informatie die je website nodig heeft om correct te draaien, is opgeslagen in je WordPress database. Niet alleen de inhoud van je pagina's en berichten, maar ook inloggegevens en plugin- en theme-instellingen worden in de database opgeslagen.

Alleen afbeeldingen, plugin bestanden, thema bestanden en WordPress core bestanden worden niet opgeslagen in de database, maar in het bestandssysteem van je website, die je kunt benaderen via bijvoorbeeld S/FTP.

Mogelijke oorzaken en oplossingen voor Error Establishing a Database Connection

Als je webpagina wit blijft en alleen de foutmelding "Error Establishing a Database Connection" verschijnt, kan je pagina geen verbinding met je database tot stand brengen of ontbreekt de nodige informatie of is deze onjuist. In de meeste gevallen kun je niet meer inloggen op de WordPress backend.

Oorzaak 1: Onjuiste gegevens in de WP Config

Meestal is het gewoon onjuiste database connectie informatie die de fout veroorzaakt. Deze fout treedt vaak op na een verhuizing naar een nieuwe server of hoster en is vrij eenvoudig te verhelpen:

Oplossing: Voor alle systeemrelevante fouten (en deze in het bijzonder!) moet je van tevoren een back-up van je website maken. Met Raidboxes maak je gewoon een handmatige back-up in je Box back-ups. Bij andere hosters kan het zijn dat je een back-up moet maken van de hele website of in ieder geval van de bestanden die je lokaal wijzigt.

Haal nu de informatie op die nodig is om verbinding te maken met de database. Deze zijn:

• Databasenaam (DB_NAME)
• MySQL gebruikersnaam (DB_USER)
• MySQL wachtwoord (DB_PASSWORD)
• MySQL Hostname (DB_HOST) [Dat is de server].
• Table Prefix ($table_prefix) [meestal 'wp_']

In de regel kun je deze informatie vinden in de Dashboard van je hoster. In de meeste gevallen is niet alle informatie nodig. Bij Raidboxes bijvoorbeeld, heb je alleen de Table Prefix nodig, aangezien de overige vermeldingen automatisch worden uitgelezen en gecontroleerd.

Als je over de nodige informatie beschikt, download dan wp-config.php van de root directory van je WordPress installatie via S/FTP, maak er lokaal een kopie van als back-up en bewerk het origineel met een editor zoals Notepad++.

Daar vind je de volgende regels (let op: $table_prefix wordt niet in alle gevallen opgenomen):

Vergelijk deze informatie met de informatie die je zojuist hebt verkregen. Sla deze wijzigingen op en upload het bestand naar de hoofddirectory van je server (overschrijf het originele bestand, je hebt een lokale back-up). Als de informatie nu correct is, zou je je website weer normaal moeten kunnen gebruiken.

Oorzaak 2: Onjuiste database

Er kan een fout in je database zijn geslopen.

Oplossing: WordPress kan de database mogelijk automatisch repareren. Om dit te doen, ga naar yourdomain.com/wp-admin. Als je ziet dat je database gerepareerd kan worden, voeg dan direct voor “/* That’s all, stop editing! Happy blogging. */ de volgende regel toe aan de WP Config:

define(‘WP_ALLOW_REPAIR’,true);

Ga dan naar je website.com/wp-admin/maint/repair.php.

Als dit je problemen heeft opgelost, vergeet dan niet om de regel weer uit de wp-config.php te verwijderen.

Oorzaak 3: Problemen met je hoster

Onder bepaalde omstandigheden, is de SQL server down en niet toegankelijk. Het is ook mogelijk dat een maximale databasegrootte is bereikt. Of de middelen van je web hoster zijn opgebruikt.

Helaas gebeurt dit vaak bij Shared hosting. Omdat je daar een server deelt met vele andere websites. Als een website veel bronnen verbruikt, gaat dat natuurlijk ten koste van je website. Daarom raden wij altijd high performance hosting aan, speciaal aangepast aan WordPress, zodat dergelijke overbelastingen zich niet voordoen.

Oplossing: Neem contact op met je webhost of controleer hun statuspagina (indien beschikbaar) om te zien of er op dit moment problemen zijn met de server. Laat de hoster je indien nodig de CPU-belasting tonen en schakel over naar een andere server als de belasting te hoog is. Als dit geen verbetering brengt, moet je overwegen over te stappen naar een andere hoster.

Conclusie

Je kent ongetwijfeld het gevoel van paniek wanneer je plots voor een wit scherm zit of niet meer kunt inloggen in de WordPress backend. Belangrijk is dan om je hoofd koel te houden, systematisch tot de bodem uit te zoeken wat de oorzaak is en vervolgens de nodige stappen te ondernemen om het probleem op te lossen. Ik hoop dat dit artikel je zal helpen om deze typische WordPress fouten in de toekomst te analyseren en op te lossen.

Met welk WordPress probleem heb je het meest te maken gehad? Voel je vrij om je feedback achter te laten in de commentaren.