DF Fitment Finder: zoeken op voertuig en productcompatibiliteit
DF Fitment Finder installeren en configureren, de voertuigdatabase importeren en SEO-pagina's per merk en model publiceren.
DF Fitment Finder voegt aan uw PrestaShop-winkel een zoekfunctie op compatibiliteit toe: de klant selecteert zijn voertuig (of apparaat) en de catalogus toont alleen nog de producten die daarop passen. Versie 2.0.0 maakt daarnaast van elk merk en model uit uw database een indexeerbare SEO-pagina. Deze documentatie behandelt de installatie, de configuratie, de voertuigdatabase, de SEO-pagina’s en het klanttraject.
Nieuw in 2.1.2
- Productpagina: in het blok Past het op uw voertuig? Selecteer het om te controleren. blijven de labels en lijsten van de selector nu uitgelijnd in hun kolommen bij thema’s zoals Classic.
Nieuw in 2.1.1
- Garage: de markering Huidig voertuig volgt nu het voertuig dat in de winkel is geselecteerd. Ze verdwijnt wanneer de bezoeker het voertuig wist (Mijn voertuig wissen) of een ander voertuig kiest in de selector, en Als huidig instellen wordt weer aangeboden. Opgeslagen voertuigen blijven bewaard.
- Facetzoeken 5.x: getest met ps_facetedsearch 5.1.0 op PrestaShop 8.2.1. De facetten blijven beschikbaar zolang er een voertuig is geselecteerd.
Nieuw in 2.1.0
- Facetzoeken blijft beschikbaar als een voertuig is gekozen: de facetten voor prijs, beschikbaarheid en kenmerken blijven beschikbaar en tellen alleen passende producten.
- Voertuigfilter te beperken tot gekozen categorieën, met een aparte optie voor merk- en leverancierspagina’s.
- Derde badgestatus voor producten zonder compatibiliteitsgegevens: “te controleren, vraag het ons” met een link (optioneel).
- Integratie: PHP-hook en JavaScript-events wanneer een bezoeker een voertuig selecteert of wist, cachevriendelijke modus voor full-page caches en CDN’s zoals Cloudflare.
- CSV-import in stappen: grote bestanden worden geïmporteerd in stappen van ongeveer 15 seconden, met een voortgangsbalk.
- Correctie: op PrestaShop 1.7.8 werkt het voertuigfilter nu op categorie-, merk- en leverancierspagina’s.
Facetzoeken en het voertuigfilter
In Weergave-instellingen heeft de optie Facetzoeken als een voertuig is gekozen twee waarden:
- Facetten behouden (aanbevolen): de module Facetzoeken blijft de productlijst en de facetten opbouwen, beperkt tot de producten die op het voertuig passen. De tellers naast elke facetwaarde tellen alleen passende producten. Hiervoor is een recente versie 4.x of 5.x van Facetzoeken nodig die de hook
actionFacetedSearchFiltersbiedt (bijvoorbeeld versie 4.0.4, meegeleverd met PrestaShop 9.1.5, of 5.1.0 op PrestaShop 8.2). - Facetzoeken vervangen door het voertuigfilter: de module toont de gefilterde lijst zelf, zonder facetten. Dit gebeurt ook automatisch wanneer Facetzoeken is uitgeschakeld of te oud is; de beschrijving onder de optie geeft aan welk geval voor uw winkel geldt.
In beide gevallen kan de bezoeker het filter in de productlijst pauzeren met Alle producten weergeven.
Het filter beperken tot bepaalde categorieën
Vink de categorieën aan in Categorieën gefilterd op voertuig: het filter geldt voor deze categorieën en hun subcategorieën. Laat alles uitgevinkt om alle categorieën te filteren. Vink bijvoorbeeld uw categorieën met onderdelen aan, maar niet kleding of smeermiddelen. Ook merk- en leverancierspagina’s filteren schakelt het filter voor deze pagina’s in of uit.
Producten zonder compatibiliteitsgegevens
De optie Producten zonder compatibiliteitsgegevens bepaalt wat de productpagina toont wanneer een product aan geen enkel voertuig is gekoppeld:
- Niets tonen (standaard): geen badge.
- ‘Te controleren, vraag het ons’ met een link tonen: een amberkleurige melding, per taal te bewerken in Melding ‘Te controleren’, met een link naar de contactpagina of naar de volledige URL die u invult in Link ‘Vraag het ons’ (bijvoorbeeld een CMS-pagina of een formulier).
Full-page cache en CDN (Cloudflare)
Het geselecteerde voertuig en de garage worden op de server opgeslagen: in de PrestaShop-cookie voor gasten, in de database voor ingelogde klanten. Als uw pagina’s in hun geheel in de cache worden bewaard (Cloudflare, Varnish, een module voor paginacache), schakel dan Cachevriendelijke modus in bij Weergave-instellingen:
- pagina’s worden geleverd zonder het voertuig van de bezoeker en zonder persoonlijk token: de selector, “Mijn voertuig” en de productbadge worden door de browser ingevuld nadat de pagina is geladen;
- een gewone cookie
dff_v=1wordt geplaatst zolang er een voertuig is geselecteerd (endff_gf_off=1zolang de bezoeker het categoriefilter heeft gepauzeerd).
Voeg op uw CDN een regel toe die de cache omzeilt voor verzoeken met de cookie dff_v op categorie-, merk- en leverancierspagina’s wanneer het voertuigfilter is ingeschakeld, omdat hun productlijst van het voertuig afhangt. Bewaar het AJAX-adres van de module (/module/dffitmentfinder/ajax) en de zoek- en garagepagina’s nooit in de cache. Het tabblad Help van de module toont deze adressen voor uw winkel.
Integratie: events bij het selecteren van een voertuig
Telkens wanneer een bezoeker een voertuig selecteert, wijzigt of wist, activeert de module:
- in PHP de hook
actionDfFitmentVehicleChangemet de parametersaction(select of clear),vehicle_ids,label,selectionenid_customer; - in de browser het DOM-event
dffitmentfinder:vehiclechangeen het PrestaShop-eventdffVehicleChange.
document.addEventListener('dffitmentfinder:vehiclechange', function (e) {
// e.detail = { action: 'select' | 'clear', label: '…', landingUrl: '…' }
});
Grote CSV-bestanden
Na het voorbeeld verloopt de import in stappen van ongeveer 15 seconden, elk met een eigen verzoek, met een voortgangsbalk: een groot bestand loopt niet meer tegen de time-out van een proxy zoals Cloudflare (100 seconden) aan. Houd de pagina open totdat het rapport wordt getoond. De duur hangt af van uw server; op onze testserver ongeveer 100 regels per seconde.
Nieuw in 2.0.0
- SEO-pagina’s per merk en per model (optie): vertaalde URL’s zoals
/nl/compatibiliteit/peugeot/208, metatitel, meta-omschrijving, H1 en introductie in elke taal, canonical, hreflang, sitemap, 301-doorverwijzingen. - Vernieuwde back-office: dashboard met een checklist om aan de slag te gaan, beheer van merken en modellen, CSV-import met voorbeeld en foutenrapport.
- Productpagina: badge “passend / niet passend” met een compacte selector om een ander voertuig te controleren, filterbare compatibiliteitstabel met links naar de SEO-pagina’s.
- PrestaShop 1.7.8 tot 9, 8 talen, correcties op het gebied van beveiliging en betrouwbaarheid.
Installatie en update
- Ga naar Modules > Modulebeheer en klik op Upload een module.
- Sleep het bestand
dffitmentfinder-2.1.2.zipnaar het venster. Op een winkel met versie 1.x voert PrestaShop de update automatisch uit. - Klik op Configureren om het dashboard te openen.
De update behoudt al uw gegevens: voertuigen, productkoppelingen, garages van klanten en instellingen. Ze voegt de tabellen voor de SEO-pagina’s, een snellere index op de productkoppelingen en de nieuwe instellingen toe, en verwijdert het spookvoertuig “make / model” dat versie 1.x kon aanmaken wanneer een CSV-bestand met een BOM begon.
Compatibel met PrestaShop 1.7.8 tot 9.x, PHP 7.1 tot 8.5, de thema’s Classic en Hummingbird en hun child-thema’s, één winkel en multistore. Geen override op de kern, geen afhankelijkheden.
Dashboard
De configuratiepagina opent op een dashboard: aantal merken, modellen, voertuigen, producten met compatibiliteit, compatibiliteitskoppelingen en opgeslagen garagevoertuigen. De checklist Aan de slag begeleidt u door de vier stappen (voertuigen toevoegen, producten koppelen, de selector weergeven, de SEO-pagina’s publiceren), en het blok Aandachtspunten waarschuwt u voor voertuigen zonder product of voor uitgeschakelde vriendelijke URL’s.

