Je klikt op Alles bijwerken, of je krijgt ’s ochtends een mail dat er automatisch iets is bijgewerkt, en nu zie je een foutmelding of een lege pagina. Werkt je site niet meer na een update, schakel dan via FTP of het hostingpaneel de laatst bijgewerkte plugin of het thema uit door de map te hernoemen. Lukt dat niet, zet dan de back-up van voor de update terug. Je site is bijna nooit echt weg, want je content staat nog in de database. Hieronder lees je wat ik doe als een WordPress-update mislukt is, van licht naar zwaar. Het artikel hoort bij WordPress-beheer: de complete gids.
Wat zie je na de update?
Een update breekt je site meestal omdat een nieuwe versie van een plugin, thema, WordPress-core of PHP niet meer past bij de rest van je installatie. Wat je ziet, vertelt al veel over waar je die incompatibiliteit moet zoeken.
| Wat zie je | Betekent meestal | Lees verder |
|---|---|---|
| “Er heeft zich een kritieke fout voorgedaan op deze site” | PHP-fout in een plugin of thema | Er heeft zich een kritieke fout voorgedaan |
| Witte, lege pagina | Fatale fout zonder melding | white screen of death |
| “Tijdelijk niet beschikbaar wegens gepland onderhoud” | Update halverwege gestopt | vast in onderhoudsmodus |
| Plugin werkt half of de update stopt | Onvolledige update | Plugin opnieuw uploaden of wp plugin install pluginnaam --force |
| Site werkt, opmaak kapot | Cache of pagebuilder-CSS | Eerst cache legen |
| Checkout of formulier werkt niet | Plugin-conflict in één functie | WooCommerce updaten zonder dat je checkout breekt |
Welk symptoom het ook is, de herstelvolgorde hieronder blijft hetzelfde.
Stap 1: zoek uit welke update het was
De snelste manier om de veroorzaker te vinden, is kijken wat er als laatste is bijgewerkt. Het eerste wat ik check, is de mailbox van het beheerdersadres. WordPress stuurt bij een fatale fout een e-mail met als strekking “Je site heeft een technisch probleem”, en daarin staat vaak letterlijk welke plugin of welk thema de fout gaf. Kun je nog inloggen, kijk dan onder Plugins welke plugins recent een nieuwe versie kregen.
Geeft dat geen uitsluitsel, dan ga ik naar het foutlog. Op de meeste servers staat er een bestand error_log in de map waar de fout optreedt. In de foutregel zie je een pad als wp-content/plugins/pluginnaam/, en die mapnaam is je verdachte. Is er geen log, zet dan de debug-modus aan. Maak eerst een kopie van wp-config.php en zet de regels boven de commentaarregel waarin staat dat je moet stoppen met bewerken. Zet WP_DEBUG en WP_DEBUG_LOG op true en WP_DEBUG_DISPLAY op false, zodat je bezoekers de foutmeldingen niet te zien krijgen. De fouten komen dan in wp-content/debug.log. Zet het na afloop weer uit. Meer uitleg vind je bij debug-modus inschakelen.
Stap 2: schakel de plugin of het thema uit
Een plugin uitschakelen zonder toegang tot het beheer doe je door de map te hernoemen. Vergelijk het met een gesprongen stop. Je zet niet de stroom van het hele huis terug naar gisteren, je zoekt welk apparaat de kortsluiting gaf en trekt dat uit het stopcontact.
- Kun je nog inloggen, of heb je de link voor de herstelmodus uit de e-mail? Deactiveer de plugin dan gewoon via Plugins.
- Geen toegang? Open bestandsbeheer in je hostingpaneel of verbind via (S)FTP.
- Ga naar
wp-content/plugins/en hernoem de map van de verdachte plugin, bijvoorbeeld naarpluginnaam-uit. WordPress schakelt hem dan uit. - Weet je niet welke het is? Hernoem de hele map
plugins, zet hem terug en activeer de plugins één voor één. - Was het een thema-update? Hernoem de themamap, dan valt WordPress terug op een geïnstalleerd standaardthema zoals Twenty Twenty-Five.
- Leeg de cache, bijvoorbeeld in LiteSpeed Cache, en controleer de site.
Op de commandoregel doet wp plugin deactivate pluginnaam in WP-CLI hetzelfde. Laat altijd een standaardthema geïnstalleerd staan, anders heeft WordPress niets om op terug te vallen.
Stap 3: terugdraaien, eerst die ene update en pas dan een back-up
Uitschakelen is een noodmaatregel, want meestal wil je de functie terug. Grijp daarbij niet als eerste naar de back-up. Meestal is één plugin de boosdoener, en met een volledige back-up gooi je alles weg wat sindsdien gebeurd is.
Eén plugin of thema terugzetten
Voor plugins en thema’s uit de officiële WordPress-repository gebruik je WP Rollback. Een premium plugin download je als ZIP van de vorige versie en upload je via Plugins > Nieuwe plugin > Plugin uploaden, waarna je kiest voor vervangen. Soms heeft WordPress het al gedaan. Sinds versie 6.3 draait het een mislukte handmatige update van een plugin of thema zelf terug, en sinds 6.6 ook een automatische plugin-update die een fatale fout geeft. Ligt het aan PHP, wissel de versie dan tijdelijk in cPanel > Select PHP Version en lees PHP-versie updaten. WordPress-core zelf terugzetten is zelden nodig. Moet het toch, dan kan het met de plugin WP Downgrade of door de mappen wp-admin en wp-includes te vervangen, en alleen tijdelijk.
Een volledige back-up terugzetten
Een back-up terugzetten is de juiste keuze als je niet vindt wat er stuk is, als er meerdere dingen tegelijk kapot zijn of als de update je database aanpaste. Weet wel dat orders, formulierinzendingen, reacties en berichten van na het back-upmoment dan weg zijn. Bij een WooCommerce-webshop exporteer ik daarom eerst de nieuwe orders, of zet ik alleen de bestanden terug. Bij managed WordPress hosting doe je dit vanuit het hostingpaneel, maar de huidige staat wordt daarbij niet vanzelf bewaard, dus maak eerst zelf nog een back-up. Hoe het werkt, staat in back-up terugzetten. Voor kleine fouten in een pagina is er wijzigingen ongedaan maken.
Na het herstel: voorkom dat het opnieuw gebeurt
Een uitgeschakelde of teruggezette plugin is een tijdelijke oplossing, geen eindstation. Laat je hem zo staan, dan mis je beveiligingsupdates. Kijk in de changelog of het supportforum of het probleem bekend is en wacht op een fix. Test die nieuwe versie eerst op een staging-omgeving en zet in de tussentijd automatische updates aan of uit voor alleen die plugin. Wordt een plugin niet meer bijgewerkt, vervang hem dan door een alternatief. Hoe je dat kiest, lees je in de gids over plugins en thema’s. Daarnaast werk ik altijd één voor één bij in plaats van alles tegelijk, met vooraf een back-up. Hoe je die back-ups inricht, staat in de gids over back-up en migratie. Dan weet je meteen welke update het probleem geeft. Heb je een webshop, test dan na elke update de checkout, of laat dat over aan WooCommerce beheer.
Bij ons op de shared pakketten heb je alles in huis om dit zelf op te lossen. In cPanel zitten File Manager, SSH en WP-CLI, dus een pluginmap hernoem je zonder apart FTP-programma. Een back-up zet je kosteloos terug via JetBackup 5, los voor bestanden of databases, en een staging-omgeving maak je door je installatie te klonen in Installatron. Zit je op Surver Cloud, neem dan contact op met support. Wil je er liever niet zelf mee bezig zijn, dan herstelt Surver de site binnen WordPress beheer en voeren we voortaan maandelijks de updates voor je uit. Lees ook WordPress veilig updaten en de onderhoudschecklist.
Veelgestelde vragen
Ik krijg geen herstelmodus-e-mail, wat nu?
Kijk eerst in je spammap en controleer of het beheerdersadres onder Instellingen > Algemeen nog klopt. Kom je niet in het beheer, hernoem de pluginmap dan via bestandsbeheer of FTP zoals in stap 2.
Mijn site blijft hangen op “Tijdelijk niet beschikbaar wegens gepland onderhoud”. Wat doe ik?
Verwijder het bestand .maintenance in de hoofdmap van je WordPress-installatie. Dat bestand blijft achter als een update halverwege stopt. Andere meldingen die na een update opduiken, behandel ik in WordPress-fouten oplossen.
Kan Surver mijn site herstellen na een mislukte update?
Ja, dat doet Surver binnen het onderhoudsabonnement. Als hostingklant kun je ook zelf kosteloos een back-up terugzetten via JetBackup 5 in cPanel. Twijfel je, mail dan onze support.
