# DataFirefly Dealer Locator: catalogusmodus en dealerkaart > Deze module maakt van een PrestaShop 8- of 9-winkel een etalage voor uw merk: ze schakelt online verkoop uit voor de hele catalogus of een deel ervan, voegt een knop… - Pagina: - Taal: nl - Bijgewerkt op: 2026-10-07 - Andere talen: [fr](https://www.datafirefly.com/documentation/dfdealerlocator/index.md), [en](https://www.datafirefly.com/en/documentation/dfdealerlocator/index.md), [es](https://www.datafirefly.com/es/documentation/dfdealerlocator/index.md), [de](https://www.datafirefly.com/de/documentation/dfdealerlocator/index.md), [it](https://www.datafirefly.com/it/documentation/dfdealerlocator/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdealerlocator/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdealerlocator/index.md) - Index: Deze module maakt van een PrestaShop 8- of 9-winkel een etalage voor uw merk: ze schakelt online verkoop uit voor de hele catalogus of een deel ervan, voegt een knop Waar te koop toe op de productpagina's en publiceert een dealeroverzicht met kaart, openingstijden, contactformulier en een pagina per dealer. ## Installatie 1. Klik in **Modules > Modulebeheer** op **Een module uploaden** en selecteer het ZIP-bestand. 2. De module maakt het menu **Verkopen > Dealernetwerk** aan met drie onderdelen: Dealers, Contactaanvragen en Instellingen. 3. De overzichtspagina wordt automatisch aangemaakt met een vertaalde URL per taal: `/waar-te-koop`, `/where-to-buy`, `/ou-acheter`, `/wo-kaufen`, enzovoort. Om bij te werken uploadt u gewoon het nieuwe ZIP-bestand: de upgradescripts voegen ontbrekende kolommen en hooks toe. Geven het overzicht of de dealerpagina's een 404-fout, sla dan eenmaal **Winkelinstellingen > Verkeer & SEO** op om het .htaccess-bestand opnieuw te genereren. Compatibiliteit: PrestaShop 8.0 tot 9.x, multistore, geen Composer-afhankelijkheid. Vertalingen inbegrepen in het Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees. ## De catalogusmodus instellen Open **Dealernetwerk > Instellingen**, blok **Catalogusmodus**. De catalogusmodus wordt tijdens het laden toegepast: de standaardinstelling van PrestaShop wordt nooit gewijzigd en alles wordt weer normaal als u de module uitschakelt. ### Online verkoop - **Ingeschakeld**: de catalogusmodus staat uit, de module werkt alleen als overzicht. - **Uitgeschakeld voor de hele catalogus**: geen enkel product kan nog in de winkelwagen. - **Alleen uitgeschakeld voor de selectie**: alleen de hieronder gekozen categorieën, merken en producten gaan in catalogusmodus. - **Uitgeschakeld voor alles behalve de selectie**: de selectie blijft online te koop, de rest gaat in catalogusmodus. ### Prijzen, melding en winkelwagen - **Prijzen verbergen**: uitgeschakeld blijven de prijzen zichtbaar. U kunt dan een label onder de prijs tonen, standaard Adviesprijs. - **Melding op de productpagina**: tekst boven de knop, bijvoorbeeld Dit product is uitsluitend verkrijgbaar bij onze erkende dealers. Leeg laten om hem te verbergen. - **Winkelwagen en bestelproces doorsturen naar het dealeroverzicht**: in volledige catalogusmodus sturen de winkelwagen- en bestelpagina door naar het overzicht. De winkelwagen wordt aan de serverkant geblokkeerd: een via een URL afgedwongen toevoeging wordt geweigerd. ### Vrijgestelde klantengroepen Vink de groepen aan die online kunnen blijven bestellen. Voorbeeld: een klantengroep Dealers die haar voorraad op de site bestelt terwijl het publiek alleen de catalogus ziet. ## De knop Waar te koop Blok **Knop Waar te koop** van de instellingen: - **Betrokken producten**: alleen producten die niet online gekocht kunnen worden, of alle producten. - **Knoptekst**, vertaalbaar. - **Bij klikken**: een venster openen met de kaart en de dealers van het product, of naar het overzicht gaan gefilterd op het product. - **Beschikbaarheid onder de knop tonen**: Verkrijgbaar bij 14 dealers, daarna de dichtstbijzijnde dealer zodra de bezoeker al eens een locatie heeft gezocht. - **Online verkopers tonen**: dealers van het type Online verkoper worden apart getoond, met een knop naar het product in hun winkel. De knop toont alleen de dealers die het product verkopen (tabblad Verkochte producten van elke dealer). Het venster opent op de laatst gezochte plaats van de bezoeker. ## Overzicht en kaart Blok **Dealeroverzicht en kaart**: - **Introductietekst** boven de zoekfunctie en **accentkleur** van knoppen, markeringen en groepen. - Standaard **kaartmidden en zoom**, **afstandseenheid** (km of mijl), **keuzes voor de zoekstraal**, **standaardstraal** (0 = geen limiet) en **maximaal aantal resultaten**. - **Kaartstijl**: CARTO Voyager, CARTO Positron, OpenStreetMap of eigen tegelserver (https-URL met {z}, {x} en {y}). - **Vragen voordat de kaart wordt geladen**: voor de AVG ontvangt de tegelserver het IP-adres van de bezoeker pas na een klik. - **Nabije markeringen groeperen** en **één markeringskleur per dealertype**, met legenda op de kaart. - **Volledige dealerlijst per land** onder de kaart, leesbaar voor zoekmachines. - **Een pagina per dealer**: zie verderop. De bezoeker zoekt op plaats of postcode, of gebruikt zijn locatie. Hij kan filteren op dealertype en Nu open aanvinken. Op mobiel schakelt een knop tussen lijst en kaart. De Leaflet-kaart wordt in de module gehost: er is geen API-sleutel nodig. ## Geocodering Geocodering zet een adres of plaats om in coördinaten. De resultaten worden in de database gecachet. - **OpenStreetMap Nominatim**: gratis, beperkt tot één verzoek per seconde. Vul het **contact-e-mailadres** in, aanbevolen door het gebruiksbeleid van Nominatim. - **Google Geocoding API**: vereist een Google API-sleutel. - **Zoekopdrachten beperken tot deze landen**: ISO-codes gescheiden door komma's, bijvoorbeeld `nl,be,lu`. ## Dealers beheren Menu **Dealernetwerk > Dealers**. Het dealerformulier heeft vier tabbladen. ### Algemeen - **Naam**, **type** (winkel, distributeur, showroom, servicepunt, online verkoper), **logo** (JPG, PNG, WebP of GIF, maximaal 2 MB). - **Partner**: badge Officiële partner, bovenaan getoond als er geen locatie is opgegeven. - **Telefoon**, **website** en **e-mail**: het e-mailadres ontvangt de contactaanvragen en wordt nooit getoond als het contactformulier actief is. - **Productlink in de winkel van de dealer**: optioneel, voegt een knop Online kopen toe. Beschikbare tags: `{reference}` `{ean13}` `{upc}` `{mpn}` `{name}` `{id_product}`. Voorbeeld: `https://shop.example.com/search?q={ean13}` - **Toegang tot de dealeromgeving**: e-mailadres van een bestaand klantaccount (zie Dealeromgeving). ### Adres en kaart De dealer wordt bij het opslaan automatisch op de kaart geplaatst. De knop **Positie bepalen vanuit het adres** start de geocodering opnieuw, en u kunt op de kaart klikken of de markering verslepen om de positie aan te passen. ### Beschrijving en openingstijden Meertalige beschrijving, rooster met openingstijden over 7 dagen met twee tijdvakken per dag (het tweede is voor de middagpauze), knoppen om maandag naar de andere dagen te kopiëren en veld **Goed om te weten** voor feestdagen of seizoenssluitingen. Een lege dag betekent gesloten. De openingstijden sturen de badge en de filter Nu open aan, berekend in de tijdzone van de winkel. ### Verkochte producten Kies **Het hele assortiment** of een selectie van categorieën, merken en producten. Alleen de dealers die een product verkopen, verschijnen in de knop Waar te koop van dat product. ## CSV-import en -export Knop **CSV importeren** van de dealerlijst. Formaat: UTF-8, gescheiden door puntkomma's, eerste regel met de kolomnamen. Het eenvoudigst is om eerst uw dealers te exporteren voor een kant-en-klaar bestand. Kolommen: `id;name;type;active;featured;address1;address2;postcode;city;country_iso;phone;email;website;product_url;latitude;longitude;scope;categories;manufacturers;products;description;hours;opening` - Alleen `name` is verplicht. Laat `id` leeg om een dealer aan te maken, of vink het bijwerken van bestaande dealers aan. - `type`: retailer, distributor, showroom, service of online. `country_iso`: code van twee letters. - `scope`: 0 voor het hele assortiment, 1 voor de vermelde categorieën, merken en producten, gescheiden door een verticale streep: `3|8|12`. - `opening`: dagnummer (1 = maandag) en daarna tijdvakken, dagen gescheiden door een schuine streep: `1=09:00-12:00,14:00-19:00/2=09:00-19:00/6=10:00-18:00` Klik na een import zonder coördinaten op **Geïmporteerde dealers op de kaart plaatsen**: de geocodering verloopt in bulk, één adres per seconde. Houd de pagina open tijdens de bewerking. ## Contactaanvragen Blok **Contactaanvragen** van de instellingen: schakel het formulier bij elke dealer in, het versturen per e-mail naar de dealer, een kopie naar uw adres, de tekst van het toestemmingsvakje en de pagina met het privacybeleid. Het formulier is beveiligd tegen spam (valveld, minimale invultijd, vijf verzendingen per uur per IP-adres). De aanvragen staan in **Dealernetwerk > Contactaanvragen**, met filters, detailweergave, status behandeld of te behandelen en CSV-export. ## Dealeromgeving Schakel **Dealeromgeving in het klantaccount** in en vul vervolgens in het formulier van een dealer het e-mailadres van een bestaand klantaccount in. Na het inloggen ziet deze klant een tegel **Dealeromgeving** in Mijn account. Hij kan daar: - telefoon, website, openingstijden, Goed om te weten en beschrijving in zijn taal aanpassen; - zijn contactaanvragen lezen en als behandeld markeren; - zijn statistieken van de laatste 30 dagen bekijken: websitebezoeken, klikken op het telefoonnummer, routes, aanvragen. Adres en kaartpositie blijven in beheer van het merk. Eén account kan meerdere dealers beheren. ## Dealerpagina's en SEO Met de optie **Een pagina per dealer** krijgt elke dealer (behalve online verkopers) een pagina zoals `/waar-te-koop/12/lumiere-co-lyon`: adres, kaart, openingstijden, beschrijving, contactformulier en dealers in de buurt. De pagina's bevatten gestructureerde gegevens Store met openingstijden in schema.org en een canonieke URL, en sturen met een 301 door als naam of plaats wijzigt. Ze worden automatisch aan de sitemap toegevoegd als de Google Sitemap-module (gsitemap) is geïnstalleerd. ## Statistieken De configuratiepagina toont de activiteit van de laatste 30 dagen: meest gecontacteerde dealers met de klikken in detail (website, telefoon, route, online kopen, aanvragen) en producten met de meeste klikken op Waar te koop. ## Integratie in het thema De knop wordt automatisch getoond via de hook `displayProductAdditionalInfo`. Om hem elders te plaatsen, gebruikt u de widget: - zoekveld voor dealers: `{widget name='dfdealerlocator'}` - knop Waar te koop van een product: `{widget name='dfdealerlocator' id_product=$product.id}` ## Problemen oplossen ### De kaart blijft grijs De tegelserver wordt waarschijnlijk geblokkeerd door een beveiligingsbeleid (CSP) of een firewall. Sta het domein van de gekozen stijl toe (basemaps.cartocdn.com of tile.openstreetmap.org) of gebruik een eigen server. ### De knop Waar te koop verschijnt niet Controleer of uw thema de hook `displayProductAdditionalInfo` aanroept op de productpagina en of de instelling Betrokken producten overeenkomt met het geteste product. Plaats anders de widget in de producttemplate. ### Een adres wordt niet gevonden Vul minstens de plaats of postcode en het land in en klik op Positie bepalen vanuit het adres. Wordt het adres nog steeds niet gevonden, plaats de markering dan handmatig op de kaart. ### 404-fout op het overzicht of een dealerpagina Genereer het .htaccess-bestand opnieuw door **Verkeer & SEO** op te slaan, en controleer of de vriendelijke URL van de pagina `module-dfdealerlocator-directory` in elke taal is ingevuld.