Hyvä compatibele extensies: welke werken, welke niet

Hyvä compatibele extensies: welke werken, welke niet

Niet elke Magento-extensie werkt op Hyvä. Dat is het eerste dat je moet weten voordat je een Hyvä-migratie plant.

Magento-extensies die frontend-code bevatten — en dat zijn er veel — zijn gebouwd voor de Luma-stack: RequireJS, Knockout.js, jQuery. Hyvä gebruikt Alpine.js en Tailwind. Die twee stacks zijn niet uitwisselbaar.

Dit artikel geeft een praktisch overzicht van compatibiliteitsniveaus, veelgebruikte extensies per categorie en de opties als een extensie niet compatibel is.

Wat je leert in dit artikel

• De drie niveaus van Hyvä-compatibiliteit uitgelegd
• Overzichten per extensiecategorie: betaal, zoek, SEO, reviews, marketing, checkout
• Hoe je compatibiliteit zelf controleert
• Wat je doet als een extensie niet compatibel is

De drie niveaus van compatibiliteit

Niet elke extensie is gelijk niet-compatibel. Er zijn gradaties.

Niveau 1: volledig compatibel

De extensie heeft geen eigen frontend-templates of gebruikt uitsluitend backend-logica die Hyvä al aanstuurt via standaard Magento-mechanismen. Betaalmodules die alleen via API communiceren, vallen hier soms onder. Extensies die alleen admin-functionaliteit toevoegen zijn altijd compatibel.

Wat je doet: niets extra. Installeren, werkt.

Niveau 2: compatibel mét aparte Hyvä-module

De extensie heeft frontend-templates gebouwd op Luma. De vendor heeft erkend dat Hyvä bestaansrecht heeft en een apart compatibiliteitspakket uitgebracht. Dat pakket vervangt de Luma-templates door Hyvä-equivalenten.

Wat je doet: de Hyvä-compatibiliteitspakket van de vendor installeren naast de extensie zelf. Controleer welke versie van de compatibiliteitspakket bij welke versie van de extensie hoort.

Niveau 3: niet compatibel, oplossing vereist

De extensie heeft Luma-frontend-code en de vendor heeft geen Hyvä-ondersteuning uitgebracht. Of de compatibiliteitspakket is verouderd en werkt niet met de huidige extensieversie.

Wat je doet: drie opties.

1. De frontend-templates zelf herschrijven in Hyvä/Alpine.js-stijl (herbouw)
2. De extensie vervangen door een Hyvä-native alternatief
3. De functionaliteit heroverwegen: is deze extensie echt nodig?

Betaalmodules

Betaalmodules zijn kritisch. Een niet-werkende betaalmodule blokkeert de gehele checkout.

Let op Hyvä Checkout: als je Hyvä Checkout gebruikt naast de standaard Magento-checkout, vereist elke betaalmodule een extra Hyvä Checkout-compatibiliteitspakket. Dat is een aparte laag bovenop de standaard Hyvä-compatibiliteit.

Zoekmodules

Zoekfunctionaliteit bevat doorgaans zware frontend-widgets. Dit is een van de risicovollere categorieën.

Aandachtspunt: autocomplete-dropdowns en instantzoekopdrachten zijn de meest complexe onderdelen van zoekmodules. Test deze functionaliteit expliciet op Hyvä, ook als de basiscompatibiliteit aanwezig is.

SEO-extensies

SEO-extensies werken grotendeels op backend-niveau. Ze injecteren meta-tags, schema-markup en canonical URLs via PHP-templates. Dat maakt ze relatief veilig op Hyvä.

Aandachtspunt: rich snippets en structured data worden soms via JavaScript geïnjecteerd. Controleer of die injectie ook werkt zonder Knockout.js.

Reviewplatforms

Reviews worden op productpagina's getoond. De weergave-templates zijn Luma-specifiek.

Alternatief overwegen: als je reviewplatform geen Hyvä-support biedt, overweeg dan een widget-gebaseerde integratie (TrustBox, Google Reviews-script) die los van de Magento-template-laag werkt. Dat is minder diep geïntegreerd maar eenvoudiger te onderhouden.

Marketingtools

Marketingtools injecteren JavaScript en soms frontend-elementen zoals pop-ups, banners en product-aanbevelingen.

Kritisch punt: GTM en marketing-events werken op trigger-basis. De events die in Luma werden gefired (add-to-cart, purchase, product view) zijn gebonden aan Knockout.js-logica. Op Hyvä moeten die events opnieuw worden geïmplementeerd via Alpine.js of native browser-events. Dit is een apart testtraject waard.

Checkout-uitbreidingen

De checkout is de meest Knockout.js-afhankelijke component in Magento. Extensies die de checkout aanpassen zijn bijna altijd Niveau 3 zonder extra werk.

Aanbeveling: als je Hyvä implementeert, gebruik dan Hyvä Checkout. Derde-partij one-step-checkout-extensies zijn gebouwd voor Luma. Ze blokkeren de volledige checkout-flow op Hyvä.

Overige extensies

Hoe controleer je compatibiliteit zelf

Stap 1: inventariseer alle geïnstalleerde extensies

