> 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/5.-storefront-nutzung.md).

# 5. Storefront-Nutzung

## Wunschlisten-Übersicht

Kunden gelangen zu ihren Wunschlisten über **Mein Konto → Meine Wunschlisten** oder über das Herzicon in der Kopfzeile. Die Übersichtsseite zeigt:

* Alle eigenen Wunschlisten mit Name, Artikelanzahl und Sichtbarkeit (öffentlich/privat)
* Aktionsschaltflächen zum Umbenennen und Löschen einer Liste
* Eine Schaltfläche **Neue Wunschliste erstellen**
* Darunter (sofern vorhanden) globale Wunschlisten des Händlers als „Empfehlungen“

![Meine Wunschlisten — Übersichtsseite](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-5a6e6d23237c08940e28499a57e28af882633c8a%2F1.png?alt=media)

## Neue Wunschliste anlegen

1. Auf der Übersichtsseite auf **Neue Wunschliste erstellen** klicken.
2. Einen Namen eingeben und bestätigen.

Alternativ kann beim Hinzufügen eines Produkts über das Herzicon-Dropdown direkt **Neue Liste erstellen** gewählt werden — die Wunschliste wird dann on-the-fly angelegt.

## Produkte zur Wunschliste hinzufügen

> Das angezeigte Icon und die Bezeichnung „Wunschliste“ können in der [Konfiguration](/shopware-6/erweiterte-wunschlisten/3.-konfiguration.md) angepasst werden (z. B. Stern statt Herz, „Bestellliste“ statt „Wunschliste“).

Das Icon erscheint auf:

* Produktkacheln in Listings und Suchergebnissen
* Der Produktdetailseite
* Warenkorb-Positionen (Warenkorbseite, Checkout, Bestellbestätigung)

Ein Klick auf das Herzicon öffnet ein Dropdown mit allen verfügbaren Wunschlisten. Bereits enthaltene Produkte sind mit einem Häkchen markiert. Ein Klick auf eine markierte Liste **entfernt** das Produkt wieder (Toggle-Verhalten). Am Ende des Dropdowns befindet sich die Option **Neue Liste erstellen**.

### Gast-Besucher

Ist die Gast-Wunschliste in den Plugin-Einstellungen aktiviert, können Produkte auch ohne Login gespeichert werden. Die Daten werden im localStorage des Browsers abgelegt. Nach dem Login oder der Registrierung werden die Gast-Artikel automatisch in die erste Kundenwunschliste übernommen.

Ob dafür eine Einwilligung nötig ist, bestimmt die Einstellung **Einwilligungsquelle**:

* **Shopware-Cookie-Banner** (Standard), **Fremdes Cookie (Consent-Management-Tool)** und **Eigene Anbindung (JavaScript-API)** — es wird erst nach erteilter Einwilligung gespeichert. Beim Standard stammt sie aus Shopwares Cookie-Banner, Kategorie „Komfortfunktionen“.
* **Keine Einwilligungsprüfung** — es gilt kein Consent-Gate: Die Gast-Wunschliste ist ohne Prüfung aktiv und das Element sofort nutzbar. Es existiert in diesem Modus auch kein Einwilligungsstatus, der erteilt oder widerrufen werden könnte — die beiden folgenden Absätze greifen daher nicht.

Bei aktivierter Einwilligungsprüfung erscheint das Wunschlisten-Symbol im Header und auf den Produktkacheln **sofort**, sobald der Besucher einwilligt — ein Neuladen oder ein Seitenwechsel ist nicht nötig. Widerruft er die Einwilligung, werden das Consent-Cookie und die gespeicherte Gast-Wunschliste umgehend gelöscht und der Zähler im Header auf null gesetzt.

> **Hinweis:** Wird eine Einwilligung geprüft und liegt keine vor, wird das Wunschlisten-Element standardmäßig ausgeblendet. Sie können stattdessen einstellen, dass es sichtbar bleibt und beim Klick um eine Einwilligung bittet. Bei **Keine Einwilligungsprüfung** hat diese Einstellung keine Wirkung, da das Element ohnehin immer nutzbar ist. Welche der vier Quellen gilt und wie Sie ein externes Consent-Management-Tool anbinden, lesen Sie unter [Einwilligung & Consent-Tools](/shopware-6/erweiterte-wunschlisten/4.-einwilligung.md).

## Wunschlisten-Detailseite

Auf der Detailseite einer Wunschliste stehen folgende Funktionen zur Verfügung:

### Artikel verwalten

