# 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… - Pagina: - Taal: nl - Bijgewerkt op: 2026-09-15 - Andere talen: [fr](https://www.datafirefly.com/documentation/dffitmentfinder/index.md), [en](https://www.datafirefly.com/en/documentation/dffitmentfinder/index.md), [es](https://www.datafirefly.com/es/documentation/dffitmentfinder/index.md), [de](https://www.datafirefly.com/de/documentation/dffitmentfinder/index.md), [it](https://www.datafirefly.com/it/documentation/dffitmentfinder/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffitmentfinder/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffitmentfinder/index.md) - Index: 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. Compatibel met PrestaShop 8.0 tot 9.x en PHP 7.4 tot 8.3, zowel met één winkel als in multistore. ## 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. Als Gefacetteerd zoeken (ps_facetedsearch) actief is, neemt het voertuigfilter deze pagina's tijdelijk over zolang een voertuig is gekozen: paginering, tellers en sortering blijven exact. De facetfilters komen terug zodra de klant het filter pauzeert of het voertuig wist.