Suche ohne Ergebnisse — Rettungsseite & Benachrichtigungen — Dokumentation

Überblick

Das Modul Suche ohne Ergebnisse (dfzerosearch) fängt die Suchen Ihres Shops ab, die kein Ergebnis liefern, und ersetzt sie durch eine Rettungsseite: Rechtschreibkorrektur „Meinten Sie…?“, ähnliche Produkte, Bestseller der erratenen Kategorie, globale Bestseller und ein „Benachrichtigen Sie mich“-Formular.

Im Back-Office aggregiert ein Dashboard der verlorenen Suchanfragen jede Suche ohne Ergebnis und lässt Sie sie mit einem Klick mit einem Produkt, einer Kategorie oder einer URL verknüpfen — als Vorschlag auf der Seite oder als automatische Weiterleitung.

Installation

1. Öffnen Sie in Ihrem Back-Office Module > Modul-Manager und klicken Sie auf Ein Modul hochladen.
2. Wählen Sie das Archiv dfzerosearch.zip und bestätigen Sie.
3. Bei der Installation erstellt das Modul seine drei SQL-Tabellen, seinen Verwaltungsreiter (und seine drei Unterreiter) sowie seine Standardkonfiguration.
4. Das Modul ist sofort aktiv. Es ist keine externe Abhängigkeit erforderlich (weder Composer noch Framework).

Konfiguration (Back-Office)

Öffnen Sie die Konfigurationsseite des Moduls (Module > Modul-Manager > dfzerosearch > Konfigurieren). Die verfügbaren Einstellungen sind:

• Modul aktivieren — aktiviert oder pausiert die Erkennung und die Anzeige der Rettungsseite.
• Rechtschreibkorrektur — aktiviert den Block „Meinten Sie…?“.
• Kategorie-Block — aktiviert die Bestseller der erratenen Kategorie.
• Bestseller-Block — aktiviert die globalen Bestseller, nur als letzte Möglichkeit angezeigt.
• „Benachrichtigen Sie mich“-Formular — aktiviert die E-Mail-Erfassung auf der Rettungsseite.
• Produkte pro Block — Anzahl der in jedem Block angezeigten Produkte (standardmäßig 8, von 1 bis 24).
• Mindestlänge der Anfrage — unterhalb dieser Zeichenanzahl wird die Suche nicht protokolliert (standardmäßig 2).
• Aufbewahrung (Tage) — Aufbewahrungsdauer der verlorenen Suchanfragen, mit einer Schaltfläche zur manuellen Bereinigung (standardmäßig 180 Tage).

Die Werte werden in den Konfigurationsvariablen DFZS_ENABLED, DFZS_FUZZY, DFZS_CATEGORY_BLOCK, DFZS_BESTSELLERS_BLOCK, DFZS_NOTIFY_FORM, DFZS_NB_PRODUCTS, DFZS_MIN_LENGTH und DFZS_RETENTION_DAYS gespeichert. Ein Schnellzugriffs-Panel verweist auf die drei Verwaltungsansichten.

Die Rettungsseite (Besucherseite)

Auf der Ergebnisseite erkennt ein Skript, dass das Produktraster leer ist, und lädt dann die Rettungsseite per AJAX über den Front-Controller rescue. Die Blöcke erscheinen in dieser Reihenfolge:

1. Vorgeschlagenes Ziel — wenn eine aktive Verknüpfung im Modus „Vorschlag“ für die Anfrage existiert, wird ihr Ziel (Produkt, Kategorie oder URL) hervorgehoben.
2. „Meinten Sie…?“ — die korrigierte Anfrage und ihre Produkte, mit einem Link zur echten korrigierten Suchseite.
3. Bestseller der erratenen Kategorie — aus den Suchbegriffen.
4. Globale Bestseller — nur wenn keiner der vorherigen Blöcke ein Ergebnis geliefert hat.
5. „Benachrichtigen Sie mich“-Formular — um die E-Mail des Besuchers für diese Anfrage zu erfassen.

Rechtschreibkorrektur & Kategorie-Erraten