* **Menge ändern** — Jeder Artikel hat Schaltflächen +/− und ein Mengeneingabefeld. Änderungen werden per AJAX direkt gespeichert.
* **Zum Warenkorb hinzufügen** — Schaltfläche pro Artikel; der Off-Canvas-Warenkorb öffnet sich automatisch.
* **Alle in den Warenkorb** — Fügt alle Artikel (mit ihren jeweiligen Mengen) in einer Aktion zum Warenkorb hinzu.
* **Mehrfachauswahl** — Artikel per Checkbox markieren und gemeinsam in den Warenkorb legen.
* **Artikel entfernen** — Entfernt den Artikel aus der Wunschliste (kein Warenkorb-Vorgang).

### Artikel per Artikelnummer hinzufügen

Unterhalb der Artikelliste befindet sich ein einklappbarer Bereich **Artikel per Artikelnummer hinzufügen**. Geben Sie die Artikelnummer (SKU) und optional eine Menge ein. Das Produkt wird bei Übereinstimmung sofort zur Wunschliste hinzugefügt.

### Nicht verfügbare Produkte

Ist die entsprechende Option in der Konfiguration aktiviert, erscheint oberhalb der regulären Artikelliste ein gesonderter Abschnitt für Produkte, die inaktiv oder aus dem Verkaufskanal entfernt wurden. Kunden können:

* Den nicht verfügbaren Artikel direkt aus der Wunschliste entfernen.
* Ein vom Händler zugewiesenes Alternativprodukt per Klick zur Wunschliste hinzufügen.

![Wunschlisten-Detailseite mit Artikeln und Mengenangaben](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-26a809d353b386f46ba5d2b95b863e77b3ad32ba%2F2.png?alt=media)

### CSV-Export und -Import

* **Als CSV exportieren** — Lädt die aktuelle Wunschliste als CSV-Datei herunter (Spalten: Artikelnummer, Name, Menge, Hinzugefügt am).
* **CSV importieren** — Öffnet einen Dateiauswahldialog. Die CSV-Datei muss mindestens eine Spalte mit Artikelnummern enthalten. Nicht gefundene Artikel und Duplikate werden übersprungen und in einer Zusammenfassung ausgewiesen.

### Preissenkungsbenachrichtigungen aktivieren

Auf der Detailseite befindet sich (sofern global aktiviert) ein Bereich mit einem Umschalter **Preissenkungsbenachrichtigungen**. Kunden können diesen pro Wunschliste unabhängig ein- und ausschalten. Ist der Umschalter aktiv, werden sie per E-Mail benachrichtigt, wenn ein Artikel dieser Wunschliste im Preis sinkt.

## Wunschliste teilen

1. Auf der Detailseite auf **Öffentlich machen** klicken. Die Sichtbarkeit wechselt auf „Öffentlich“.
2. Ein Share-Link-Bereich erscheint mit Schaltflächen für WhatsApp, E-Mail und **Link kopieren**.
3. Den Link versenden. Empfänger können die Wunschliste einsehen, ohne sich einzuloggen.

Mit **Privat machen** wird der Zugriff sofort gesperrt (der Link wird ungültig, der Token bleibt gespeichert falls die Liste später wieder öffentlich gestellt wird).

### Öffentliche Wunschliste für Empfänger

Empfänger des Share-Links sehen:

* Den Namen der Wunschliste und den Namen des Inhabers
* Alle Artikel als standard Shopware-Produktkacheln (mit Bild, Name, Varianten, Preis, In-den-Warenkorb-Schaltfläche)
* Schaltflächen zum Teilen (WhatsApp, E-Mail, Link kopieren)
* Eine Schaltfläche **Als eigene Liste speichern** (für eingeloggte Kunden)

![Öffentliche Wunschliste — Ansicht für Empfänger](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-e0d4bcfa772821221be2534b6922ba4f0bd034df%2F3.png?alt=media)

Beim Speichern als eigene Liste wird eine neue private Wunschliste mit gleichem Namen angelegt, die alle Artikel der geteilten Liste enthält.

## Warenkorb als Wunschliste speichern

Auf der Warenkorbseite befindet sich eine Schaltfläche **Als Wunschliste speichern**. Ein Dropdown ermöglicht:

* Alle Warenkorb-Artikel in eine neue Wunschliste speichern (Standardname: „Warenkorb – {Datum}“)
* Alle Warenkorb-Artikel zu einer bestehenden Wunschliste hinzufügen (Duplikate werden übersprungen)

Der Warenkorb wird dabei **nicht** geleert.
