Best practices voor Magento 2 Dealer Locator
Op zoek naar Dealer Locator? Bekijk de volledige Dealer Locator pagina voor functies, configuratieopties en prijzen.
Dit zijn onze aanbevelingen om de Dealer Locator goed in te richten, gebaseerd op hoe dealernetwerken meestal georganiseerd zijn. Je vindt een paar complete voorbeeldopstellingen, van een winkel in één land met OpenStreetMap tot een winkel in meerdere landen en talen met Google Maps, plus advies over het bijhouden van je dealerlijst, privacy, snelheid en de veiligheid van API-sleutels. We sluiten af met de fouten die we het vaakst zien en een paar tips voor ontwikkelaars die de pagina aan hun thema willen aanpassen. Kies wat bij jouw situatie past: niets hiervan is nodig om de module te laten werken, maar het scheelt je later tijd en supportvragen.
Aanbevolen instellingen en werkwijzen voor de Dealer Locator.
Algemene richtlijnen
Do's
✅ Geef elke dealer een vaste code, zoals je klantnummer, zodat imports altijd de juiste dealer bijwerken
✅ Houd je dealerlijst bij in een spreadsheet of exporteer hem uit je ERP, en importeer hem opnieuw na wijzigingen
✅ Voer een nieuw importbestand eerst uit met "Alleen controleren"
✅ Controleer de dealer-grid op Op kaart: Nee na elke import
✅ Beperk beide Google-sleutels in Google Cloud
✅ Voer de zelftest uit nadat je de kaartinstellingen hebt gewijzigd
✅ Vertaal de namen van productcategorieën per store view in winkels met meerdere talen
Don'ts
❌ Wijzig geen dealercodes: een nieuwe code maakt een nieuwe dealer aan in plaats van de oude bij te werken
❌ Gebruik niet dezelfde Google-sleutel voor de browser en de server
❌ Laat een Google-sleutel niet onbeperkt: de browsersleutel is voor iedereen zichtbaar
❌ Vul niet voor alle dealers zelf coördinaten in als het opzoeken op adres het kan doen
❌ Zet geen openingstijden of opmerkingen in het naamveld; die worden overal als deel van de naam getoond
Veelvoorkomende situaties
Situatie 1: Winkel in één land, snel van start
Toepassing: Een Nederlandse winkel met 50-200 dealers in Nederland, nog zonder API-sleutels.
Instellingen: Kaart & geocoding:
- Kaartaanbieder: OpenStreetMap (gratis, geen API-sleutel)
- Contact-e-mailadres voor Nominatim: je technische contactpersoon
- Zoeken op adres beperken tot landen: Nederland
Resultaten:
- Resultaten per pagina: 10
- Afstandseenheid: Kilometer (km)
Resultaat: De pagina werkt zonder sleutels of kosten. Zoeken op "9711" vindt Groningen, niet een plaats in het buitenland.
Situatie 2: Merk met dealers in meerdere landen, met Google Maps
Toepassing: Een merk dat verkoopt via 1.000+ dealers in Nederland, België en Duitsland, met store views per taal.
Instellingen: Kaart & geocoding:
- Kaartaanbieder: Google Maps (API-sleutel nodig)
- Google Maps browser-API-sleutel: beperkt tot je domeinen en de Maps JavaScript API + Geocoding API
- Google Geocoding server-API-sleutel: beperkt tot het IP-adres van je server en de Geocoding API
- Zoeken op adres beperken tot landen: Nederland, België, Duitsland
- Kaartmidden en zoomniveau: per store view, bijv. Duitsland op 51.1657 / 10.4515, zoom 6
Pagina & SEO, per store view:
- URL-sleutel:
dealers(Engels),dealersofverkooppunten(Nederlands),haendler(Duits) - Metatitel en metabeschrijving in de taal van de store view
Productcategorieën:
- Labels per winkelweergave ingevuld voor elke categorie
Resultaat: Elk land krijgt de dealerpagina in de eigen taal en op een eigen adres, met de kaart en zoekfunctie van Google. Importeer de dealerlijst één keer via de command line en houd hem daarna bij met imports vanuit de admin.
Situatie 3: Dealers alleen in sommige store views
Toepassing: Sommige dealers verkopen alleen aan klanten uit één land, andere bedienen iedereen.
Instellingen:
- Dealers voor iedereen: Winkelweergaven op Alle winkelweergaven (kolom
storesleeg ofallin de import) - Dealers voor één land: alleen hun store view (kolom
storesbijv.be_nl, be_fr)
Resultaat: Bezoekers zien alleen de dealers die relevant zijn voor de store view waar ze op zitten.
Situatie 4: Strikte cookietoestemming
Toepassing: Een winkel in de EU die toestemming vraagt voordat een dienst van derden geladen wordt.
Instellingen: Privacy:
- Kaart pas laden na cookietoestemming: Ja
Gebruik je een andere toestemmingstool dan de cookiemelding van Magento of de banner van Hyvä, laat je ontwikkelaar dan het event dealer-locator:consent-granted versturen als de bezoeker akkoord gaat (zie Module-specifieke tips).
Resultaat: Er gaat geen verzoek naar Google of OpenStreetMap vóór de toestemming. Bezoekers kunnen de lijst wel doorzoeken, of op Toon kaart klikken om de kaart alleen voor zichzelf te laden.
Dealers bijhouden
- Kleine wijzigingen: bewerk de dealer in de admin.
- Veel wijzigingen: exporteer je lijst uit je ERP of spreadsheet met dezelfde codes en importeer hem. Alleen gewijzigde dealers worden opgeslagen; ongewijzigde rijen worden overgeslagen.
- Dealers verwijderen: de import verwijdert geen dealers die niet in het bestand staan. Deactiveer ze met een kolom
activeop0, of verwijder ze in de grid. - Verbeterde adressen: als een opnieuw geïmporteerde rij een nieuw adres heeft en geen coördinaten, worden de coördinaten automatisch opnieuw opgezocht.
Snelheid
- Alle actieve dealers van een store view zitten in de pagina zelf, zodat zoeken direct reageert. Dat werkt goed tot een paar duizend dealers; de zelftest waarschuwt boven de 3.000.
- De pagina wordt gecachet door de full page cache van Magento en automatisch ververst als je een dealer of categorie opslaat.
- De kaart en de scripts ervan laden alleen op de dealerpagina, niet in de rest van je winkel.
Veiligheid
- De Google Maps browser-API-sleutel is bewust zichtbaar in de broncode van de pagina. Beperk hem tot je domeinen (HTTP-referrers) en tot de Maps JavaScript API en Geocoding API, zodat niemand hem elders kan gebruiken.
- De Google Geocoding server-API-sleutel wordt versleuteld opgeslagen en alleen door je server gebruikt. Beperk hem tot het IP-adres van je server en de Geocoding API.
- Stel in Google Cloud een dagelijks quotum of budgetwaarschuwing in, zodat een onverwachte piek geen hoge rekening kan veroorzaken.
Veelgemaakte fouten
Fout: één Google-sleutel voor alles
Waarom het misgaat: Een sleutel die beperkt is tot je domein werkt niet vanaf de server, dus de coördinaten van dealers worden niet gevonden. Een onbeperkte sleutel kan van je pagina gekopieerd en door anderen gebruikt worden. Zo doe je het goed: Twee sleutels: een browsersleutel beperkt op domein, een serversleutel beperkt op IP-adres.
Fout: importeren zonder codes, of met wisselende codes
Waarom het misgaat: Elke import maakt dan nieuwe dealers aan en je krijgt dubbele dealers. Zo doe je het goed: Gebruik een vaste referentie per dealer, zoals het klantnummer in je ERP.
Fout: dealers zonder postcode of plaats
Waarom het misgaat: Zonder postcode of plaats kan het adres niet op de kaart gezet worden, dus de dealer verschijnt niet in de webwinkel. Zo doe je het goed: Vul altijd postcode en plaats in, of vul de coördinaten zelf in.
Fout: verwachten dat een grote OpenStreetMap-import in de admin afrondt
Waarom het misgaat: OpenStreetMap staat één opzoeking per seconde toe; de admin stopt na 60 seconden met opzoeken.
Zo doe je het goed: Gebruik bin/magento dealerlocator:import voor de eerste grote import, of importeer zonder opzoeken en voer daarna bin/magento dealerlocator:geocode uit.
Module-specifieke tips
Naar de pagina linken: voeg een link naar /dealers (of je URL-sleutel) toe aan je menu of footer, bijvoorbeeld in een CMS block. Ontwikkelaars kunnen Magmodules\DealerLocator\Service\Locator\Url::getUrl() gebruiken om de URL van de pagina per store view op te halen.
De kaart starten vanuit je toestemmingstool: voer dit uit als de bezoeker akkoord gaat:
window.dispatchEvent(new Event('dealer-locator:consent-granted'));
Het uiterlijk aanpassen:
- Luma: de stijlen staan in
_module.lessvan de module en gebruiken de variabelen van Luma; overschrijf de classes.mm-dealer-locatoren.mm-dealer-cardin je thema. - Hyvä: knoppen en velden gebruiken de eigen classes
btnenform-inputvan je thema. De opmaak komt uit een klein stylesheet; overschrijf dezelfde class-namen, of pas de CSS-variabelen--mm-dl-accent,--mm-dl-heighten andere aan op.mm-dealer-locator. De opmaak van de lijst is een gewone template (Magmodules_DealerLocator::hyva/locator.phtml) die je in je thema kunt overschrijven.
Andere kaarttegels: de OpenStreetMap-kaarttegels komen van de eigen servers van OpenStreetMap, die bedoeld zijn voor normaal verkeer. Winkels met heel veel bezoekers kunnen overstappen op een commerciële tegeldienst met een di.xml-argument voor Magmodules\DealerLocator\ViewModel\Locator (tileUrl en tileAttribution).
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.