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 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.