Produktfinder — Dokumentation

Das Modul Produktfinder (dffinder) verwandelt einen komplexen Katalog in eine geführte Kaufreise. Sie bauen im Backoffice einen Fragebaum; der Besucher beantwortet ihn Schritt für Schritt und landet auf einer gefilterten Produktauswahl – genau wie bei einem Verkaufsberater im Laden.

Überblick

Das Modul richtet sich an Kataloge, in denen Kunden zögern: Matratzen, Fahrräder, IT-Hardware, Kosmetik, Ersatzteile. Jede Antwort im Fragebogen ist mit einem oder mehreren Ihrer Katalogkriterien verknüpft (Attribute, Merkmale, Kategorien, Hersteller, Preisspannen), und das Modul übersetzt die Auswahl des Besuchers in eine native Produktsuche.

• Drag-and-drop-Fragebaum-Builder, ohne Code.
• Fragen mit Einfach- oder Mehrfachauswahl, mehrsprachige Titel und Bezeichnungen.
• Echtzeit-Zähler passender Produkte bei jedem Schritt.
• Native Ergebnisseite (Sortierung und Paginierung des Themes) über ProductSearchProviderInterface.
• Anzeige als Startseiten-Widget, Widget-Tag oder eigene Seite.
• Kompatibel mit PrestaShop 8.0 bis 9.x, multishop und mehrsprachig.

Installation

1. Gehen Sie zu Module > Modul-Manager > Modul hochladen.
2. Wählen Sie das Archiv dffinder-1.0.0.zip und bestätigen Sie die Installation.
3. Das Modul erstellt seine Tabellen, einen Admin-Tab DF Product Finder und die umgeschriebenen Routen product-finder und product-finder/results.

Ihren ersten Finder erstellen

Öffnen Sie Module > DF Product Finder und klicken Sie auf Finder hinzufügen. Geben Sie ihm einen internen Namen und einen Einleitungstext, der oben im Fragebogen angezeigt wird. Der Builder ist in Spalten gegliedert: die Fragen links, die Antworten jeder Frage und die Zuordnungen jeder Antwort.

Fragen hinzufügen

Klicken Sie auf Frage hinzufügen. Für jede Frage legen Sie fest:

• den Titel (z. B. „Wofür möchten Sie es nutzen?“) und einen optionalen Hilfetext;
• den Anzeigetyp: Einfachauswahl (eine Antwort, mit automatischem Weiterschalten) oder Mehrfachauswahl (mehrere ankreuzbare Antworten);
• die Reihenfolge, indem Sie die Frage an die gewünschte Position ziehen.

Antworten hinzufügen

Fügen Sie unter jeder Frage die dem Besucher angebotenen Antworten hinzu (z. B. „Sport“, „Stadt“, „Kind“). Jede Antwort hat eine mehrsprachige Bezeichnung und lässt sich innerhalb ihrer Frage per Drag-and-drop neu anordnen.

Antworten dem Katalog zuordnen

Das ist das Herzstück des Moduls: Jede Antwort verweist auf ein oder mehrere Produktkriterien. Die verfügbaren Zuordnungstypen sind:

• Attribut — ein Kombinationsattribut-Wert (Größe, Farbe…), abgeglichen mit den Produktkombinationen;
• Merkmal — ein Produktmerkmal-Wert;
• Kategorie — die Zugehörigkeit zu einer Kategorie;
• Hersteller — die Marke des Produkts;
• Preis — eine min/max-Spanne auf den Basispreis des Shops.

Die Felder Attribut, Merkmal, Kategorie und Hersteller bieten eine Autovervollständigung: Tippen Sie ein paar Buchstaben, um den Wert zu finden. Eine einzelne Antwort kann mehrere Zuordnungen kombinieren (zum Beispiel eine Kategorie und eine Preisspanne).

Wenn Ihr Baum fertig ist, klicken Sie auf Speichern. Das Speichern ist idempotent: Der gesamte Baum wird bei jedem Speichern neu aufgebaut, was einen konsistenten Zustand garantiert.

Die Matching-Engine verstehen

Das Modul kombiniert die Auswahl des Besuchers nach zwei einfachen Regeln:

• ODER zwischen den Antworten derselben Frage: „Sport“ und „Stadt“ ankreuzen erweitert die Auswahl auf Produkte, die zu einer der beiden passen.
• UND zwischen den Fragen: Die Kriterien jeder abgeschlossenen Frage summieren sich, um die Auswahl einzugrenzen.

Bei jedem Schritt berechnet das Modul die Zahl passender Produkte per AJAX neu und zeigt sie dem Besucher an, was eine leere Auswahl vermeidet.

Den Finder anzeigen

Startseiten-Widget

Aktivieren Sie die Anzeige auf der Startseite in der Modulkonfiguration. Das Widget zeigt eine Call-to-Action-Karte, die zum Fragebogen führt.

Widget-Tag

Um den Finder an beliebiger Stelle in einem Ihrer Theme-Templates einzufügen, verwenden Sie den Smarty-Tag:

{widget name='dffinder' id_finder=1}

Ersetzen Sie id_finder durch die ID des gewünschten Finders (in der Backoffice-Liste sichtbar).

Eigene URLs

Der Fragebogen ist auch direkt über saubere URLs erreichbar, praktisch für Ihre Kampagnen:

• ihr-shop/product-finder — der Fragebogen;
• ihr-shop/product-finder/results?answers=1,4,9 — die Ergebnisseite.

Die Ergebnisseite

Am Ende des Fragebogens wird der Besucher auf eine Ergebnisseite geleitet, die den nativen Listing-Controller von PrestaShop erweitert. Konkret erhalten Sie ohne zusätzliche Einrichtung:

• das Produktlisten-Template Ihres Themes;
• die Sortierung nach Datum, Preis oder Name;
• die Standard-Paginierung.

Ein Link Neu starten ermöglicht dem Besucher, den Fragebogen von vorne zu beginnen.

Multishop und mehrsprachig

Das Modul ist an den Shop-Kontext gebunden: Jeder Finder gehört zu dem/den Shop(s) Ihrer Wahl. Alle Texte (Name, Einleitung, Fragetitel, Antwortbezeichnungen) können dank des Bearbeitungssprachen-Umschalters oben im Builder pro Sprache eingegeben werden.

Fehlerbehebung