Geburts-, Hochzeits- & Geschenkliste — Vollständige Anleitung
Geteilte Geburts-, Hochzeits- und Geschenklisten installieren, konfigurieren und betreiben: Kundenerstellung, öffentlicher Link, Reservierung in den Warenkorb, Verfolgung und Back-Office, für PrestaShop 8 und 9.
Überblick und Voraussetzungen
Das Modul Geburts-, Hochzeits- & Geschenkliste fügt Ihrem Shop ein vollständiges System für geteilte Geschenklisten hinzu. Ihre Kunden erstellen ihre Liste in ihrem Konto, fügen Produkte aus Ihrem Katalog hinzu und teilen einen öffentlichen Link. Ihre Angehörigen reservieren Geschenke, die in den Warenkorb gelegt und anschließend bei der Bestätigung der Bestellung bestätigt werden. Der Listenbesitzer wird dann per E-Mail benachrichtigt.
- Kompatibel mit PrestaShop 8.0 bis 9.x.
- PHP 7.4 bis 8.3, MySQL 5.7+ / MariaDB 10.3+.
- Multishop und mehrsprachig (FR/EN/ES/DE/IT).
- ObjectModel-Architektur und Legacy-Front-Controller, ohne Symfony-Abhängigkeit, ohne Core-Override.
Das Modul erstellt drei eigene Tabellen (df_giftregistry, df_giftregistry_item, df_giftregistry_reservation) und verändert keine Core-Datei. Die Deinstallation entfernt diese Tabellen, den Admin-Tab und die Einstellungen.
Installation
- Laden Sie das Archiv
dfgiftregistry.zipaus Ihrem Kundenkonto herunter. - Gehen Sie im Back-Office zu Module > Modul-Manager.
- Klicken Sie auf Modul hochladen und legen Sie das Archiv ab.
- Die Installation erstellt die Tabellen, registriert die Hooks (
displayCustomerAccount,displayProductAdditionalInfo,actionFrontControllerSetMedia,actionValidateOrder) und fügt den Admin-Tab unter Kunden hinzu.
Nach der Installation ist das Modul sofort aktiv: Der Listen-Block erscheint im Kundenkonto und die Hinzufügen-Schaltfläche auf der Produktseite.
Moduleinstellungen
Klicken Sie im Modul-Manager auf Konfigurieren, um die Einstellungsseite zu öffnen:
- Schaltfläche auf der Produktseite: zeigt oder verbirgt die Schaltfläche „Zu einer Geschenkliste hinzufügen“ auf den Produktseiten.
- Gast-Schenken: erlaubt nicht angemeldeten Besuchern, ein Geschenk anzubieten, indem sie ihren Namen und eine optionale E-Mail angeben.
- Besitzer-Benachrichtigung: sendet dem Besitzer für jedes bestätigte Geschenk eine E-Mail.
- Namensanzeige: zeigt dem Besitzer den Namen des Schenkenden an, es sei denn, der Schenkende hat sich für Anonymität entschieden.
- Aufbewahrungsfrist (
DFGR_HOLD_MINUTES, standardmäßig 180 Min.): die Zeit, nach der eine nicht abgeschlossene ausstehende Reservierung automatisch freigegeben wird. - Maximale Anzahl an Listen pro Kunde (
DFGR_MAX_PER_CUSTOMER, standardmäßig 5).
Kundenseite: eine Liste erstellen und verwalten
Eine Liste erstellen
In seinem Konto öffnet der Kunde den Bereich der Geschenklisten und erstellt eine neue Liste. Er wählt einen Typ (Geburt, Hochzeit, Geburtstag, Einzug, Sonstige), gibt einen Titel ein und kann ein Veranstaltungsdatum, eine Willkommensnachricht, eine Beschreibung und eine Lieferadresse angeben. Die Liste ist standardmäßig öffentlich, kann aber auf privat gestellt werden.
Produkte hinzufügen
Zwei Möglichkeiten:
- Von der Produktseite: Der Kunde wählt eine seiner Listen, legt die gewünschte Menge fest und klickt auf „Hinzufügen“. Die auf der Seite gewählte Variante wird berücksichtigt.
- Aus dem Verwaltungsbereich der Liste: Er passt die gewünschte Menge und die Priorität jedes Produkts an.
Wenn ein Produkt bereits in der Liste enthalten ist, erhöht das Hinzufügen von der Produktseite einfach die gewünschte Menge.
Die Liste teilen
Jede Liste verfügt über einen eindeutigen öffentlichen Link. Eine Schaltfläche „Kopieren“ legt diesen Link in die Zwischenablage, bereit zum Versand an Angehörige per E-Mail oder Messenger.
Erhaltene Geschenke verfolgen
Im Verwaltungsbereich sieht der Besitzer für jedes Produkt einen Fortschrittsbalken reserviert / verbleibend sowie die Liste der erhaltenen Geschenke, mit dem Namen des Schenkenden je nach Einstellung der Namensanzeige.
Besucherseite: ein Geschenk schenken
Beim Öffnen des öffentlichen Links entdeckt ein Angehöriger die Liste: Typ, Name des Besitzers, Veranstaltungsdatum, Willkommensnachricht und Produktraster. Jedes Produkt zeigt seinen Fortschritt reserviert / verbleibend.
- Der Besucher klickt unter dem gewählten Produkt auf Dieses Geschenk schenken.
- Er gibt die Menge an (auf das Verbleibende begrenzt), eine optionale kurze Nachricht und — falls nicht angemeldet — seinen Namen und eine optionale E-Mail.
- Er kann „Anonym bleiben“ ankreuzen, wenn die Einstellung der Namensanzeige aktiviert ist.
- Nach Bestätigung wird das Produkt reserviert und in seinen Warenkorb gelegt; er wird zum Warenkorb weitergeleitet, um die Bestellung abzuschließen.
Wenn das Gast-Schenken deaktiviert ist, können nur angemeldete Kunden ein Geschenk anbieten.
Der Reservierungszyklus
Eine Reservierung durchläuft die folgenden Zustände:
- Ausstehend: erstellt, sobald der Besucher auf „Dieses Geschenk schenken“ klickt und das Produkt in den Warenkorb gelegt wird.
- Bestätigt: bei der Bestätigung der Bestellung (Hook
actionValidateOrder) wird die mit dem Warenkorb verbundene Reservierung bestätigt und der Bestellung zugeordnet. - Freigegeben: eine nicht abgeschlossene ausstehende Reservierung, die mit einem abgebrochenen Warenkorb verbunden ist, wird nach der Aufbewahrungsfrist automatisch entfernt.
Der verbleibende Bestand eines Produkts entspricht der gewünschten Menge abzüglich der Summe der ausstehenden und bestätigten Reservierungen. Wenn ein Produkt vollständig reserviert ist, wird es gesperrt und kann nicht mehr geschenkt werden, was Dubletten vermeidet.
Händlerseite: Back-Office
Der Tab Geschenklisten (unter Kunden) listet alle Listen des Shops auf: Kunde, Typ, Anzahl der Produkte, Anzahl der Geschenke, Status aktiv/inaktiv und Erstellungsdatum.
Die Detailansicht einer Liste zeigt:
- die Informationen zur Liste und zum Kunden;
- die Produkte mit gewünschter, reservierter und verbleibender Menge;
- die Reservierungen mit dem Schenkenden, der Menge, der Nachricht, dem Status und einem direkten Link zur zugehörigen Bestellung.
Listen werden von den Kunden erstellt: Die Erstellungsaktion ist im Back-Office nicht verfügbar. Der Händler kann ansehen und löschen.
Benachrichtigungs-E-Mails
Wenn die Besitzer-Benachrichtigung aktiviert ist, wird dem Listenbesitzer für jedes bestätigte Geschenk eine E-Mail gesendet. Sie enthält den Titel der Liste, das geschenkte Produkt, die Menge, den Namen des Schenkenden (je nach Anzeige-Einstellung und Anonymitätswahl) und eine eventuelle Nachricht. Die E-Mail-Vorlagen werden auf Französisch und Englisch bereitgestellt und sind anpassbar.
Mehrsprachig und Multishop
Die Modulbeschriftungen sind über das Übersetzungssystem der PrestaShop-Module übersetzbar. Die Anzeige berücksichtigt den aktuellen Shop-Kontext: Eine in einem Shop erstellte Liste bleibt diesem Shop zugeordnet.
FAQ und Fehlerbehebung
Die Schaltfläche „Zu einer Liste hinzufügen“ erscheint nicht auf der Produktseite
Prüfen Sie, ob die Option Schaltfläche auf der Produktseite in den Einstellungen aktiviert ist und ob der Hook displayProductAdditionalInfo in Ihrem Theme korrekt positioniert ist.
Die öffentliche Seite zeigt „Liste nicht gefunden“
Die Liste ist möglicherweise privat, inaktiv oder einem anderen Shop zugeordnet. Prüfen Sie ihren Status im Kundenkonto oder im Back-Office.
Ein Produkt bleibt gesperrt, obwohl die Bestellung nicht aufgegeben wurde
Es handelt sich um eine ausstehende Reservierung. Sie wird nach der in den Einstellungen festgelegten Aufbewahrungsfrist automatisch freigegeben. Sie können diese Frist bei Bedarf verkürzen.
Der Besitzer erhält keine E-Mail
Prüfen Sie, ob die Besitzer-Benachrichtigung aktiviert ist und ob der E-Mail-Versand unter Erweiterte Einstellungen > E-Mail korrekt konfiguriert ist.
Was passiert bei der Deinstallation?
Die Deinstallation entfernt die drei Modultabellen, den Admin-Tab und die Einstellungen. Es bleiben keine Restdaten zurück.