DF Fitment Finder — Fahrzeugsuche und Produktkompatibilität

DF Fitment Finder ergänzt Ihren PrestaShop-Shop um eine Kompatibilitätssuche: Der Kunde wählt sein Fahrzeug (oder sein Gerät), und der Katalog zeigt ihm nur noch die Produkte, die passen. Diese Dokumentation behandelt Installation, Konfiguration, das Befüllen des Fahrzeugbestands und die Darstellung im Frontend.

Installation

1. Gehen Sie zu Module > Modul-Manager und klicken Sie auf Modul hochladen.
2. Legen Sie die Datei dffitmentfinder.zip ab und starten Sie die Installation.
3. Klicken Sie auf Konfigurieren, um zu den Einstellungen zu gelangen.

Die Installation legt drei Tabellen an (Fahrzeugbestand, Produktzuordnungen, Kundengaragen), registriert die nötigen Hooks und fügt den Reiter Fahrzeuge unter dem Menü Katalog hinzu. Es wird kein Core-Override installiert und keine Composer-Abhängigkeit benötigt.

Konfiguration

Suchebenen

Die Auswahl basiert auf vier Ebenen: Marke, Modell, Baujahr und Motorisierung. Die ersten beiden sind immer aktiv; die letzten beiden lassen sich je nach Katalog ein- oder ausschalten.

• Baujahr verwenden: für einen Katalog ohne Baujahr abschalten (Druckerpatronen, Handyhüllen, Haushaltsgeräteteile).
• Motorisierung verwenden: abschalten, wenn die feinste Ebene Ihres Bestands das Modell ist.

Die Suche ist bereits möglich, sobald Marke und Modell ausgewählt sind: Der Kunde muss nie bis zur feinsten Ebene gehen.

Bezeichnungen der Ebenen

Jede Ebene trägt eine Bezeichnung, die je Sprache anpassbar ist. Standard: Marke, Modell, Baujahr, Motorisierung. Passen Sie sie an Ihre Branche an:

• Autoteile: Marke / Modell / Baujahr / Motorisierung
• Druckerpatronen: Marke / Serie / — / Referenz
• Handyhüllen: Marke / Modell
• Haushaltsgeräte: Hersteller / Reihe / Baujahr / Referenz

Anzeigebereiche

• Im Header anzeigen: Die Auswahl erscheint oben auf allen Seiten.
• Auf der Startseite anzeigen: Die Auswahl erscheint im Inhalt der Startseite.
• Widget: Platzieren Sie die Auswahl mit dem Smarty-Tag {widget name='dffitmentfinder'} an beliebiger Stelle in Ihrem Theme.

Produktseite

• Kompatibilitätsprüfung: zeigt unter dem Preis einen grünen Hinweis (das Produkt passt an das aktuelle Fahrzeug), einen roten (es passt nicht) oder einen neutralen (kein Fahrzeug gewählt).
• Kompatibilitätstabelle: zeigt am Seitenende die vollständige Liste der kompatiblen Fahrzeuge, nach Marke gruppiert und aufklappbar.

Ergebnisse pro Seite

Anzahl der Produkte pro Seite auf der Ergebnisseite. Standardwert: 12.

Den Fahrzeugbestand befüllen

Manuelle Eingabe

Gehen Sie zu Katalog > Fahrzeuge. Die Schaltfläche Hinzufügen öffnet das Formular eines Fahrzeugs:

• Marke und Modell: Pflichtfelder.
• Baujahr von und Baujahr bis: optional. Bleiben sie leer, gilt das Fahrzeug für alle Jahre. Ausgefüllt definieren sie einen Bereich: Ein Fahrzeug 2012–2019 erscheint in der Auswahl unter jedem Jahr dieses Bereichs.
• Motorisierung: optional, die feinste Ebene (zum Beispiel „1.2 PureTech“).
• Aktiv: Ein inaktives Fahrzeug erscheint nicht mehr in der Auswahl, behält seine Zuordnungen aber.

Produkte einem Fahrzeug zuordnen

Sobald das Fahrzeug gespeichert ist, erscheint unten im Formular ein Bereich Kompatible Produkte. Geben Sie mindestens zwei Zeichen (Name oder Referenz) im Suchfeld ein, klicken Sie auf ein Ergebnis, und das Produkt ist sofort zugeordnet. Das optionale Feld Notiz erlaubt es, den Umfang der Kompatibilität zu präzisieren: „nur Vorderachse“, „Schaltgetriebe“, „ab Fahrgestellnummer 12000″… Die Notiz erscheint in der Kompatibilitätstabelle auf der Produktseite.