Weergave-instellingen
Het tabblad Weergave-instellingen bepaalt de selector en de productpagina:
- Labels van de vier niveaus, per taal: Merk / Model / Bouwjaar / Uitvoering voor auto-onderdelen, Merk / Serie / Referentie voor cartridges.
- Niveaus bouwjaar en uitvoering: schakel ze uit voor catalogi zonder bouwjaren of motoren. Klanten kunnen altijd zoeken op alleen merk en model.
- Pictogram: auto, motorfiets, vrachtwagen, garage, printer, telefoon, moersleutel, chip, uw eigen PNG-, JPG- of SVG-afbeelding (scripts en externe inhoud worden geweigerd), of geen pictogram.
- Desktopweergave: horizontaal of verticaal. Op mobiel worden de velden van de selector altijd onder elkaar weergegeven.
- Selector weergeven op: zeven hooks van het thema, uw eigen weergavehooks, en de widget
{widget name='dffitmentfinder'}waar u wilt in uw templates. - Categoriepagina’s filteren op het geselecteerde voertuig: categorie-, merk- en leverancierspagina’s tonen alleen passende producten zolang er een voertuig is geselecteerd.
- Compatibiliteitstabel en badge “Past het op mijn voertuig?” op productpagina’s.
- Producten zonder voorraad verbergen in de compatibiliteitslijsten (producten die zonder voorraad besteld kunnen worden, blijven zichtbaar) en Producten per pagina (0 = hetzelfde als de categoriepagina’s).

