Dealer Locator

Versie v1.0.0
Platform Magento 2
Module uitgebracht 18 November 2026

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), dealers of verkooppunten (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 stores leeg of all in de import)
  • Dealers voor één land: alleen hun store view (kolom stores bijv. 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 active op 0, 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.less van de module en gebruiken de variabelen van Luma; overschrijf de classes .mm-dealer-locator en .mm-dealer-card in je thema.
  • Hyvä: knoppen en velden gebruiken de eigen classes btn en form-input van je thema. De opmaak komt uit een klein stylesheet; overschrijf dezelfde class-namen, of pas de CSS-variabelen --mm-dl-accent, --mm-dl-height en 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:

Support:

Voor een compleet overzicht van functies en configuratieopties, bekijk Dealer Locator.

Artikel bijgewerkt:
Download PDF
star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025