Er staat een oranje bolletje bij WooCommerce in uw beheer. Nieuwe versie beschikbaar. De vorige keer dat u op “Nu bijwerken” klikte, ging het goed. De keer daarvoor ook. Maar u heeft ook het verhaal gehoord van die collega-ondernemer bij wie na een update de knop “Bestelling plaatsen” niets meer deed, en die er pas na twee dagen achter kwam omdat de omzet opeens nul was.

WooCommerce updaten hoeft niet spannend te zijn, als u het in een vaste volgorde doet. In dit artikel staat die volgorde: acht stappen die ervoor zorgen dat een update die iets breekt, dat op een kopie doet en niet in uw winkel. Het kost per update ongeveer een half uur tot een uur. Dat lijkt veel voor één klik, tot u het afzet tegen een zaterdag zonder bestellingen.

Waarom de checkout zo kwetsbaar is

De afrekenpagina is de plek waar de meeste code samenkomt. WooCommerce zelf, uw thema, de betaalplugin, de verzendplugin, eventueel een plugin voor btw, kortingen, adresvalidatie of een klantenaccount. Al die onderdelen worden door verschillende partijen onderhouden, in hun eigen tempo. Een update van WooCommerce kan een functie wijzigen waar uw betaalplugin op leunt. Een update van uw thema kan de opmaak van de checkout overschrijven. Elk van die combinaties werkt meestal, maar niet altijd.

Bovendien geeft een kapotte checkout zelden een duidelijke foutmelding. De pagina laadt, de velden staan er, alleen gebeurt er niets wanneer de klant op de knop klikt. Of de betaalmethoden ontbreken. Of de verzendkosten blijven op nul staan. U ziet het niet aan de homepage, en uw monitoring ziet het ook niet, want de site is “online”.

Het stappenplan

Stap 1: lees wat er verandert

Bij elke WooCommerce-versie hoort een overzicht van wijzigingen (de changelog) en, bij grote versies, een aankondiging op de ontwikkelaarsblog. Let op wat daar staat over de checkout, betalingen, de orderopslag (HPOS) en vereiste PHP-versies. Staat er dat een onderdeel “verwijderd” of “gewijzigd” is, dan is dat het eerste wat u straks test.

Stap 2: controleer de compatibiliteit van uw plugins

In het pluginoverzicht van WordPress staat bij WooCommerce-gerelateerde plugins vaak een melding of ze getest zijn met de nieuwe versie. Ontbreekt die melding bij uw betaalplugin of verzendplugin, wacht dan een week. Ontwikkelaars van betaalplugins brengen doorgaans binnen enkele dagen na een grote WooCommerce-release een update uit.

Stap 3: maak een volledige back-up

Bestanden én database, en zet hem ergens buiten de server. Controleer dat de back-up compleet is; een back-up die niet terug te zetten is, is geen back-up. Noteer het tijdstip, want bij een terugzetting wilt u weten welke bestellingen u daarna handmatig moet terughalen.

Stap 4: werk eerst bij op een staging-omgeving

Een staging-omgeving is een kopie van uw shop op een apart adres, onzichtbaar voor klanten. Daar doet u de update. Heeft u die niet, dan bieden veel hostingpartijen er een met één klik. Is dat er ook niet, dan is dit het moment om erover na te denken; voor een webshop is het niet optioneel. Waarom, leggen we uit in ons artikel over de staging-omgeving.

Stap 5: werk bij in de juiste volgorde

Op staging: eerst WordPress zelf, dan WooCommerce, dan de betaal- en verzendplugins, dan de overige plugins, als laatste het thema. Eén voor één, en na elke stap even kijken of de site nog laadt. Werkt u alles tegelijk bij en breekt er iets, dan weet u niet welke update de oorzaak was.

Stap 6: plaats een testbestelling

Dit is de stap die het verschil maakt. Loop op staging de complete bestelflow door, alsof u een klant bent:

  • Product in de winkelwagen, aantal wijzigen, product verwijderen, opnieuw toevoegen.
  • Naar de afrekenpagina. Vul een adres in. Verschijnen de juiste verzendopties met de juiste kosten?
  • Kortingscode invoeren. Wordt het bedrag correct aangepast?
  • Elke betaalmethode aanklikken. Verschijnt bij iDEAL de bankkeuze? Bij Klarna of Riverty de aanvullende velden?
  • Bestelling afronden. Op staging staat de betaalprovider meestal in testmodus, zodat u geen echte betaling doet.
  • Controleer de bedankpagina, de orderbevestiging per e-mail en de bestelling in het beheer. Klopt de btw? Staat de order op de juiste status?

Doe dit ook op een telefoon. Een checkout die op een groot scherm werkt maar op mobiel een verborgen knop heeft, is in de praktijk kapot.

Stap 7: zet de update live op een rustig moment

Alles goed op staging? Dan herhaalt u de update op de live shop, in dezelfde volgorde. Kies een moment met weinig bestellingen, en niet vlak voor het weekend. Dinsdag- of woensdagochtend vroeg werkt in de praktijk goed. Zet de shop desnoods een kwartier in onderhoudsmodus, maar dat is bij een goed voorbereide update zelden nodig.

Stap 8: controleer opnieuw, nu live

Plaats een echte testbestelling voor een klein bedrag met iDEAL. Ja, dat kost een paar cent aan transactiekosten. Het is de enige manier om zeker te weten dat de betaling echt aankomt. Terugbetalen kan direct vanuit het beheer. Houd daarna het eerste uur de bestellingen in de gaten en kijk in het foutenlog.

Als het toch misgaat

Ondanks alle voorbereiding kan een update live iets breken dat op staging werkte, bijvoorbeeld door een verschil in cache of serverinstellingen. Dan geldt: eerst de cache legen (alle lagen: plugin, server, eventueel CDN). Helpt dat niet, dan de laatst bijgewerkte plugin terugzetten naar de vorige versie. Helpt dat niet, dan de back-up terugzetten, maar alleen de bestanden, niet de database, tenzij u zeker weet dat er geen bestellingen sinds de back-up zijn.

Wat u niet doet: in paniek plugins uitschakelen op de live shop. Elke uitgeschakelde betaal- of verzendplugin is een klant die niet kan afrekenen. Werk vanuit de back-up en de staging-omgeving, niet vanuit de live winkel.

Wat u zelf kunt doen en wanneer u hulp inschakelt

Dit stappenplan is voor de meeste ondernemers zelf uit te voeren, mits u een staging-omgeving heeft en een uur tijd. Doet u het maandelijks, dan wordt het routine. Schakel hulp in wanneer u meer dan een handvol koppelingen heeft, wanneer een grote WooCommerce-versie eraan komt met wijzigingen in de orderopslag of de checkout, of wanneer u simpelweg niet degene wilt zijn die op woensdagochtend de kassa test.

Bij onderhoud van een WooCommerce-webshop is dit stappenplan precies wat er elke maand gebeurt: staging, updates in volgorde, testbestelling, live, controle. Het spannende zit niet in de update zelf, maar in de vraag of iemand het heeft getest. Zolang het antwoord ja is, is een oranje bolletje bij WooCommerce gewoon een agendapunt. En mocht de afrekenpagina ondanks alles blijven hangen, dan helpt ons artikel over een checkout die blijft laden bij het vinden van de oorzaak.