De voertuigdatabase
Handmatige invoer
Ga naar Catalogus > Voertuigcompatibiliteit en klik op Voertuig toevoegen. Merk en model zijn verplicht; bouwjaren (1900 tot 2100) en uitvoering zijn optioneel, en een dubbel voertuig wordt geweigerd. Klik op Opslaan en blijven: het paneel Passende producten verschijnt. Typ minstens twee tekens van een productnaam of referentie, kies het product met de muis of de pijltjestoetsen, en voeg eventueel een opmerking toe zoals “alleen vooras”. In de lijst kunt u voertuigen in bulk inschakelen, uitschakelen en verwijderen.

CSV-import met voorbeeld
Het tabblad Import / export analyseert uw bestand voordat er iets wordt weggeschreven: aantal regels, nieuwe en bestaande voertuigen, gevonden productkoppelingen en regels met waarschuwingen, plus een voorbeeld van de eerste regels met de status van elke regel (onbekende referentie, ongeldig bouwjaar, ontbrekend merk of model).
make;model;year_from;year_to;variant;references;note;active
Peugeot;208;2019;2023;1.2 PureTech 100;BRK-208-F|OIL-PT12;Front axle;1
Peugeot;208;2012;2019;;BRK-208-F;;1
- Het scheidingsteken “;” “,” of tab en de codering UTF-8 of Windows-1252 (Excel) worden automatisch gedetecteerd; met een kopregel mogen de kolommen in willekeurige volgorde staan.
- references: product- of combinatiereferenties, gescheiden door “|”.
- Bouwjaren, uitvoering, referenties, opmerking en actief zijn optioneel. Bestaande voertuigen worden hergebruikt: hetzelfde bestand twee keer importeren maakt geen duplicaten aan.
- Optie Productkoppelingen van de voertuigen in het bestand vervangen: koppelingen van deze voertuigen die niet in het bestand staan, worden verwijderd.