Loop door je composer.json en noteer alle derde-partij modules. Maak een spreadsheet met kolommen: extensienaam, vendor, versie, bevat frontend-code (ja/nee), Hyvä-status.

Stap 2: controleer de officiële Hyvä-compatibiliteitslijst

Hyvä publiceert een merchant listing van compatibele extensies. Zoek elke extensie op. Let op: de lijst is niet altijd volledig of actueel.

Stap 3: controleer GitHub-repositories van vendors

Zoek op de GitHub-pagina van de extensie-vendor naar termen als "hyva", "hyvathemes" of "alpine". Veel vendors publiceren hun compatibiliteitspakket als apart repository.

Stap 4: controleer Packagist en de vendor-documentatie

Zoek op packagist.org naar [vendornaam]/module-[extensienaam]-hyva of vergelijkbare naamgeving.

Stap 5: stel vragen aan de vendor

Als je niets vindt: stuur de vendor een directe vraag. "Heeft u een Hyvä-compatibiliteitspakket? Is er ondersteuning gepland?" Het antwoord — inclusief de snelheid ervan — is een goede indicator van de vendor-kwaliteit.

Wat je doet als een extensie niet compatibel is

Optie 1: herbouw de frontend-templates

De PHP-businesslogica van de extensie blijft intact. Je herschrijft alleen de .phtml-templates en eventuele JavaScript van Knockout.js naar Alpine.js.

Dit is zinvol als:

• De extensie bedrijfskritisch is en geen equivalent heeft
• De vendor geen Hyvä-support plant maar de extensie goed onderhouden wordt
• De frontend-code beperkt van omvang is (< 20 templates)

Kosten: 8-40 uur per extensie, afhankelijk van complexiteit.

Optie 2: vervang de extensie

Zoek een Hyvä-native of Hyvä-compatibele alternatief die dezelfde functionaliteit biedt.

Dit is zinvol als:

• Er een goed alternatief bestaat
• De bestaande extensie sowieso verouderd of slecht onderhouden is
• De herbouwkosten hoger zijn dan de aanschafprijs van het alternatief

Optie 3: heroverwegen of functionaliteit wegvalt

Niet elke extensie is echt noodzakelijk. Vraag per niet-compatibele extensie: "Wat is de business-waarde van deze functionaliteit? Weegt die op tegen de herbouw- of vervangkosten?"

Soms is het antwoord: nee, we zetten dit niet mee over.

De koppeling met je Hyvä-migratie

De extensie-audit is de eerste fase van een Hyvä-migratie — niet een bijzaak. Een onvolledige audit is de meest voorkomende oorzaak van budgetoverschrijding bij Hyvä-projecten.

Doe de audit vóór je start met bouwen. Neem beslissingen over herbouwen, vervangen of laten vallen. Verwerk die beslissingen in de projectplanning en het budget.

Lees meer over het volledige migratieproces in ons artikel Hyvä installeren op een bestaande Magento 2 shop, of bekijk onze Magento-diensten voor wat wij in de praktijk doen.

Conclusie: de extensie-audit is de kritische eerste stap

Compatibiliteit is niet binair. Het spectrum loopt van "werkt direct" tot "vraagt complete herbouw". De meeste shops zitten ergens in het midden.

De sleutel: weet vóór je start wat je hebt, wat werkt, wat moet worden aangepast en wat het kost. Dan zijn er geen verrassingen.

Neem contact op als je wilt dat we de extensie-audit voor jouw Magento-installatie uitvoeren. We brengen de compatibiliteitsstatus van elke extensie in kaart en geven een eerlijke inschatting van het Hyvä-migratietraject.

Veelgestelde vragen

Hoe weet ik of een extensie Hyvä-compatibel is?

Controleer de officiële Hyvä-compatibiliteitslijst op hyva.io, de GitHub-repository van de vendor (zoek op "hyva" of "alpine") en de vendor-documentatie. Als je niets vindt: vraag de vendor direct.

Wat zijn de drie niveaus van Hyvä-compatibiliteit?

Niveau 1: volledig compatibel, werkt direct. Niveau 2: compatibel mét aparte Hyvä-module van de vendor. Niveau 3: niet compatibel, vereist herbouw van frontend-templates of vervanging door een alternatief.

Welke extensies zijn het meest problematisch op Hyvä?

Checkout-uitbreidingen (gebouwd op Knockout.js), complexe productconfigurators, en zoekmachines met eigen frontend-widgets. Dit zijn de categorieën met de hoogste herbouwkans.

Kan ik een niet-compatibele extensie toch gebruiken op Hyvä?

Ja, als je bereid bent de frontend-templates te herbouwen in Alpine.js-stijl. De backend-logica van de extensie blijft intact — alleen de weergavelaag verandert. Dat vereist Magento en Alpine.js-kennis.

Is er een alternatief voor extensies zonder Hyvä-support?

Ja. Hyvä-native extensies zijn een groeiende markt. Voor veel populaire functies bestaan inmiddels Hyvä-first alternatieven die zijn gebouwd voor Alpine.js en Tailwind. Vraag bij een bureau welke alternatieven er zijn voor jouw specifieke extensieset.