DF Fitment Finder: zoeken op voertuig en productcompatibiliteit

DF Fitment Finder voegt aan uw PrestaShop-winkel een zoekfunctie op compatibiliteit toe: de klant kiest zijn voertuig (of toestel) en de catalogus toont hem alleen nog de producten die daarop passen. Deze documentatie behandelt de installatie, de configuratie, het vullen van het voertuigenbestand en de weergave aan de frontzijde.

Installatie

1. Ga naar Modules > Modulebeheer en klik op Een module installeren.
2. Plaats het bestand dffitmentfinder.zip en start de installatie.
3. Klik op Configureren om bij de instellingen te komen.

De installatie maakt drie tabellen aan (voertuigenbestand, productkoppelingen, klantgarages), registreert de nodige hooks en voegt het tabblad Voertuigen toe onder het menu Catalogus. Er wordt geen enkele override op de kern geplaatst en er is geen Composer-afhankelijkheid nodig.

Configuratie

Zoekniveaus

De kiezer berust op vier niveaus: Merk, Model, Bouwjaar en Motorisering. De eerste twee staan altijd aan; de laatste twee schakelt u aan of uit naargelang uw catalogus.

• Bouwjaar gebruiken: uit te schakelen bij een catalogus zonder jaartalbegrip (printercartridges, telefoonhoesjes, onderdelen voor huishoudtoestellen).
• Motorisering gebruiken: uit te schakelen als het fijnste niveau van uw bestand het model is.

Zoeken kan zodra merk en model zijn ingevuld: de klant hoeft nooit tot het fijnste niveau te gaan.

Opschriften van de niveaus

Elk niveau heeft een opschrift dat u per taal kunt aanpassen. Standaard: Merk, Model, Bouwjaar, Motorisering. Pas ze aan uw sector aan:

• Auto-onderdelen: Merk / Model / Bouwjaar / Motorisering
• Printercartridges: Merk / Serie / (geen) / Referentie
• Telefoonhoesjes: Merk / Model
• Huishoudtoestellen: Fabrikant / Gamma / Bouwjaar / Referentie

Weergavezones

• In de header tonen: de kiezer verschijnt boven aan alle pagina’s.
• Op de startpagina tonen: de kiezer verschijnt in de inhoud van de startpagina.
• Widget: plaats de kiezer waar u wilt in uw thema met de Smarty-tag {widget name='dffitmentfinder'}.

Productfiche

• Compatibiliteitscontrole: toont onder de prijs een groene balk (het product past op het huidige voertuig), een rode balk (het past niet) of een neutrale balk (geen voertuig gekozen).
• Compatibiliteitstabel: toont onder aan de fiche de volledige lijst met geschikte voertuigen, per merk gegroepeerd en inklapbaar.

Resultaten per pagina

Aantal producten dat op de resultatenpagina wordt getoond. Standaardwaarde: 12.

Het voertuigenbestand vullen

Handmatige invoer

Ga naar Catalogus > Voertuigen. De knop Toevoegen opent het formulier van een voertuig:

• Merk en Model: verplicht.
• Beginjaar en Eindjaar: optioneel. Laat u ze leeg, dan geldt het voertuig voor alle jaren. Vult u ze in, dan bepalen ze een bereik: een voertuig 2012–2019 verschijnt voor elk jaar uit dat bereik in de kiezer.
• Motorisering: optioneel, dit is het fijnste niveau (bijvoorbeeld « 1.2 PureTech »).
• Actief: een inactief voertuig verschijnt niet meer in de kiezer maar behoudt zijn koppelingen.

Producten aan een voertuig koppelen

Zodra het voertuig is opgeslagen, verschijnt onder aan het formulier een paneel Compatibele producten. Typ minstens twee tekens (naam of referentie) in het zoekveld, klik op een resultaat, en het product is meteen gekoppeld. Het optionele veld Opmerking laat u de reikwijdte van de compatibiliteit verduidelijken: « alleen vooras », « handgeschakelde bak », « vanaf chassisnummer 12000 » en dergelijke. Die opmerking verschijnt in de compatibiliteitstabel op de productfiche.

CSV-import

Voor omvangrijke bestanden is de CSV-import de aangewezen weg. Het verwachte bestand telt zes kolommen:

make;model;year_from;year_to;variant;references

Voorbeeld:

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

• Het scheidingsteken, puntkomma of komma, wordt automatisch herkend.
• De kolom references bevat de compatibele productreferenties, gescheiden door een verticale streep.
• De kolommen voor jaartallen en motorisering mogen leeg blijven.
• Een voertuig dat al in het bestand staat, wordt niet gedupliceerd: de koppelingen worden eenvoudigweg aangevuld.
• Aan het einde van de import toont een rapport hoeveel voertuigen zijn aangemaakt, hoeveel koppelingen zijn toegevoegd en hoeveel regels een fout gaven.