Na de import toont het rapport de aangemaakte en bijgewerkte voertuigen, de aangemaakte en verwijderde koppelingen en de te controleren regels. De volledige lijst met fouten kan als CSV-bestand worden gedownload.

CSV-export
De export downloadt de volledige database in hetzelfde formaat, inclusief opmerkingen en de actieve status, zodat u ze in een spreadsheet kunt bewerken en opnieuw kunt importeren. Referenties worden nooit afgekapt, en cellen die met = + – @ beginnen, worden beschermd tegen spreadsheetformules (de bescherming wordt bij het importeren weer verwijderd).
Merken en modellen
Het tabblad Merken & modellen groepeert uw voertuigen per merk en vervolgens per model, met de bouwjaren, het aantal voertuigen en producten, de URL van de pagina en de status ervan (indexeerbaar, noindex, geen actief voertuig, niet gepubliceerd). Via het menu van elke regel kunt u de pagina bekijken, de voertuigen openen, de pagina publiceren of de publicatie intrekken, noindex afdwingen, of het merk of het model in één keer op elk voertuig hernoemen: de oude URL’s blijven doorverwijzen (301).


SEO-pagina’s per merk en model
De SEO-pagina’s zijn een optie die standaard is uitgeschakeld. Zodra u ze in het tabblad SEO-pagina’s inschakelt, publiceert de module een indexpagina van de merken, een pagina per merk en een pagina per merk + model, automatisch aangemaakt op basis van uw voertuigdatabase.
Adressen
Elke taal heeft een eigen URL-prefix (standaard compatibilite, compatibility, compatibilidad, kompatibilitaet, compatibilita, kompatybilnosc, compatibiliteit, compatibilidade), gevolgd door de slugs van het merk en het model: /nl/compatibiliteit/peugeot/208, /fr/compatibilite/peugeot/208. Een gewijzigde prefix of slug blijft antwoorden met een 301-doorverwijzing naar het nieuwe adres. Vriendelijke URL’s moeten zijn ingeschakeld in Winkelparameters > Verkeer & SEO om nette adressen te krijgen.

Standaardteksten met variabelen
De metatitel, meta-omschrijving, H1 en introductie van elke pagina komen uit standaardteksten, per taal en per niveau (modelpagina’s, merkpagina’s, indexpagina). Ze accepteren de variabelen {brand}, {model}, {count} (aantal passende producten), {years} en {shop}. Een Google-voorbeeld en tekentellers worden bijgewerkt terwijl u typt.

Een pagina bewerken
Klik op SEO & teksten bij een merk of model om per taal de URL-slug, metatitel, meta-omschrijving, H1 en introductie (eenvoudige HTML toegestaan) te overschrijven. Lege velden blijven de standaardteksten gebruiken, die grijs worden weergegeven. De publicatie van de pagina kan ook worden ingetrokken (ze geeft dan een 404) of er kan noindex worden afgedwongen.

Schrijf een specifieke introductie voor uw belangrijkste merken en modellen: unieke inhoud doet meer voor deze pagina’s dan alleen sjablonen.
Wat de pagina’s tonen
De indexpagina toont de merken met hun aantal passende producten. Een merkpagina toont de modellen en daarna alle passende producten. Een modelpagina biedt filters op bouwjaar of uitvoering en de productlijst, met de sortering, paginering en productminiaturen van uw thema (Classic, Hummingbird en hun child-thema’s). Met de knop “Dit is mijn voertuig” selecteert de bezoeker het voertuig.