Die Rechtschreibkorrektur schreibt die Anfrage Wort für Wort gegen den nativen Suchindex von PrestaShop (Tabelle ps_search_word) um, mit einer an die Wortlänge angepassten Levenshtein-Distanz. Es werden nur Wörter vorgeschlagen, die tatsächlich im Index vorhanden sind; die echte PrestaShop-Suche wird anschließend mit der korrigierten Anfrage neu gestartet.

Das Kategorie-Erraten gleicht die Suchbegriffe mit den Namen der aktiven Kategorien des Shops ab (Teilzeichenketten-Abgleich, dann Levenshtein). Die am besten bewertete Kategorie liefert ihre Bestseller.

Dashboard der verlorenen Suchanfragen & Verknüpfung

Der Reiter DF Zero Search vereint drei Ansichten:

• Verlorene Suchanfragen — jede Suche ohne Ergebnis, aggregiert, gezählt und nach Volumen sortiert, mit vier Kennzahlen (verlorene Suchen gesamt, eindeutige Anfragen, aktive Verknüpfungen, wartende Alarme). Eine Aktion „Verknüpfen“ füllt das Verknüpfungsformular vor.
• Verknüpfungen — die Liste der Zuordnungen Anfrage → Ziel. Ein Ziel kann ein Produkt, eine Kategorie oder eine URL sein, im Modus Vorschlag (auf der Rettungsseite angezeigt) oder Weiterleitung (der Besucher wird automatisch weitergeleitet).
• „Benachrichtigen“-Abonnements — die Liste der erfassten E-Mails, mit ihrem Status (wartend / benachrichtigt).

„Benachrichtigen Sie mich“-Formular & Alarme

Auf der Rettungsseite lässt ein standardmäßig nicht angehaktes Opt-in-Formular, durch einen Anti-Bot-Honeypot geschützt, den Besucher seine E-Mail für die aktuelle Anfrage hinterlassen. Wenn Sie im Back-Office eine aktive Verknüpfung für diese Anfrage erstellen, sendet die Aktion „Benachrichtigen“ die E-Mail dfzerosearch_alert an alle wartenden Abonnenten, jeweils in ihrer Sprache, und markiert sie dann als benachrichtigt.

DSGVO-Konformität

• Explizites Opt-in: Die E-Mail-Erfassung beruht auf einem standardmäßig nicht angehakten Kontrollkästchen mit klarem Einwilligungstext.
• Honeypot: Ein verstecktes Feld filtert automatisierte Übermittlungen, ohne den Besucher zu stören.
• Kontrollierte Aufbewahrung: Verlorene Suchanfragen werden nach der konfigurierten Anzahl von Tagen automatisch bereinigt, mit jederzeit verfügbarer manueller Bereinigung.
• Selbst-Hosting: Es werden keine Daten an Dritte übermittelt.

Kompatibilität & technische Konventionen

• PrestaShop 8.0 bis 9.x, mandantenfähig, 5 Sprachen.
• Verwendete Hooks: actionSearch und actionFrontControllerSetMedia.
• SQL-Tabellen: dfzerosearch_query, dfzerosearch_mapping, dfzerosearch_alert.
• Verwaltungsreiter AdminDfZeroSearch und seine drei Unterreiter, unter dem Menü Verbessern.
• Front-Controller rescue, durch Token gesichert, JSON-Antworten.
• Ohne Abhängigkeit: manueller PSR-4-Autoloader, Vanilla-JS ohne jQuery, kein externer Dienst.

Fehlerbehebung

• Die Rettungsseite erscheint nicht — prüfen Sie, ob das Modul aktiviert ist, ob die Suche wirklich null Ergebnisse liefert, und leeren Sie den PrestaShop-Cache.
• Es wird keine Korrektur vorgeschlagen — die Korrektur schlägt nur Wörter vor, die im nativen Index vorhanden sind; indexieren Sie die PrestaShop-Suche neu, wenn sich Ihr Katalog stark geändert hat.
• Im Dashboard erscheint keine Anfrage — stellen Sie sicher, dass die Länge der Anfragen den konfigurierten Mindestschwellenwert überschreitet und dass das Modul aktiviert ist.
• Die Alarm-E-Mails werden nicht versendet — prüfen Sie die E-Mail-Konfiguration von PrestaShop und dass die Aktion „Benachrichtigen“ tatsächlich auf einer aktiven Verknüpfung mit wartenden Abonnenten ausgeführt wurde.