Gespeicherte Suchen & Neuheiten-Benachrichtigungen — Dokumentation

Überblick

Das Modul Gespeicherte Suchen & Benachrichtigungen (dfsavedsearch) ermöglicht Ihren Kunden, eine Kombination von Suchkriterien zu speichern — Suchbegriffe, Kategorie, Hersteller, Preisspanne, Verfügbarkeit — und automatisch eine E-Mail zu erhalten, sobald ein neues passendes Produkt in Ihrem Shop veröffentlicht wird.

Jede gespeicherte Suche wird zu einem Reaktivierungskanal: Der Kunde kommt von selbst zurück, an dem Tag, an dem Sie ein Produkt veröffentlichen, das ihn interessiert. Ein Anti-Dubletten-Protokoll stellt sicher, dass er nur über Produkte benachrichtigt wird, die nach dem Speichern seiner Suche veröffentlicht wurden — und nie zweimal für dasselbe Produkt.

Installation

1. Öffnen Sie in Ihrem Back-Office Module > Modul-Manager und klicken Sie auf Ein Modul hochladen.
2. Wählen Sie das Archiv dfsavedsearch.zip aus und bestätigen Sie.
3. Bei der Installation erstellt das Modul seine zwei SQL-Tabellen, seinen Verwaltungs-Tab und seine Standardkonfiguration. Ein 32-stelliger Cron-Token wird automatisch generiert.
4. Das Modul ist sofort aktiv. Es ist keine externe Abhängigkeit erforderlich (kein Composer, kein Framework).

Konfiguration (Back-Office)

Rufen Sie die Konfigurationsseite des Moduls auf (Module > Modul-Manager > dfsavedsearch > Konfigurieren). Die verfügbaren Einstellungen sind:

• Modul aktivieren — aktiviert oder pausiert die Anzeige der Schaltfläche und den Versand der Benachrichtigungen.
• Produkte pro Digest — maximale Anzahl der in einer Benachrichtigungs-E-Mail gelisteten Produkte (standardmäßig 12).
• Suchen pro Kunde — maximale Anzahl der Suchen, die ein Kunde speichern kann (standardmäßig 20).
• Standardfrequenz — täglich oder wöchentlich, auf neue Suchen angewendet.
• Cron-Token — im Klartext angezeigt, mit einer Schaltfläche zur Neugenerierung. Die vollständige Cron-URL und das Datum des letzten Durchlaufs werden in einem eigenen Bereich angezeigt.

Die Werte werden in den Konfigurationsvariablen DFSAVEDSEARCH_ENABLED, DFSAVEDSEARCH_MAX_PRODUCTS, DFSAVEDSEARCH_MAX_PER_CUST, DFSAVEDSEARCH_DEFAULT_FREQ, DFSAVEDSEARCH_CRON_TOKEN und DFSAVEDSEARCH_LAST_CRON gespeichert.

Nutzung auf Kundenseite

Auf der Suchergebnisseite wird automatisch eine Schaltfläche « Diese Suche speichern » eingefügt. Mit einem Klick öffnet der Kunde ein Fenster, in dem er:

• seine Suche benennen kann;
• seine Kriterien angeben oder anpassen kann: Suchbegriffe, Kategorie (inkl. Unterkategorien), Hersteller, Mindest- und Höchstpreis, nur Produkte auf Lager;
• auf Wunsch die E-Mail-Benachrichtigung aktivieren und deren Frequenz wählen kann.

Die E-Mail-Benachrichtigung beruht auf einem ausdrücklichen Opt-in-Kontrollkästchen, standardmäßig nicht angehakt, mit klarem Einwilligungstext. Ein nicht angemeldeter Besucher wird aufgefordert, sich anzumelden, bevor er eine Suche speichert.

Der Bereich « Meine Suchen »

Ein Eintrag « Meine Suchen » wird dem Kundenkonto hinzugefügt. Dort findet der Kunde alle seine gespeicherten Suchen und kann für jede:

• die E-Mail-Benachrichtigung aktivieren oder deaktivieren;
• die Frequenz ändern (täglich / wöchentlich);
• die Suche löschen.

Die Kriterien jeder Suche werden als gut lesbare Badges zusammengefasst (Kategorie, Hersteller, Preisspanne usw.).

Planung des Cron (Versand der Benachrichtigungen)

Der E-Mail-Versand wird von einer Token-gesicherten Cron-Aufgabe gesteuert. Konfigurieren Sie den Aufgabenplaner Ihres Servers (oder einen Cron-Dienst) so, dass er die folgende URL aufruft:

https://ihr-shop.com/index.php?fc=module&module=dfsavedsearch&controller=cron&token=IHR_TOKEN

Ersetzen Sie IHR_TOKEN durch den in der Modulkonfiguration angezeigten Token.

Die Verarbeitung erfolgt in Stapeln (200 Suchen pro Durchlauf), um leicht zu bleiben. Die Cron-Ausgabe nennt die Anzahl der verarbeiteten Suchen, versendeten E-Mails und etwaigen Fehler, die in den PrestaShop-Logs protokolliert werden.

DSGVO-Konformität

• Ausdrückliches Opt-in: Die E-Mail-Benachrichtigung wird nie ohne eine bewusste Kundenaktion aktiviert (Kontrollkästchen standardmäßig nicht angehakt).
• Ein-Klick-Abmeldung: Jede E-Mail enthält einen signierten Abmeldelink, der die Benachrichtigung ohne Anmeldung deaktiviert.
• Export und Löschung: Das Modul integriert sich in die DSGVO-Hooks von PrestaShop (psgdpr) für Export und Löschung personenbezogener Daten.
• Automatische Bereinigung: Bei Löschung eines Kundenkontos werden alle seine gespeicherten Suchen entfernt.

Kompatibilität & technische Konventionen

• PrestaShop 8.0 bis 9.x, Multishop, 5 Sprachen.
• Verwendete Hooks: displayCustomerAccount, actionFrontControllerSetMedia, displayFooter, actionObjectCustomerDeleteAfter, actionDeleteGDPRCustomer, actionExportGDPRData.
• Verwaltungs-Tab AdminDfSavedSearch unter dem Menü Kunden.
• Ohne Abhängigkeit: manueller PSR-4-Autoloader, Vanilla-JS, kein externer Dienst.

Fehlerbehebung

• Es wird keine E-Mail versendet — prüfen Sie, ob der Cron tatsächlich aufgerufen wird (Datum des letzten Durchlaufs in der Konfiguration), ob das Modul aktiviert ist und ob die E-Mail-Konfiguration von PrestaShop funktioniert.
• Die Schaltfläche erscheint nicht — sie wird nur auf der Suchergebnisseite angezeigt; stellen Sie sicher, dass das Modul aktiviert ist, und leeren Sie den PrestaShop-Cache.
• Ein Kunde erhält keine Benachrichtigung — stellen Sie sicher, dass die Benachrichtigung für die betreffende Suche aktiv ist und dass nach dem Speichern tatsächlich neue passende Produkte veröffentlicht wurden.