Indexeringsregels
- Canonical op elke pagina (met het paginanummer), hreflang naar elke taal plus x-default, kruimelpad.
- noindex: automatisch voor pagina’s zonder producten (optie), afgedwongen per pagina, globale optie, en op gesorteerde of gefilterde varianten (filter op bouwjaar of uitvoering).
- Gestructureerde gegevens BreadcrumbList en ItemList, geleverd door het thema of, bij thema’s zonder deze gegevens, door de module.
- Sitemap: de indexeerbare pagina’s worden aan de Google sitemap-module (gsitemap) toegevoegd wanneer die opnieuw genereert; zonder deze module biedt de module een eigen XML-sitemap met hreflang-alternatieven, in te dienen bij Search Console.
- Interne links: index → merken → modellen, compatibiliteitstabel op productpagina’s, link “Bijbehorende pagina bekijken” bij het onthouden voertuig, link vanuit de zoekresultaten.
- Prestaties: productaantallen worden in de cache bewaard en opnieuw berekend na elke wijziging van de compatibiliteitsgegevens of na een instelbare termijn.
De zoekresultatenpagina van de selector behoudt haar URL-parameters (make, model, year, id_vehicle): uw bestaande links vanuit menu’s en CMS-pagina’s blijven werken. Ze staat op noindex, omdat de SEO-pagina’s de indexeerbare pagina’s zijn.
Het klanttraject
Het voertuig selecteren
De klant kiest het merk, dan het model en daarna eventueel het bouwjaar en de uitvoering. Elke lijst wordt op basis van de vorige gevuld zonder de pagina te herladen, en wordt aangekondigd aan schermlezers. Onderdelen weergeven opent de passende producten, Opslaan in mijn garage onthoudt het voertuig. Het geselecteerde voertuig blijft onthouden, vooraf ingevuld in de selector en getoond met een link naar de bijbehorende pagina, totdat de klant het wijzigt of wist.
Op de productpagina
De badge geeft meteen antwoord: passend in het groen, niet passend in het rood met een link naar de onderdelen die wel passen, of een uitnodiging om een voertuig te selecteren. Ander voertuig controleren opent een compacte selector direct in de badge.


Daaronder toont de compatibiliteitstabel alle passende voertuigen, gegroepeerd per merk, met een filterveld bij lange lijsten, het voertuig van de klant gemarkeerd en links naar de merk- en modelpagina’s.

Mijn garage
De pagina Mijn garage, ook gelinkt vanuit het klantaccount (Classic en Hummingbird), toont de opgeslagen voertuigen: passende producten, als huidig instellen, verwijderen. Garages van gasten worden bij het inloggen en bij het aanmaken van een account aan het klantaccount gekoppeld.

Veelgestelde vragen
Kan ik indexeerbare pagina’s per merk en model aanmaken?
Ja, sinds versie 2.0.0, met de optie SEO-pagina’s: één pagina per merk en per merk + model, met een vertaalde URL, metatags, H1 en introductie in elke taal, canonical, hreflang, gestructureerde gegevens en sitemap. Posities in zoekmachines hangen af van veel factoren: de module levert nette, indexeerbare pagina’s, maar kan geen posities garanderen.
Werken mijn bestaande links naar de resultatenpagina nog?
Ja. De zoekpagina behoudt haar parameters make, model, year en id_vehicle, en de oude parameter p van de paginering.
Kan ik de module zonder voertuigen gebruiken?
Ja. Schakel de niveaus bouwjaar en uitvoering uit, hernoem de labels, en de module wordt een selector Merk / Serie voor cartridges, telefoonhoesjes, onderdelen voor huishoudapparaten of elke catalogus waarin compatibiliteit de aankoop bepaalt.
Wat gebeurt er met een koppeling als ik een product verwijder?
Die wordt automatisch verwijderd, en de aantallen van de SEO-pagina’s worden vernieuwd.
Is de module compatibel met multistore?
Ja. Producten worden per winkel gefilterd, en de SEO-teksten, slugs en aantallen worden per winkel en per taal opgeslagen.
Werkt het voertuigfilter samen met Facetzoeken?
Ja. Sinds versie 2.1.0 blijven de facetten met een recente versie 4.x of 5.x van Facetzoeken beschikbaar zolang er een voertuig is geselecteerd, en tellen ze alleen passende producten. Met een oudere versie toont de module de gefilterde lijst zelf, zonder facetten. U kunt het filter ook beperken tot bepaalde categorieën.
Werkt de module achter Cloudflare of een full-page cache?
Ja, met de cachevriendelijke modus: pagina’s bevatten geen bezoekersgegevens en de browser laadt het voertuig daarna. Voeg voor gefilterde productlijsten een regel toe die de cache omzeilt bij de cookie dff_v, en bewaar het AJAX-adres van de module nooit in de cache.