> 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/erweiterte-wunschlisten/1.-beschreibung.md).

# 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-917a7ec6e79afaf8f87dbaa1200496023727334f%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. Ob eine Einwilligung nötig ist und woher sie gelesen wird, bestimmt die konfigurierbare **Einwilligungsquelle**: Shopwares Cookie-Banner, ein fremdes Cookie Ihres Consent-Management-Tools, eine eigene Anbindung per JavaScript-API oder **Keine Einwilligungsprüfung** (siehe [Einwilligung & Consent-Tools](/shopware-6/erweiterte-wunschlisten/4.-einwilligung.md)).
* **Herzicon-Toggle** — Auf Produktkacheln, Produktdetailseiten und Warenkorb-Positionen erscheint ein Icon (Standard: Herz). Ein Klick öffnet ein Dropdown zur Listenauswahl. Ein erneuter Klick auf eine bereits gewählte Liste entfernt das Produkt wieder.
* **Konfigurierbares Icon und Terminologie** — Händler wählen in den Plugin-Einstellungen, welches Icon (Herz, Stern, Lesezeichen u. a.) in der Storefront erscheint und welche Begriffswelt durchgängig verwendet wird (Wunschliste, Merkzettel, Bestellliste oder Favoriten). Jedes Preset liefert grammatikalisch korrekte Texte in Deutsch und Englisch. Pro Verkaufskanal konfigurierbar.
* **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.
* **Automatische „Zuletzt bestellt“-Wunschliste** — Ein Hintergrundtask legt für jeden registrierten Kunden automatisch eine schreibgeschützte Wunschliste mit seinen zuletzt bestellten Produkten an und hält sie aktuell. Die Liste ist für Kunden mit einem „Automatisch“-Badge gekennzeichnet und kann nicht bearbeitet oder gelöscht werden.
* **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](/shopware-6/erweiterte-wunschlisten/2.-installationsanleitung.md)).

## Technische Rahmenbedingungen

* Shopware 6.6: Version 1.x.x | Shopware 6.7: Version 2.x.x
* PHP 8.2+
* Der Shopware Scheduled Task Worker muss aktiv sein (für Preissenkungsbenachrichtigungen und die automatische „Zuletzt bestellt“-Wunschliste)
* Keine externen Dienste oder Abhängigkeiten