Hyvä-migratiechecklist: controleer eerst je extensies

Een migratie van Luma naar Hyvä verandert alleen de frontend. Je producten, klanten en bestellingen blijven waar ze zijn.

Daardoor klinkt het project eenvoudig, en in veel opzichten is het dat ook. Maar bijna elke Magento-webshop draait extensies die voor Luma zijn geschreven, en die extensies bepalen hoe soepel de overstap verloopt.

Dit is de checklist die we gebruiken voordat een Hyvä-project begint.

Waarom extensies eerst komen

Hyvä haalt de RequireJS-, KnockoutJS- en jQuery-stack van Luma weg. Elke extensie die eigen storefront-JavaScript of Knockout-templates meelevert, verwacht dat die stack bestaat.

Op Hyvä blijft het backendgedeelte van zo'n extensie werken. Het deel dat shoppers zien, zoals een widget, een pop-up of een checkoutstap, werkt pas weer als de frontend opnieuw is gebouwd.

Ontdek je dit halverwege een project, dan kost het tijd en brengt het risico met zich mee. Ontdek je het op dag één, dan wordt het gewoon onderdeel van het plan.

Stap 1: zet elke module op een rij

Begin met een volledige lijst. Vertrouw niet op je geheugen of op het menu in de beheeromgeving, want veel modules hebben helemaal geen adminscherm.

bin/magento module:status --enabled | grep -v '^Magento_'
composer show | grep -v '^magento/'

Het eerste commando toont de ingeschakelde modules die geen deel uitmaken van de Magento-core. Het tweede toont de Composer-packages, zodat je de leverancier en versie van elk ervan kunt vinden.

Controleer ook app/code op maatwerkmodules en oudere modules die zonder Composer zijn geïnstalleerd. Dat zijn vaak de modules die niemand zich meer herinnert.

Stap 2: zoek uit wat elke module op de storefront doet

Beantwoord voor elke module één vraag: verandert ze iets wat een shopper ziet of aanklikt?

• Modules die alleen in de backend werken, zoals ERP-koppelingen, orderexports, feeds of admintools, werken meestal zonder aanpassingen op Hyvä.
• Modules met storefront-templates, JavaScript of layoutwijzigingen verdienen een nadere blik.
• Modules die de checkout raken, verdienen de nauwkeurigste blik van allemaal.

Een snelle manier om storefront-code te herkennen is in elke module te zoeken naar een map view/frontend met web/js, requirejs-config.js of Knockout- .html templates.

Stap 3: deel elke module in drie groepen in

We delen elke extensie in een van drie groepen in en delen de volledige lijst met de eigenaar van de webshop.

Veel populaire leveranciers publiceren hun eigen Hyvä-compatibiliteitsmodules. Hyvä houdt ook een openbare tracker van compatibiliteitsmodules bij; een goede eerste plek om te kijken.

Voor de modules die in de middelste kolom belanden, legt ons artikel over extensies zonder Hyvä-compatibiliteitsmodule de opties uitgebreid uit.

Stap 4: controleer de risicocategorieën

In onze ervaring gaan sommige soorten modules vaker stuk dan andere. Geef ze extra tijd in de audit.

• Betaalmethoden. Veel betaalmodules renderen hun checkoutstap met Knockout. Sommige providers hebben helemaal geen Hyvä-klare versie.
• Tracking en tagmanagers. Veel modules sturen e-commerce-events via RequireJS door. Op Hyvä kunnen die events ongemerkt stoppen, waardoor GA4-rapporten stil worden zonder foutmelding.
• Sliders, galerijen en productconfigurators. Dit zijn vaak zware jQuery-widgets.
• Themaspecifieke page builder-elementen. Content die met de eigen elementen van je oude thema is gemaakt, kan na de overstap verdwijnen.
• Zoeken en gelaagde navigatie. Deze hebben vaak hun eigen frontendscripts.

Stap 5: kies de checkoutroute vroeg

In de checkout komen betaal-, verzend- en trackingmodules samen. Daar hoort een beslissing bij voordat het designwerk begint.

• Hyvä Checkout, gebouwd op Magewire, als je betaal- en verzendmethoden worden ondersteund of kunnen worden geïntegreerd.
• De checkout voorlopig op Luma houden met de fallback-aanpak van Hyvä, terwijl de rest van de webshop naar Hyvä overgaat.
• Een checkout-template, ontworpen rond jouw gemiddelde orderwaarde en markten.

Plan ook voor Content Security Policy. Sinds Magento 2.4.7 dwingen checkoutpagina's een strikte CSP af, dus elk inline script moet zijn toegestaan, anders kunnen betaalmethoden falen.

Ons artikel is Hyvä Checkout het waard? helpt je bij deze beslissing.

Stap 6: bescherm SEO en tracking

Een wijziging aan de frontend mag niet veranderen hoe Google of je analytics de webshop zien. Zet deze punten op de checklist:

1. Houd elke URL hetzelfde, ook de categorie- en product-URL's.
2. Vergelijk gerenderde titels, meta descriptions, canonical tags en hreflang tussen oude en nieuwe pagina's.
3. Vergelijk de structured data voor producten, breadcrumbs en organisatie.
4. Test de GA4-e-commerce-events van begin tot eind: view item, add to cart, begin checkout en purchase.
5. Houd Search Console na de livegang goed in de gaten.

Met onze SEO-checklist voor Magento behandelt de bredere SEO-kant.

Stap 7: maak van de lijst een plan

Zodra elke module is ingedeeld, heb je alles wat je nodig hebt voor een realistisch plan:

• Het aantal ports bepaalt de belangrijkste ontwikkelinspanning.
• De checkoutroute bepaalt het belangrijkste risico.
• De modules die je verwijdert, maken de webshop eenvoudiger en lichter.

Dit is ook het moment om naar de server te kijken. Hyvä maakt de frontend lichter, maar een trage server, een kapotte full-page cache of heel grote afbeeldingen blijven traag op elk thema.

Plan je tegelijk een Magento-upgrade, voer dan dezelfde extensie-audit uit voor de upgrade, zodat je elke module maar één keer hoeft te beoordelen.

Veelgestelde vragen

Hoeveel extensies is te veel voor Hyvä?

Er is geen vast aantal. Het gaat erom hoeveel extensies storefront-code hebben zonder compatibiliteitsmodule, en hoe complex die zijn.

Kunnen we naar Hyvä overstappen als één betaalmethode niet Hyvä-klaar is?

Ja. Je kunt de integratie laten bouwen, of de checkout voorlopig op Luma houden terwijl de rest van de webshop op Hyvä draait.

Wie moet de extensie-audit uitvoeren?

Een Magento-developer die zowel Luma als Hyvä kent. Voor de audit heb je iemand nodig die modulecode kan lezen, niet alleen de marketingpagina van de module.

We controleren elke extensie voordat we een offerte voor een Hyvä-migratie maken. Bekijk hoe het proces werkt op onze Hyvä-themaontwikkeling pagina, inclusief wat er stukgaat en hoe we dat aanpakken.