Warenkorb- & Checkout-Attribute
Zeigt ausgewählte Produktattribute in Warenkorb, Checkout und Bestellübersicht - für die EU-Pflichtangabe wesentlicher Produkteigenschaften vor Vertragsabschluss. Mit Shop API, Admin-Konfiguration und Kill-Switch.
Warenkorb- & Checkout-Attribute
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Überblick
Sylius führt durch Warenkorb und Checkout standardmäßig nur Produktname, Variante, Menge und Preis mit - alles, was an Produktattribut-Werten auf der Produktseite steht, geht danach verloren. Für Shops unter deutschem/EU-Recht ist das ein Problem: Art. 246a EGBGB (Umsetzung der Verbraucherrechte-Richtlinie) verlangt, dass wesentliche Eigenschaften der Ware auf der Seite unmittelbar vor Vertragsabschluss sichtbar sind - nach der Rechtsprechung reicht ein Link zurück zur Produktseite dafür nicht aus.
Dieses Plugin lässt Admins pro Produktattribut festlegen, ob und wie es in Warenkorb, Checkout-Zusammenfassung und (abhängig vom Scope) Bestellbestätigung erneut angezeigt wird - ohne Core-Templates zu überschreiben.
Attribute wie Material, Maße oder Füllmenge erscheinen wieder in Warenkorb und Checkout, nicht nur auf der Produktseite.
graph LR
A["Warenkorb / Checkout / Bestelluebersicht (Twig Hook)"] --> C["Twig-Funktionen"]
B["Shop API Request"] --> D["State Provider"]
C --> E["Kill-Switch + Anzeige-Konfiguration"]
D --> E
E --> F["Attribut-Partial (SyliusAttribute Types)"]
E --> G["JSON Response"]
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Composer über Packeton, Bundle/Routen, Setup-Befehl, Update, Deinstallation |
| Konfiguration | Admin-Formular-Erweiterung, Kill-Switch, Praxisbeispiele |
| Storefront | Twig Hooks in Warenkorb, Checkout und Bestellübersicht |
| Shop API | Endpunkte, Felder, Filter, Fehlerverhalten |
| Erweiterbarkeit | Repository-Interface, eigene Hook-Punkte, Admin-Menü-Konvention |
| Fehlerbehebung | Symptome → Prüfung → Lösung, Einschränkungen, FAQ |
| Technik | Architektur, Entities, Migrationen, Enum |
Features
| Feature | Beschreibung |
|---|---|
| Drei-Stufen-Checkout-Sichtbarkeit | Pro Attribut: Nicht sichtbar / Sichtbar / Pflicht |
| Separate Warenkorb-Sichtbarkeit | Eigenes Flag, unabhängig von der Checkout-Einstellung |
| Admin-Integration ohne neue CRUD-Seite | Eigene Karte direkt im bestehenden Produktattribut-Formular |
| Wiederverwendung der Attribut-Partials | Checkbox-, Datums-, Prozent- und Auswahlwerte rendern wie auf der Produktseite |
| Bestellbestätigung & Konto-Bestellhistorie | Dieselbe Tabelle wird an beiden Stellen wiederverwendet |
| Shop API | Zwei Nur-Lese-Endpunkte für Einstellungen und Anzeige-Konfiguration |
| Shop-weiter Kill-Switch | Eine Einstellung schaltet die gesamte Anzeige sofort ab |
| Setup-Befehl | Führt nur die eigenen Migrationen aus, prüft den Routen-Import, idempotent |
Anforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| Sylius | ^2.2 | |
| PHP | ^8.3 | |
| Symfony (console/finder/routing) | ^7.4 | |
| API Platform (doctrine-orm/metadata/state) | ^4.2.1 oder ^5.0 | |
| doctrine/migrations | ^3.7 | |
| Datenbank | MySQL/MariaDB Pflicht | Migrationen sind MySQL-DDL - PostgreSQL wird nicht unterstützt |
PostgreSQL wird nicht unterstützt: Die Migrationen überspringen sich selbst auf jeder Datenbank außer MySQL/MariaDB, das Feature bleibt dort dauerhaft inaktiv.
Lizenz
Kommerzielle Lizenz: eine Sylius-Installation (alle Channels, inklusive Entwicklungs- und Staging-Umgebungen) pro Lizenz, keine Weitergabe, Updates für 12 Monate ab Kauf.
Support
E-Mail: support@markus-michalski.net