Het begint meestal met een e-mail van een klant: “de site ziet er raar uit” of “de checkout werkt niet meer”. Je kijkt in het dashboard en overal staat “update geslaagd”. En toch is de site kapot. Deze gids laat zien wat je in de eerste tien minuten doet, hoe je de site terugkrijgt zonder de bestellingen of formulierinzendingen van vandaag te verliezen, en hoe je zorgt dat de volgende update niet hetzelfde doet.
Is de site nu plat? Begin met de korte versie: een site herstellen die kapot ging na een WordPress-update, in 7 stappen.
De eerste tien minuten: zoek uit wat er echt kapot is
Weersta de neiging om meteen op “bijwerken” te klikken bij iets anders of de hele site terug te zetten. Stel eerst vast wat voor soort schade je ziet. Er zijn drie veelvoorkomende soorten, en elk heeft een andere oplossing.
- Wit scherm of een melding “kritieke fout”. PHP is gestopt. Meestal een plugin die niet samengaat met de PHP-versie of met een andere plugin. WordPress stuurt een e-mail naar het beheerdersadres met de naam van de plugin en het bestand dat faalde; kijk eerst in die inbox.
- De site laadt, maar iets ziet er verkeerd uit. Een menu dat op mobiel niet meer opent, een productoverzicht dat zijn kolommen kwijt is, een formulier dat als platte tekst verschijnt. Dit zijn opmaak- en JavaScript-problemen, meestal veroorzaakt door een update van een thema, paginabouwer of cacheplugin.
- De site ziet er goed uit, maar iets werkt niet meer. Formulieren die niet versturen, een checkout die vastloopt, inloggen dat mislukt. Vaak een plugin die veranderd heeft hoe hij instellingen opslaat, of twee plugins die botsende scripts laden.
Open de site in een privévenster op desktop en op een telefoon, en bekijk de vijf pagina’s die het belangrijkst zijn: de homepage, de pagina’s uit het hoofdmenu, het contactformulier, de winkel en checkout als die er is, en de inlogpagina. Schrijf op wat je ziet. Je hebt deze lijst weer nodig als je de oplossing controleert.
Stap 1: vind de update die het veroorzaakte
Ga naar Dashboard → Updates, of naar Plugins, en kijk welke plugins, thema’s of core-versies vandaag veranderd zijn. Liepen er meerdere updates tegelijk, dan zijn dit de waarschijnlijkste verdachten, in deze volgorde: de paginabouwer of het thema, WooCommerce en de uitbreidingen ervan, cache- en optimalisatieplugins, en beveiligingsplugins. Alles wat raakt aan hoe pagina’s worden opgebouwd of hoe scripts worden geladen, veroorzaakt eerder zichtbare schade dan een kleine hulpplugin.
Kun je nog bij het beheergedeelte, zet dan kort debugging aan om de echte fout te zien: voeg define('WP_DEBUG', true); en define('WP_DEBUG_LOG', true); toe aan wp-config.php, herlaad de kapotte pagina en lees wp-content/debug.log. De eerste regels van het log noemen meestal de plugin. Zet debugging daarna weer uit; het mag nooit aan blijven staan op een live site.
Stap 2: krijg de site terug, op de minst ingrijpende manier
Werk van de kleinste oplossing naar de grootste. Elke stap hieronder is minder precies en ingrijpender dan de vorige, dus stop zodra de site weer werkt.
- Leeg elke cache. Paginacache, objectcache, CDN-cache en de browser. Een verrassend aantal “kapotte” updates is gewoon oude CSS die met de nieuwe HTML wordt geserveerd. Is de site in orde na een harde verversing van een pagina die niet gecachet was, dan ben je klaar.
- Deactiveer de verdachte plugin. Kun je inloggen, deactiveer hem dan en controleer de vijf pagina’s opnieuw. Kun je niet inloggen, hernoem dan de map via SFTP of in het bestandsbeheer van je hosting (
wp-content/plugins/plugin-name→plugin-name-off); WordPress deactiveert hem bij het volgende laden van een pagina. - Draai die ene plugin terug naar de vorige versie. De meeste plugins op WordPress.org bewaren oudere versies onder “Geavanceerde weergave” op hun pluginpagina. Download de vorige versie, verwijder de kapotte, upload de oude en activeer opnieuw. Bij premium plugins heeft het klantaccount van de leverancier meestal oudere releases. Zo blijven alle inhoud en bestellingen van vandaag intact, omdat je alleen de bestanden van de plugin hebt aangeraakt.
- Zet pas daarna een back-up terug. Een volledige terugzetting zet de bestanden en de database terug naar het moment van de back-up. Alles wat de klant sindsdien deed, zoals bestellingen, formulierinzendingen en wijzigingen, gaat verloren tenzij je het met de hand terugzet. Controleer voor je terugzet wanneer de back-up gemaakt is en vraag de klant wat er sindsdien op de site gebeurd is. Zet zo mogelijk alleen de bestanden terug en houd de huidige database; veel back-uptools kunnen dat.
Loop na elke stap je lijst van vijf pagina’s opnieuw door op desktop en mobiel. “De homepage laadt” is niet hetzelfde als “de site werkt”.
Stap 3: vertel het de klant voordat die het jou vertelt
Stuur een kort bericht zodra de site terug is: wat er kapot was, hoe lang, wat je gedaan hebt, en wat je doet om het te voorkomen. Klanten vergeven een kapotte update; ze vergeven niet dat ze het van een klant moeten horen. Een bericht van twee regels is genoeg. Houd de technische details voor je eigen notities.
Stap 4: zorg dat het niet nog eens gebeurt
Elke kapotte update in deze gids heeft dezelfde oorzaak: de update liep op de live site, en de eerste controle gebeurde pas toen hij al live was. De oplossing is de volgorde veranderen, niet stoppen met updaten. Een routine die werkt voor bureaus met veel klantsites:
- Houd elke nacht een verse back-up. Bestanden en database. Een back-up waarvan je echt kunt terugzetten, wat betekent dat je minstens één keer een terugzetting hebt getest.
- Draai de update eerst op een kopie van de site. Niet op de live site. Heeft je hosting geen stagingfunctie, dan werkt voor de meeste sites een kopie in een submap op dezelfde server; zie onze gids over WordPress-updates testen voordat ze live gaan.
- Vergelijk de belangrijke pagina’s, op desktop en mobiel, voor en na. De meeste schade is visueel en geeft geen foutmelding. Schermafbeeldingen voor en na vangen het op; onze gids over visuele regressietests voor WordPress legt uit hoe.
- Werk de live site pas bij als de kopie geslaagd is, en controleer hem nog één keer. De volledige routine, inclusief wat je na de update doet, staat in onze WordPress-updatechecklist voor bureaus.
- Werk bij in kleine porties. Eén update van een paginabouwer op zichzelf vertelt je meer dan twaalf updates tegelijk. Gaat er iets stuk, dan weet je wat het veroorzaakte.
Veelgestelde vragen
Kan ik een WordPress-plugin-update ongedaan maken?
Ja. WordPress zelf heeft geen knop om iets ongedaan te maken, maar je kunt de vorige versie van de plugin met de hand installeren (oudere versies staan op de WordPress.org-pagina van de plugin onder “Geavanceerde weergave”, of in het klantaccount van de leverancier voor premium plugins), of een tool gebruiken om plugins terug te draaien. Deactiveer of verwijder eerst de huidige versie en upload daarna de oudere. Je instellingen blijven normaal gesproken in de database staan.
Verlies ik de recente bestellingen van mijn klant als ik een back-up terugzet?
Een volledige terugzetting zet de database terug naar het moment van de back-up, dus bestellingen, inzendingen of wijzigingen van na dat moment zijn weg, tenzij je ze met de hand terugzet. Daarom is één plugin terugdraaien de betere eerste stap, en is een terugzetting pas het laatste redmiddel. Moet je terugzetten, zet dan alleen de bestanden terug en houd de huidige database als je back-uptool dat toestaat.
Het dashboard zei “update geslaagd”, dus waarom is de site kapot?
“Geslaagd” betekent alleen dat de nieuwe bestanden op hun plek zijn gezet. WordPress controleert niet of de opmaak, de formulieren of de checkout daarna nog werken. Die controle moet op de site zelf gebeuren, pagina voor pagina, op desktop en mobiel. Dat op een kopie doen vóór de live update, is wat de e-mail van de klant in de eerste plaats voorkomt.
Hoe voorkom ik dat WordPress plugins automatisch bijwerkt?
Op het scherm Plugins heeft elke plugin een link “Automatische updates inschakelen/uitschakelen”. Automatische updates uitzetten voor paginabouwers, WooCommerce en themagerelateerde plugins is redelijk; laat ze aan voor kleine beveiligingsplugins als je niet vaak bijwerkt. Nog beter is een routine waarin elke update, automatisch of niet, eerst op een kopie getest wordt.
Wil je dat de update getest wordt voordat hij iets kan breken?
Elke update wordt gecontroleerd, en de riskante worden eerst op een kopie van de site getest: Verploy vergelijkt belangrijke pagina’s op desktop en mobiel en gaat pas live als er niets afwijkt. Gaat er na het livegaan iets stuk, dan draait het vanzelf terug. Gratis starten, geen creditcard.