CSV-export

De knop Exporteren naar CSV op de configuratiepagina van de module downloadt het volledige bestand in hetzelfde formaat. Handig om de gegevens in een rekenblad te bewerken en daarna opnieuw te importeren.

Het klanttraject

Het voertuig kiezen

De klant kiest zijn merk, daarna zijn model, en vervolgens (als die niveaus actief zijn) zijn bouwjaar en motorisering. Elk menu wordt op basis van het vorige gevuld, zonder de pagina te herladen. De knop Zoeken opent de resultatenpagina, die de compatibele producten toont met de native miniaturen van uw thema.

Het gekozen voertuig wordt daarna onthouden en op alle pagina’s herhaald, tot de klant het wijzigt of wist.

Mijn garage

De knop Aan mijn garage toevoegen bewaart het huidige voertuig. De pagina Mijn garage, bereikbaar vanuit de klantenzone, toont de bewaarde voertuigen en laat toe om:

• een voertuig als huidig voertuig aan te duiden;
• meteen de producten te bekijken die met een voertuig compatibel zijn;
• een voertuig uit de garage te verwijderen.

De garage werkt ook voor niet-ingelogde bezoekers: hun voertuigen blijven bewaard en worden automatisch aan hun account gekoppeld zodra zij inloggen of een account aanmaken.

Op de productfiche

Staat de compatibiliteitscontrole aan en is er een huidig voertuig gekozen, dan verschijnt onder de prijs een balk: groen als het product past, rood als het niet past. Is er geen voertuig gekozen, dan nodigt een neutrale melding de klant uit er een te kiezen.

Staat de compatibiliteitstabel aan, dan toont de fiche onderaan de volledige lijst met geschikte voertuigen, per merk gegroepeerd en inklapbaar, met de eventuele opmerking bij elke koppeling.

Veelgestelde vragen

Kan ik de module gebruiken zonder voertuigen?

Ja. Schakel de niveaus Bouwjaar en Motorisering uit, hernoem de opschriften, en de module wordt een kiezer Merk / Serie die past bij cartridges, hoesjes, onderdelen voor huishoudtoestellen of elke catalogus waar compatibiliteit de aankoop bepaalt.

Wat gebeurt er met een koppeling als ik een product verwijder?

Die wordt automatisch verwijderd. Het bestand houdt geen weesregels over.

Vertraagt de kiezer mijn site?

Nee. De menu’s worden op aanvraag via AJAX gevuld, in pure JavaScript en zonder jQuery-afhankelijkheid: bij de eerste weergave wordt alleen de merkenlijst geladen.

Werkt de module in multistore?

Ja. De productkoppelingen en de klantgarages respecteren de winkelcontext.

Plaatsingen, icoon en indeling (v1.1.0)

Sinds versie 1.1.0 zijn de schakelaars „Tonen in de header” en „Tonen op de homepage” vervangen door een blok Selector tonen op: zeven selectievakjes voor de gangbare theme-plaatsingen (header, balk onder de header, homepage, bovenkant van de content, linker- en rechterkolom, boven de footer). Het veld Eigen hooks accepteert daarnaast je eigen display-hooks, gescheiden door komma’s: ze worden bij het opslaan automatisch geregistreerd. De widget {widget name='dffitmentfinder'} blijft werken, onafhankelijk van deze instellingen.

• Voertuigicoon: zes meegeleverde varianten (auto, garage, printer, telefoon, sleutel, chip), geen icoon, of je eigen PNG-, JPG- of SVG-afbeelding, geüpload vanuit de configuratie. Het icoon verschijnt op de opslaanknop, de badge van het huidige voertuig, de garagepagina en de controle op de productpagina.
• Desktopindeling: horizontaal (velden op één rij) of verticaal (gestapelde velden). Op mobiel stapelt de selector zich altijd verticaal.

Globaal voertuigfilter (v1.2.0)

De instelling Categoriepagina’s filteren op het gekozen voertuig, standaard ingeschakeld, breidt de selectie uit naar de hele winkel: zolang een voertuig actief is, tonen categorie-, merk- en leverancierspagina’s alleen passende producten, met de native sortering en paginering van je theme.

Boven de lijst verschijnt een balk met het actieve voertuig en twee acties:

• Alle producten tonen: pauzeert het filter 30 dagen (of tot het opnieuw wordt ingeschakeld). De balk blijft zichtbaar en biedt dan aan het filter opnieuw in te schakelen.
• Voertuig wisselen: linkt terug naar de selector.