# 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](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-5490060177be9f1346086b298fc6af7771c5c269%2F4.png?alt=media)

### „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](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-f08ce203a5c3c690e0bbbc6234902b0d68e534a8%2F5.png?alt=media)

## 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