> For the complete documentation index, see [llms.txt](https://docs.momocode.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.momocode.de/shopware-6/zubehoersperre/1.-beschreibung.md).

# 1. Beschreibung

Die **Zubehörsperre** verhindert, dass Kunden Zubehörprodukte kaufen können, ohne das zugehörige Hauptprodukt im Warenkorb zu haben. Die Validierung erfolgt serverseitig und kann nicht durch JavaScript oder Browser-Manipulation umgangen werden.

## Was das Plugin leistet

Manche Produkte sind nur sinnvoll, wenn das passende Hauptprodukt ebenfalls vorhanden ist — zum Beispiel ein Kameragurt ohne Kamera oder ein Ladekabel ohne das passende Gerät. Das Plugin ermöglicht es, solche Abhängigkeiten direkt im Admin zu konfigurieren und automatisch im Warenkorb zu erzwingen.

**Hauptfunktionen:**

* **Warenkorb-Validierung:** Zubehör kann nicht zur Bestellung abgeschlossen werden, solange kein passendes Hauptprodukt im Warenkorb liegt. Die Fehlermeldung nennt das fehlende Produkt namentlich.
* **Admin-UI:** Jede Produktdetailseite erhält einen eigenen Tab „Accessory Lock", in dem Sie die Abhängigkeiten komfortabel zuweisen und einsehen können.
* **Storefront-Hinweise:** Kunden werden auf Zubehörproduktseiten durch ein „Zusammen kaufen"-Widget geführt. Auf Hauptproduktseiten erscheint automatisch ein Abschnitt mit kompatiblem Zubehör.
* **Variantenvererbung:** Konfigurieren Sie die Sperre einmalig am Elternprodukt — alle Varianten erben die Einstellung automatisch.
* **n:n-Beziehungen:** Ein Zubehörprodukt kann mehrere Hauptprodukte akzeptieren (es genügt, wenn eines davon im Warenkorb ist).

## Storefront-Ansichten

### Abschnitt „Kompatibles Zubehör" auf der Hauptproduktseite

Auf der Detailseite eines Hauptprodukts wird unterhalb der Produktbeschreibung automatisch ein Abschnitt mit allen kompatiblen Zubehörprodukten angezeigt. Kunden können Haupt- und Zubehörprodukt direkt mit einem Klick gemeinsam in den Warenkorb legen.

![Abschnitt „Kompatibles Zubehör" auf der Hauptproduktseite](/files/EXvy3710yrjxEpECGpDx)

### „Zusammen kaufen"-Widget auf der Zubehörproduktseite

Auf der Detailseite eines Zubehörprodukts ersetzt ein Widget den Standard-Kaufbereich. Es listet alle kompatiblen Hauptprodukte als Auswahlmöglichkeiten auf. Sobald ein Hauptprodukt bereits im Warenkorb liegt, wechselt das Widget in eine angepasste Ansicht und zeigt den normalen Kaufen-Button.

![„Zusammen kaufen"-Widget auf der Zubehörproduktseite](/files/qTMaTP4rycu50BeN7Wi6)

## Technische Details

* Kompatibel mit **Shopware \~6.6.0** (Plugin 1.x) und **Shopware \~6.7.0** (Plugin 2.x)
* Erfordert **PHP 8.2+**
* Keine externen Dienste oder API-Verbindungen
* Serverseitige Validierung über `CartValidatorInterface`
* Variantenvererbung über den nativen Shopware-DAL-Mechanismus