Hyvä installeren op Magento 2 en Mage-OS

Voordat je begint

Hyvä laadt geen RequireJS, Knockout of jQuery. Elke extensie die frontendcode op de Luma-manier toevoegt, werkt niet meer totdat ze is aangepast. De eerste taak is dus een inventarisatie, geen installatie.

• Maak een lijst van elke actieve module met een view/frontend -map.
• Controleer voor elke module of er een Hyvä-versie of een compatibiliteitsmodule bestaat.
• Markeer wat je zelf gaat aanpassen en wat je kunt uitschakelen.

Onze artikelen Hyvä-migratiechecklist en extensies zonder compatibiliteitsmodule gaan hier uitgebreid op in.

Vereisten

Installeren met Composer

Hyvä-pakketten komen uit de eigen Packagist-repository van Hyvä. Voeg je sleutel en de repository-URL uit je hyva.io-account toe en require daarna het thema:

composer config --auth http-basic.hyva-themes.repo.packagist.com token YOUR_KEY
composer config repositories.private-packagist composer https://hyva-themes.repo.packagist.com/YOUR_PROJECT/

composer require hyva-themes/magento2-default-theme
bin/magento setup:upgrade
bin/magento hyva:config:generate

hyva:config:generate vertelt de Tailwind-build waar de moduletemplates staan. Draai het opnieuw zodra je een Hyvä-compatibele module toevoegt of verwijdert.

Een child theme aanmaken

Bewerk nooit Hyva/default rechtstreeks; updates zouden je werk overschrijven. Maak een child theme aan:

app/design/frontend/Vendor/hyva/
  registration.php
  theme.xml              # <parent>Hyva/default</parent>
  web/tailwind/          # gekopieerd uit vendor/hyva-themes/magento2-default-theme/web/tailwind

cd app/design/frontend/Vendor/hyva/web/tailwind
npm ci
npm run build

Wijs het thema daarna toe in Content › Design › Configuration. Onze gids over child themes gaat dieper in op de structuur.

Instellingen na de overstap

• Zet JavaScript-bundling, -merging en -minificatie van Magento uit voor de Hyvä-store view; Hyvä gebruikt ze niet.
• Zet ook CSS-minificatie uit; de Tailwind-build is al geminificeerd.
• Draai in production mode en deploy statische content voor elke locale waarin je verkoopt.
• Controleer na elke deploy of pub/static/deployed_version.txt alleen het versienummer bevat, zonder afsluitende regeleinde. Een regeleinde breekt het themapad, en dan werken toevoegen aan winkelwagen, zoeken en de winkelwagenlade allemaal niet meer.

Wat je test vóór de livegang

• Toevoegen aan winkelwagen vanaf categoriepagina’s, productpagina’s en quick view.
• Inloggen, registreren, wachtwoord resetten, contact- en nieuwsbriefformulieren, met reCAPTCHA ingeschakeld zoals straks live. Formulieren die van Luma zijn overgenomen missen vaak de form_key.
• Checkout met elke betaalmethode, inclusief de terugkeer vanaf de betaalprovider.
• Analytics-events: paginaweergaven, add_to_cart, begin_checkout en purchase.
• Mobiele pagina’s met Lighthouse, zowel op een echte telefoon als in de browser.

Hyvä in Turkije en de rest van Europa

MageBooster is een Magento-team met kantoren in Tallinn (Estland) en Istanbul (Turkije). We werken met webshops in heel Europa en in Turkije, in het Engels, Duits en Turks. Je spreekt met de mensen die het werk doen: hetzelfde team plant, installeert en onderhoudt je webshop.

Zo verloopt een project

Het werk gebeurt op afstand met calls via schermdeling; je houdt bij elke stap volledige toegang tot je code en server. Onze werktijden zijn maandag tot en met vrijdag, 09:00 tot 18:00 uur (Istanbulse tijd).

MageBooster Checkout

Veel webshops verliezen de meeste klanten in de checkout. Naast installaties bouwen en installeren we MageBooster Checkout, onze eigen Hyvä-checkout. Die draait op Magento 2.4.9 en Mage-OS en komt in vier layouts voor internationale webshops, van één enkele pagina tot een begeleide flow in meerdere stappen.

• Adres, verzending en betaling op één scherm of in stappen, afhankelijk van de layout die je kiest.
• Betaalmethoden die in jouw land verwacht worden, inclusief betalen in termijnen voor webshops in Turkije.
• Gebouwd met Alpine.js en Tailwind CSS, net als de rest van Hyvä, zonder het JavaScript van de Luma-checkout.

Je kunt het uitproberen in onze demowebshop op demo.magebooster.com. Daar worden geen echte bestellingen geplaatst.

Hulp nodig?

We installeren Hyvä, passen extensies aan en onderhouden Hyvä-webshops in Turkije, Duitsland, het Verenigd Koninkrijk en de rest van Europa.