Dealer Locator configureren in Magento 2
Op zoek naar Dealer Locator? Bekijk de volledige Dealer Locator pagina voor functies, configuratieopties en prijzen.
Hier vind je alle instellingen van de Dealer Locator, in gewone taal uitgelegd. We volgen de volgorde van het admin panel: de module aanzetten, kiezen tussen OpenStreetMap en Google Maps, het startpunt van de kaart, hoe resultaten worden getoond, het adres van de pagina en de teksten voor zoekmachines, en de privacy-instelling voor cookietoestemming. Per instelling lees je wat die doet en wanneer je hem aanpast, met aanbevelingen waar die echt verschil maken. De meeste winkels passen er maar een handvol aan; de standaardwaarden zijn zo gekozen dat de pagina zonder verdere instellingen werkt. Instellingen die per store view kunnen verschillen, zoals het adres of de titel van de pagina, stel je zoals gewoonlijk in op de scope van de store view.
Volledig overzicht van alle instellingen van de Dealer Locator.
Locatie: Winkels → Configuratie → Magmodules → Dealer Locator
Branding
Toont de geïnstalleerde versie en heeft knoppen voor de zelftest en de handleiding. Gebruik Zelftest uitvoeren nadat je de kaartinstellingen hebt aangepast: die controleert of de gekozen kaartaanbieder de sleutels heeft die hij nodig heeft, of het opzoeken van een adres werkt en hoeveel dealers de pagina moet tonen.
Algemeen
Ingeschakeld
Zet de dealerpagina in de webwinkel aan of uit. Zolang hij uit staat, geeft het adres van de pagina een "pagina niet gevonden", maar je kunt in de admin al wel dealers beheren en importeren.
Kaart & geocoding
"Geocoding" betekent een adres omzetten naar coördinaten op de kaart. De module doet dat op twee plekken: in de admin, als je een dealer opslaat of importeert, en in de browser van de bezoeker, als die een plaats zoekt.
Kaartaanbieder
Welke dienst de kaart tekent en adressen opzoekt.
- OpenStreetMap (gratis, geen API-sleutel): werkt direct na installatie. Adressen worden opgezocht via de Nominatim-dienst van OpenStreetMap, die één opzoeking per seconde toestaat. Dat is ruim genoeg voor zoekende bezoekers, maar maakt grote imports trager (zie de importhandleiding).
- Google Maps (API-sleutel nodig): de bekende Google-kaart en de zoekfunctie van Google. Je hebt een Google Cloud-project met facturering nodig en twee sleutels (hieronder). Google geeft een gratis gebruikstegoed per maand; bekijk de actuele prijzen van Google voor jouw verwachte bezoekersaantal.
Wanneer gebruiken:
- OpenStreetMap: je wilt direct beginnen, geen kosten maken of liever geen Google gebruiken.
- Google Maps: je wilt de kaartstijl en zoekkwaliteit van Google, of je klanten verwachten het.
Google Maps browser-API-sleutel
Alleen zichtbaar bij Google Maps. Wordt gebruikt door de kaart en het zoeken op plaats in de browser van de bezoeker. Omdat de browser hem nodig heeft, is deze sleutel zichtbaar in de broncode van je pagina; dat is normaal bij Google Maps, zolang je hem beperkt.
Aanbevolen:
- Beperk hem in Google Cloud tot het domein van je winkel (HTTP-referrers, bijv.
https://example.com/*) - Sta alleen de Maps JavaScript API en de Geocoding API toe
- Vul hier nooit de serversleutel in: iedereen kan deze sleutel uit de broncode van je pagina kopiëren
API-sleutel testen: controleert de sleutel in het veld, ook voordat je opslaat. Je browser laadt de Maps JavaScript API en doet één zoekopdracht op adres met de sleutel, en de server controleert of de sleutel beperkt is tot websites. Elk onderdeel toont OK of de reden van Google, zoals een domein dat niet is toegestaan of een API die niet aanstaat. Draait je admin op een ander domein dan je winkel, dan mislukt het browserdeel hier voor een sleutel die beperkt is tot het winkeldomein; dat staat dan in het resultaat.
Google Geocoding server-API-sleutel
Alleen zichtbaar bij Google Maps. Wordt door Magento zelf gebruikt om de coördinaten van dealers op te zoeken als je dealers opslaat of importeert. Hij wordt versleuteld opgeslagen en nooit naar de browser gestuurd.
Aanbevolen:
- Beperk hem tot het IP-adres van je server en alleen de Geocoding API
- Gebruik een andere sleutel dan de browsersleutel: een sleutel die beperkt is tot je domein (HTTP-referrers) werkt niet vanaf de server
API-sleutel testen: stuurt vanaf je server één verzoek naar de Geocoding API met de sleutel in het veld (of de opgeslagen sleutel, zolang het veld sterretjes toont) en toont het antwoord van Google.
Contact-e-mailadres voor Nominatim
Alleen zichtbaar bij OpenStreetMap. Optioneel e-mailadres dat wordt meegestuurd met het opzoeken van adressen, zodat het OpenStreetMap-team contact met je kan opnemen als je winkel opvallend veel verzoeken stuurt, zoals hun gebruiksvoorwaarden vragen. Bezoekers zien het niet.
Standaard breedtegraad / lengtegraad van het kaartmidden
Waar het midden van de kaart ligt voordat een bezoeker zoekt, zodra de pagina opent. Standaard is dat het midden van Nederland. Zodra de dealers geladen zijn, zoomt de kaart in op de dealers in de lijst; dit is dus vooral van belang als er nog geen dealers zijn of de kaart er geen kan tonen.
Voorbeeld: België: 50.5039 en 4.4699. Duitsland: 51.1657 en 10.4515.
Standaard zoomniveau
Hoe ver de kaart op dat startpunt is ingezoomd, van 1 (hele wereld) tot 20 (straatniveau). Met 7 zie je een land zo groot als Nederland; gebruik 5 of 6 voor Duitsland of Frankrijk.
Zoeken op adres beperken tot landen
Beperkt het zoeken op plaats door bezoekers tot deze landen. Dat is belangrijk bij korte of dubbelzinnige invoer: "9711" is een postcode in Groningen, maar bestaat ook in andere landen.
Wanneer gebruiken:
- Je verkoopt in een paar landen en wilt dat zoekopdrachten daarbinnen blijven.
Laat je het leeg, dan beperkt de pagina het zoeken tot de landen waar je dealers zitten (als dat er maximaal 5 zijn), en dat is meestal precies wat je wilt. Google Maps accepteert maximaal 5 landen; met meer landen wordt de instelling niet opgeslagen als Google gekozen is.
Resultaten
Resultaten per pagina
Hoeveel dealers de lijst toont vóór de knop Toon meer. Elke klik toont er weer zoveel bij.
Afstandseenheid
Kilometer of mijl voor de afstanden in de lijst. Je kunt dit per store view instellen, bijvoorbeeld mijl voor een Britse store view.
Pagina & SEO
URL-sleutel
Het adres van de dealerpagina na de URL van je winkel. Met dealers staat de pagina op https://example.com/dealers. Je kunt een genest adres gebruiken, zoals service/dealers, en per store view een andere sleutel, bijvoorbeeld dealers in het Engels en winkels in het Nederlands. Alleen kleine letters, cijfers, "-" en "_" zijn toegestaan, met "/" tussen de delen.
Tip: De pagina is ook bereikbaar op /dealerlocator; zoekmachines worden met een canonical link naar jouw URL-sleutel verwezen, dus er ontstaat geen dubbele content.
Paginatitel
De kop op de pagina. Als dit leeg is, toont de pagina "Vind een dealer", vertaald in de taal van de store view. Je hebt dit dus alleen nodig als je een andere tekst wilt.
Metatitel
De titel in het tabblad van de browser en in zoekresultaten. Als dit leeg is, wordt de paginatitel gebruikt.
Metabeschrijving
De korte tekst die zoekmachines onder de titel van je pagina tonen. Vertel wat bezoekers er vinden, bijvoorbeeld "Vind een [merk]-dealer bij jou in de buurt, met adres, telefoonnummer en route." Houd het onder ongeveer 160 tekens.
Privacy
Kaart pas laden na cookietoestemming
Als de kaart laadt, ontvangt de kaartaanbieder (Google of OpenStreetMap) het IP-adres van de bezoeker, en Google kan cookies plaatsen. Met deze instelling aan wacht de kaart tot de bezoeker toestemming geeft. Tot die tijd staat er een korte melding met een knop Toon kaart op de plek van de kaart, en kunnen bezoekers gewoon zoeken: de lijst zoekt dan op naam, plaats en postcode van de dealers.
De kaart start zodra een van deze dingen gebeurt:
- De bezoeker accepteert cookies in de eigen cookiemelding van Magento (Cookie Restriction Mode)
- De bezoeker accepteert cookies in de cookiebanner van Hyvä
- De bezoeker klikt op Toon kaart
- Een andere toestemmingstool verstuurt het event
dealer-locator:consent-grantedopwindow(je ontwikkelaar kan dat toevoegen aan de "geaccepteerd"-callback van je toestemmingstool)
Aanbevolen:
- Aan, voor winkels in de EU die toestemming vragen voor diensten van derden
- Uit, als je toestemmingstool de pagina al blokkeert of je geen toestemming vraagt voor kaarten
Debug & logging
Debugmodus
Schrijft extra details naar var/log/dealer-locator-debug.log, zoals adressen die de kaartaanbieder niet kon vinden. Fouten, zoals een geweigerde API-sleutel, worden altijd geschreven naar var/log/dealer-locator-error.log. Met de knoppen in deze sectie bekijk je de laatste regels van beide logs in de admin.
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team
Voor een compleet overzicht van functies en configuratieopties, bekijk Dealer Locator.