# 1. Beschreibung

Das Plugin **Erweiterte Wunschlisten** ersetzt die native Shopware-Wunschliste durch eine vollwertige Wunschlisten-Lösung: Ihre Kunden können mehrere benannte Wunschlisten anlegen, öffentlich per Link teilen, Produkte direkt aus der Liste in den Warenkorb legen und sich bei Preissenkungen benachrichtigen lassen.

![Admin-Übersicht aller Kundenwunschlisten](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-870fb8aa31c885c24d9624a326d30944b1b86629%2F4.png?alt=media)

## Was das Plugin leistet

* **Mehrere benannte Wunschlisten** — Kunden erstellen beliebig viele Listen mit individuellem Namen (z. B. „Geburtstag", „Weihnachten", „Heimoffice") und verwalten sie in ihrem Kundenkonto.
* **Öffentliches Teilen per Link** — Eine Wunschliste kann auf „Öffentlich" gestellt werden. Der erzeugte Share-Link lässt sich per WhatsApp, E-Mail oder Copy-Link-Schaltfläche teilen. Besucher können die Liste einsehen und als eigene Liste speichern.
* **Gast-Wunschliste** — Nicht eingeloggte Besucher können Produkte in einer lokalen Wunschliste (localStorage) speichern. Nach dem Login oder der Registrierung werden die Gast-Artikel automatisch in die erste Kundenwunschliste übernommen. Die Funktion ist DSGVO-konform und respektiert die Cookie-Einwilligung.
* **Herzicon-Toggle** — Auf Produktkacheln, Produktdetailseiten und Warenkorb-Positionen erscheint ein Herzicon. Ein Klick öffnet ein Dropdown zur Listenauswahl. Ein erneuter Klick auf eine bereits gewählte Liste entfernt das Produkt wieder.
* **Mengen pro Artikel** — Jeder Wunschlisten-Artikel hat eine eigene Mengeneingabe. Beim Hinzufügen zum Warenkorb wird die Wunschlisten-Menge übernommen.
* **Warenkorb als Wunschliste speichern** — Mit einem Klick wird der gesamte Warenkorb (ohne Gutscheine) in eine neue oder bestehende Wunschliste übertragen.
* **CSV-Export und -Import** — Kunden und Händler können Wunschlisten als CSV-Datei exportieren und per CSV (Artikelnummer-basiert) importieren.
* **Manuelle Artikeleingabe per Artikelnummer** — Auf der Wunschlisten-Detailseite können Kunden Produkte direkt per Artikelnummer hinzufügen.
* **Preissenkungsbenachrichtigungen** — Kunden können sich pro Wunschliste für E-Mail-Benachrichtigungen anmelden. Fällt der Preis eines Artikels unter den Preis zum Zeitpunkt des Hinzufügens (minus konfigurierbarem Schwellenwert), wird eine Benachrichtigung über den Shopware Flow Builder versendet.
* **Globale Wunschlisten** — Händler können im Admin kuratierte Wunschlisten anlegen (z. B. „Empfehlungen des Teams"), die Kunden auf der Wunschlisten-Übersicht unter ihren eigenen Listen sehen.
* **Admin-Analysen** — Unter **Kunden → Wunschlisten → Analysen** finden Sie die meistgewünschten Produkte, Aktivitätstrends und Konversionsraten.
* **Nicht verfügbare Produkte** — Inaktive oder aus dem Verkaufskanal entfernte Produkte werden auf der Detailseite separat ausgewiesen. Im Admin können Alternativprodukte zugewiesen werden.

## Verhältnis zur nativen Shopware-Wunschliste

Das Plugin arbeitet **unabhängig neben** der nativen Shopware-Wunschliste. Es deaktiviert die native Funktion nicht automatisch. Wenn Sie ausschließlich das Plugin verwenden möchten, deaktivieren Sie die native Wunschliste unter **Einstellungen → Shop → Warenkorb → Wunschliste aktivieren**. Bestehende native Wunschlisten können mit dem Konsolenbefehl `momo:wishlists:migrate-native` migriert werden (siehe [Installationsanleitung](https://docs.momocode.de/shopware-6/erweiterte-wunschlisten/2.-installationsanleitung)).

## Technische Rahmenbedingungen

* Shopware 6.6 (getestet ab 6.6.0)
* PHP 8.2+
* Der Shopware Scheduled Task Worker muss aktiv sein (für Preissenkungsbenachrichtigungen)
* Keine externen Dienste oder Abhängigkeiten