Checkout in Hyvä: Aufbau und die wichtigsten Anpassungspunkte
Checkout in Hyvä: Aufbau und die wichtigsten Anpassungspunkte
~8 Min. Lesezeit Zuletzt aktualisiert am 9. August 2026
Der Checkout ist der geschäftskritischste Teil jedes Shops - entsprechend vorsichtig sollte man bei Anpassungen sein. Dieses Kapitel zeigt, wie Hyvä den Checkout strukturiert und wo sich sichere Anpassungspunkte befinden.
Der Hyvä-Checkout im Überblick
Luma nutzt für den Checkout ein komplexes Knockout-basiertes JavaScript-Component-System mit dynamisch nachgeladenen Steps. Hyvä ersetzt das durch einen sehr viel einfacheren Aufbau: einzelne PHP/Alpine-Templates für Warenkorb-Übersicht, Adresse, Versandart, Zahlungsart und Bestellübersicht, die serverseitig sequenziell durchlaufen werden.
Zustand, der über mehrere Schritte lebt
Anders als bei der Team-Seite (Kapitel 17-22), wo der gesamte Zustand innerhalb einer einzigen Seite lebt, muss der Checkout Zustand über mehrere Server-Requests hinweg behalten (z. B. die gewählte Versandart, während man zur Zahlungsart weitergeht). Das passiert nicht über Alpine (das nur clientseitigen, seitenlokalen Zustand kennt), sondern über Magentos reguläre Session- und Quote-Mechanismen - genau wie in Luma.
Tipp: Faustregel: Alpine verwaltet innerhalb eines Checkout-Schritts die Interaktivität (z. B. ein aufklappbares "Gutschein einlösen"-Feld), während der Übergang zwischen Schritten weiterhin über normale Magento-Controller/Requests läuft.
Sichere Anpassungspunkte
- Layout-XML: einzelne Zahlungsmethoden-Templates per
referenceBlockein-/ausblenden. - Eigene Template-Overrides (Kapitel 10) für einzelne Abschnitte wie die Bestellübersicht.
- Zusätzliche Alpine-Interaktivität innerhalb eines Schritts, z. B. ein Live-Validierungshinweis bei der Adresseingabe.
Riskante Anpassungen
Achtung: Der Ablauf der Checkout-Schritte selbst, die Zahlungsabwicklung und die Order-Erstellung sollten nicht "mal eben" per Template-Override umgebaut werden - hier stecken sicherheitsrelevante Validierungen und Zahlungsanbieter-Integrationen, deren Verhalten leicht kaputtgeht, wenn Teile isoliert überschrieben werden, ohne den gesamten Datenfluss zu verstehen. Für tiefgreifende Checkout-Anpassungen lohnt sich ein Blick in die Hyvä-Checkout-Dokumentation, bevor man mit Overrides beginnt.
Was aus der Team-Seite übertragbar ist
Das Muster "ViewModel liefert Daten, Template zeigt sie mit Escaper an, Alpine übernimmt reine UI-Interaktivität" (Kapitel 17-22) gilt auch im Checkout - nur eben pro Schritt angewendet, nicht für den gesamten Checkout-Prozess auf einmal.