Zubehörsperre — Nur mit Hauptprodukt kaufbar

Über die Erweiterung

Zubehör nur mit Hauptprodukt kaufbar

Verkaufen Sie Produkte, die nur zusammen mit einem bestimmten Hauptprodukt sinnvoll sind? Proprietäre Akkus, Ersatzteile, Erweiterungsmodule oder konfektioniertes Zubehör — all diese Artikel sollten nicht allein in den Warenkorb gelegt werden können. Accessory Lock schließt diese Lücke: Kunden können Zubehörprodukte erst kaufen, wenn das zugehörige Hauptprodukt im Warenkorb liegt.

Die wichtigsten Vorteile

• Warenkorb-Schutz ohne JavaScript-Abhängigkeit — Die Validierung läuft serverseitig und kann nicht durch Deaktivieren von JavaScript umgangen werden.
• Verständliche Fehlermeldung — Kunden erhalten eine klare Meldung mit dem Namen des fehlenden Hauptprodukts.
• Storefront-Unterstützung — Ein Buy-Together-Widget auf der Zubehör-Detailseite führt Kunden direkt zur richtigen Kombination.
• Einmalige Konfiguration dank Variantenvererbung — Weisen Sie die Sperre dem Elternprodukt zu — alle Varianten erben sie automatisch.

Funktionen im Detail

Serverseitige Warenkorb-Validierung

Über Shopwares CartValidatorInterface wird bei jeder Warenkorb-Aktualisierung geprüft, ob alle Zubehörprodukte ein gültiges Hauptprodukt im Warenkorb haben. Fehlt das Hauptprodukt, wird das Zubehör gesperrt und eine mehrsprachige Fehlermeldung angezeigt, die Zubehör- und Hauptprodukt namentlich nennt.

Die n:n-Beziehung erlaubt es, einem Zubehörprodukt mehrere erlaubte Hauptprodukte zuzuordnen — es genügt, wenn eines davon im Warenkorb liegt.

Storefront: Buy-Together-Widget auf der Zubehör-Seite

Auf der Detailseite eines Zubehörprodukts erscheint automatisch ein Widget, das alle kompatiblen Hauptprodukte als auswählbare Optionen auflistet. Kunden können direkt wählen, welches Hauptprodukt sie zusammen mit dem Zubehör kaufen möchten — und beide Artikel mit einem Klick in den Warenkorb legen.

Liegt das Hauptprodukt bereits im Warenkorb, zeigt das Widget einen angepassten Status — Kunden sehen sofort, dass ihre Kombination vollständig ist, und können das Zubehör direkt einzeln kaufen.

Storefront: Abschnitt „Kompatibles Zubehör" auf der Hauptprodukt-Seite

Auf der Detailseite des Hauptprodukts erscheint automatisch ein Abschnitt mit einem Produkt-Slider aller kompatiblen Zubehörartikel. Jede Kachel enthält einen „Zusammen in den Warenkorb"-Button, der Haupt- und Zubehörprodukt gleichzeitig hinzufügt. Der Abschnitt kann über die Plugin-Konfiguration deaktiviert werden, ohne die Warenkorb-Validierung zu beeinflussen.

Admin-UI: Zubehörsperre direkt am Produkt konfigurieren

Jede Produktdetailseite im Admin erhält einen eigenen Tab „Accessory Lock". Dort weisen Sie dem aktuellen Produkt beliebig viele erforderliche Hauptprodukte zu. Über eine Rückwärtsansicht sehen Sie gleichzeitig, welche anderen Produkte dieses Produkt als ihr Hauptprodukt erfordern — für einen vollständigen Überblick über beide Seiten der Beziehung.

Variantenvererbung

Die Zubehörsperre wird über den nativen Shopware-DAL-Vererbungsmechanismus an Produktvarianten weitergegeben. Konfigurieren Sie die Sperre einmalig am Elternprodukt — alle Varianten sind automatisch abgesichert. Einzelne Varianten können im Admin-Tab individuell überschrieben werden, wenn eine Variante ein anderes Hauptprodukt erfordert als ihre Geschwistervarianten.

Technische Details

• Shopware-Kompatibilität: ~6.6.0
• PHP 8.2+
• Keine externen Dienste oder API-Aufrufe erforderlich
• Vollständig PHPStan Level 8 geprüft
• Storefront und Administration vollständig mehrsprachig (Deutsch + Englisch)
• Alle Storefront-Texte (Hinweise, Buttons, Fehlermeldungen) sind Shopware-Textbausteine — anpassbar über Einstellungen → Snippets, z. B. wenn Sie den Begriff „Zubehör" durch eine eigene Bezeichnung ersetzen möchten