CSV-Import

Für große Bestände ist der CSV-Import der empfohlene Weg. Die erwartete Datei hat sechs Spalten:

make;model;year_from;year_to;variant;references

Beispiel:

Peugeot;208;2012;2019;1.2 PureTech;BRK-P208-F|FLT-P208
Peugeot;208;2012;2019;1.6 BlueHDi;BRK-P208-F
HP;LaserJet Pro M404;;;;TNR-59A|TNR-59X

• Das Trennzeichen, Semikolon oder Komma, wird automatisch erkannt.
• Die Spalte references enthält die kompatiblen Produktreferenzen, getrennt durch einen senkrechten Strich.
• Die Spalten für Baujahr und Motorisierung dürfen leer bleiben.
• Ein bereits vorhandenes Fahrzeug wird nicht dupliziert: Seine Zuordnungen werden lediglich ergänzt.
• Am Ende des Imports zeigt ein Bericht, wie viele Fahrzeuge angelegt, wie viele Zuordnungen ergänzt wurden und wie viele Zeilen fehlerhaft waren.

CSV-Export

Die Schaltfläche CSV exportieren auf der Konfigurationsseite des Moduls lädt den gesamten Bestand im selben Format herunter. Praktisch, um die Daten in einer Tabellenkalkulation zu überarbeiten und wieder zu importieren.

Die Kundenreise

Fahrzeugauswahl

Der Kunde wählt seine Marke, dann sein Modell, dann (falls die Ebenen aktiv sind) sein Baujahr und seine Motorisierung. Jedes Menü wird aus dem vorherigen befüllt, ohne Seiten-Reload. Die Schaltfläche Suchen öffnet die Ergebnisseite, die die kompatiblen Produkte mit den nativen Kacheln Ihres Themes darstellt.

Das gewählte Fahrzeug wird anschließend gemerkt und auf allen Seiten wieder angezeigt, bis der Kunde es wechselt oder löscht.

Meine Garage

Die Schaltfläche Zu meiner Garage hinzufügen speichert das aktuelle Fahrzeug. Die Seite Meine Garage, erreichbar über das Kundenkonto, listet die gespeicherten Fahrzeuge auf und erlaubt es:

• ein Fahrzeug als aktuelles Fahrzeug festzulegen;
• direkt zu den kompatiblen Produkten eines Fahrzeugs zu springen;
• ein Fahrzeug aus der Garage zu entfernen.

Die Garage funktioniert auch für nicht angemeldete Besucher: Ihre Fahrzeuge bleiben erhalten und werden ihrem Konto automatisch zugeordnet, sobald sie sich anmelden oder ein Konto anlegen.

Auf der Produktseite

Ist die Kompatibilitätsprüfung aktiviert und ein aktuelles Fahrzeug gewählt, erscheint unter dem Preis ein Hinweis: grün, wenn das Produkt passt, sonst rot. Ohne gewähltes Fahrzeug lädt eine neutrale Meldung den Kunden ein, eines auszuwählen.

Ist die Kompatibilitätstabelle aktiviert, zeigt die Seite am Ende die vollständige Liste der kompatiblen Fahrzeuge, nach Marke gruppiert und aufklappbar, mit der jeweiligen Notiz, sofern vorhanden.

Häufige Fragen

Kann ich das Modul ohne Fahrzeugbezug nutzen?

Ja. Schalten Sie die Ebenen Baujahr und Motorisierung ab, benennen Sie die Bezeichnungen um, und das Modul wird zu einer Auswahl Marke / Serie, passend für Patronen, Hüllen, Haushaltsgeräteteile oder jeden Katalog, in dem die Kompatibilität den Kauf bestimmt.

Was passiert mit einer Zuordnung, wenn ich ein Produkt lösche?

Sie wird automatisch entfernt. Der Bestand behält keine verwaisten Zeilen.

Bremst die Auswahl meine Website aus?

Nein. Die Menüs werden bei Bedarf per AJAX befüllt, in nativem JavaScript und ohne jQuery-Abhängigkeit: Beim ersten Rendern wird nur die Markenliste geladen.

Ist das Modul multishop-fähig?

Ja. Produktzuordnungen und Kundengaragen respektieren den Shop-Kontext.