# 4. 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-75503fbee1d3053043a644287776d3349866efea%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 Herzicon 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 und hat der Besucher die Cookie-Einwilligung für „Komfortfunktionen" erteilt, 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.

> **Hinweis:** Das Herzicon im Header und auf den Produktkacheln wird erst angezeigt, nachdem der Besucher die optionalen Cookies akzeptiert und anschließend die Seite neu geladen oder gewechselt hat.

## 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-04787c062617bc2e53e8d866dc63ad208e1fcbe0%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-901878e6bbf9dc8b6ed899c54919704bb8feb947%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.
