Dealer Locator voor Magento 2





Dealer Locator voor Magento 2
Een dealerpagina met kaart en zoeken op afstand in je winkel
Dealer Locator voegt een dealerpagina toe aan je Magento 2-winkel. Bezoekers zoeken op plaats, postcode, adres of dealernaam, of gebruiken hun huidige locatie, en zien de dichtstbijzijnde dealers in een lijst en op een kaart, gesorteerd op afstand.
Dealers en productcategorieën beheer je onder "Content" > "Dealer Locator", één voor één of in bulk met een CSV-import. De extensie zoekt de coördinaten voor de kaart op bij elk adres, zodat niemand breedtegraad en lengtegraad met de hand hoeft in te vullen.
De kaart draait op OpenStreetMap zonder API-sleutel of op Google Maps, en de pagina heeft eigen templates voor Hyvä en Luma.

Wat Dealer Locator doet
Zoeken op plaats, postcode of naam
Bezoekers typen een plaats, postcode, adres of dealernaam, of delen hun locatie, en krijgen de dichtstbijzijnde dealers bovenaan.
OpenStreetMap of Google Maps
Kies de "Map Provider" per website: OpenStreetMap werkt zonder API-sleutel, Google Maps met twee sleutels die je in de admin test.
Coördinaten uit het adres
Laat "Latitude" en "Longitude" leeg en de extensie zoekt ze op wanneer je een dealer opslaat of importeert.
CSV-import met rapport per rij
Maak dealers aan en werk ze bij op code, valideer een bestand zonder iets op te slaan en zie per rij wat er misging.
Dealers en teksten per store view
Koppel dealers aan store views en stel de URL key, paginatitel en categorielabels per store view in.
Kaart pas na cookietoestemming
Houd de kaart desgewenst tegen tot de bezoeker toestemming geeft, terwijl de dealerlijst blijft werken.
Vind de dichtstbijzijnde dealer in een lijst en op de kaart
In het zoekveld vult de bezoeker een plaats, postcode of adres in. De kaartprovider zoekt de plek op en de lijst wordt gesorteerd op afstand, in de eenheid die je kiest bij "Distance Unit": "Kilometres (km)" of "Miles (mi)". In kilometers staat een dealer die dichterbij is dan 1 km in meters, bijvoorbeeld "850 m", en het decimaalteken volgt de taal van de store view.
Zoeken op dealernaam werkt ook. Raakt een zoekterm wel een dealernaam maar geen straat, plaats of postcode, dan filtert de pagina op die naam en gaat de term niet naar de geocoder, die er een willekeurige plek bij zou zoeken. Hoofdletters en accenten maken niet uit: "zurich" vindt een dealer in Zürich.
- Locatie: met de knop voor de huidige locatie wordt de lijst gesorteerd vanaf de plek van de bezoeker.
- Filter: de keuzelijst met productcategorieën verschijnt zodra er meer dan één productcategorie is.
- Per dealer: een routelink opent de route in Google Maps en een tweede link springt naar de marker op de kaart.
- Lijst en kaart: een dealer die op de kaart wordt gekozen, is ook in de lijst geselecteerd, ook als hij voorbij de knop voor meer resultaten staat.
- Lengte: "Results per Page" bepaalt hoeveel dealers er in de lijst staan vóór de knop voor meer resultaten, van 1 tot 100, met 10 als standaard.
Op kleine schermen schakelt de pagina over op twee tabs, een voor de lijst en een voor de kaart.


OpenStreetMap zonder API-sleutel, of Google Maps
"Map Provider" heeft twee opties: "OpenStreetMap (free, no API key)", de standaard, en "Google Maps (API key required)". De gekozen provider wordt gebruikt voor de kaart, voor het zoeken op adres door de bezoeker en voor het opzoeken van de coördinaten van dealers.
Met OpenStreetMap kun je direct aan de slag. Geocoding loopt via Nominatim, dat één aanvraag per seconde toestaat, en bij "Contact Email for Nominatim" vul je een contactadres in, zoals hun gebruiksbeleid vraagt.
Google Maps vraagt om een Google Cloud-project met de Maps JavaScript API en de Geocoding API, en om twee sleutels:
- "Google Maps Browser API Key": wordt gebruikt in de browser van de bezoeker en is zichtbaar in de paginabron. Beperk hem daarom tot het domein van je winkel.
- "Google Geocoding Server API Key": wordt versleuteld opgeslagen en door Magento gebruikt bij het opslaan en importeren van dealers. Beperk hem tot het IP-adres van je server.
Onder elke sleutel staat de knop "Test API key" (in de Nederlandse admin "API-sleutel testen"). Die controleert de waarde in het veld, ook vóór het opslaan. Bij de browsersleutel worden beide API's in je browser getest en wordt gekeken of de sleutel beperkt is tot websites. Bij de serversleutel gaat er één Geocoding-aanvraag vanaf de server. Een foute of onbeperkte sleutel zie je zo in de admin en niet pas op de live dealerpagina.
"Default Map Centre Latitude", "Default Map Centre Longitude" en "Default Zoom Level" bepalen wat de kaart toont vóór een zoekopdracht. "Restrict Address Search to Countries" verbetert de resultaten bij invoer die op meer plekken kan slaan, zoals postcodes. Laat je het veld leeg, dan zoekt de pagina in de landen waar je dealers zitten.
Dealers met coördinaten die voor je worden opgezocht
Een dealer heeft in de admin vier onderdelen: "General", "Address and Location", "Contact" en "Product Categories and Store Views". Vul het adres in en laat "Latitude" en "Longitude" leeg: de extensie zoekt ze op bij het opslaan. Coördinaten die je zelf invult, blijven staan. Dat is handig voor een locatie die de geocoder op de verkeerde plek zet.
De "Code" is de unieke referentie van een dealer, bijvoorbeeld je klantnummer. De CSV-import gebruikt die code om bestaande dealers bij te werken.
Bij "Product Categories" kies je wat een dealer verkoopt, en bezoekers kunnen daarop filteren. De categorieën beheer je onder "Content" > "Dealer Locator" > "Product Categories", elk met een "Default Label", een "Sort Order" en "Labels per Store View", zodat het filter in elke taal klopt. Met "Store Views" bepaal je in welke store views een dealer wordt getoond.
Voor dealers die nog niet op de kaart staan, zoekt bin/magento dealerlocator:geocode de ontbrekende coördinaten op vanaf de commandoregel. Met --limit verwerk je een vast aantal dealers per keer.


Dealers importeren en bijwerken vanuit CSV
Met "Import CSV" in het dealeroverzicht maak je nieuwe dealers aan en werk je bestaande bij, gekoppeld op hun code. "Download Sample CSV" geeft je een bestand met de juiste kolommen om mee te beginnen.
- Kolommen: 13 kolommen, waarvan
code,nameencountryverplicht zijn. Kolomnamen alszip,lat,lngentelephoneworden ook herkend. - Bestandsformaat: gescheiden door komma, puntkomma of tab, in UTF-8 (met of zonder BOM) of Windows-1252. Een CSV die in Excel op Windows is opgeslagen, importeer je dus zonder omzetten. De admin accepteert bestanden tot 10 MB.
- Bijwerken: kolommen die niet in het bestand staan, blijven bij bestaande dealers ongewijzigd. Een lege cel wist de waarde, en bij lege coördinaten blijven de opgeslagen coördinaten staan.
- Waarden:
activeaccepteert 1 en 0, yes en no, en ook "ja" en "nee". Bijstoresvul je codes van store views in, ofall. Coördinaten mogen een decimale komma hebben. - Fouten: elke rij wordt apart opgeslagen. Eén rij met een fout houdt de rest dus niet tegen.
Het formulier heeft drie opties: "Look up missing coordinates from the address", "Create product categories that don't exist yet" en "Validate only, don't save anything". De laatste controleert het hele bestand en meldt wat er aangemaakt en bijgewerkt zou worden, zonder een dealer te wijzigen.
Na de import zie je "Created", "Updated", "Unchanged" en "Failed", plus een tabel met de rij, de code en de melding voor elke rij die aandacht vraagt. Met OpenStreetMap stopt de import in de admin na 60 seconden met het opzoeken van coördinaten en worden de overige dealers zonder coördinaten opgeslagen. Die zet je daarna op de kaart met de actie "Find Location" in het overzicht.
Een eigen URL, titel en metagegevens per store view
De dealerpagina staat op de URL van je winkel gevolgd door de "URL Key", standaard dealers. Een genest pad zoals service/dealers kan ook.
"URL Key", "Page Title", "Meta Title" en "Meta Description" stel je per store view in. Samen met dealers per store view en categorielabels per store view krijgt elke taal van je winkel een eigen dealerpagina, met een eigen adres, eigen teksten en eigen dealers.
Na installatie staat de pagina uit. Zet "Enabled" op "Yes", voor alle store views tegelijk of per store view, zodra je dealers erin staan.


Laad de kaart pas na cookietoestemming
Zodra de kaart laadt, ontvangt de kaartprovider het IP-adres van de bezoeker. Met "Load Map Only After Cookie Consent" op "Yes" wacht de kaart tot de bezoeker toestemming heeft gegeven. De instelling staat standaard uit.
- Magento en Hyvä: de kaart volgt de Cookie Restriction Mode van Magento en de cookie consent van Hyvä.
- Andere consent-tools: stuur het event
dealer-locator:consent-grantedopwindowom de kaart te starten. - De bezoeker beslist: de pagina meldt van welke provider de kaart komt en toont een knop om de kaart alsnog te laden.
Zoeken en de dealerlijst blijven beschikbaar zonder toestemming, zodat een bezoeker altijd een dealer kan vinden.

Alle dealers in één overzicht, met bulkacties
Het overzicht onder "Content" > "Dealer Locator" > "Dealers" toont van elke dealer het adres, de productcategorieën, de store views en de status. In de kolom "On Map" zie je welke dealers coördinaten hebben.
Filter op "Store View", "Product Category" of "On Map" en pas een van de massa-acties toe: "Activate", "Deactivate", "Find Location" of "Delete". Wil je na een grote import de overige dealers op de kaart zetten, filter dan "On Map" op "No", selecteer de dealers en kies "Find Location".
Dealer Locator voor Magento 2: technische details voor developers en winkeliers
De voordelen voor developers
- Vereisten: Magento 2.4.4 of hoger en PHP 8.1 of hoger.
- Hyvä en Luma: de pagina heeft een eigen Hyvä-layout en -template naast de Luma-versie. De zoek- en afstandslogica staat in
view/frontend/web/js/core/locator.js, zonder DOM- of kaartcode, en wordt door beide front-ends gedeeld. - Importeren vanaf de commandoregel:
bin/magento dealerlocator:import <file>met--dry-run,--no-geocodeen--no-create-categories. Met-vzie je de voortgang per rij. Het commando geeft een foutcode terug als het rapport fouten bevat, zodat je het in een gepland script kunt gebruiken. - Geocoding vanaf de commandoregel:
bin/magento dealerlocator:geocode, met--limitvoor een maximumaantal dealers. - Consent-hook: elke consent-tool kan de kaart starten met het event
dealer-locator:consent-grantedopwindow. - Rechten: importeren heeft een eigen ACL-resource,
Magmodules_DealerLocator::import, los van het beheren van dealers, productcategorieën en de configuratie. - Logging: "Debug Mode" schrijft API-aanvragen en -antwoorden naar een debug.log-bestand. Fouten gaan altijd naar error.log.
- Selftest: zeven controles op de PHP-versie, de Magento-versie, de status van de extensie, de kaartconfiguratie, geocoding, de Google-browsersleutel en het aantal dealers.
Goed om te weten voor winkeliers
- Versie 1.0.0 is de eerste release van Dealer Locator.
- OpenStreetMap is gratis en vraagt geen account. De geocoder staat één opzoeking per seconde toe, dus coördinaten opzoeken voor een grote import kost tijd.
- "Map Provider" en de Google-sleutels stel je per website in, niet per store view. Het middelpunt van de kaart, het zoomniveau, de resultaten en de paginateksten kunnen wel per store view verschillen.
- De routelink opent altijd Google Maps, ook als de kaart zelf op OpenStreetMap draait.
- De selftest geeft een waarschuwing als je meer dan 3000 dealers hebt.
Zet je dealers op de kaart
Dealer Locator 1.0.0 draait op Magento 2.4.4 en hoger, met templates voor Hyvä en Luma. Installeer de extensie, kies een kaartprovider en importeer je dealers vanuit CSV.
Kennisbank
Alle bekende helpartikelen
Een lijst met de meest gestelde vragen over de Dealer Locator-extensie voor Magento 2. We hebben ons best gedaan om je te helpen met de installatie, configuratie en probleemoplossing. Als je het antwoord dat je zocht niet kunt vinden, kun je ons altijd een bericht sturen via dit formulier.
Installatieartikelen
Configuratie
Wijzigingslogboek 1.0.0 is uitgebracht op 18 November 2026
Onze plug-ins worden regelmatig bijgewerkt om compatibiliteit met de nieuwste Magento-versie te garanderen.
-
Features:
- A dealer locator page where visitors find the nearest dealer by place, postcode, address or their own location, on a map and in a list sorted by distance.
- Google Maps or OpenStreetMap: OpenStreetMap works without an API key, Google Maps with a browser key and a server key.
- Dealers close together are grouped on the map, and choosing a dealer in the list highlights it on the map and the other way round.
- Every dealer shows its address, distance, product categories, phone number, website and a link that plans the route in Google Maps.
- Product categories with a name per store view, offered as a filter on the page.
- Dealers appear only in the store views they are assigned to, and only while active.
- Coordinates are looked up from the address when a dealer is saved, coordinates entered by hand are kept, and "Find Location" places the selected dealers that are not on the map yet.
- Hundreds of dealers are added or updated at once from a spreadsheet, in the admin or on the command line, with a check-only run and a report per row.
- The page address, title and meta description are set per store view, with a canonical link for search engines.
- The map can wait for cookie consent, so the map provider receives nothing before the visitor agrees, while the list and the search keep working.
- "Test API key" buttons check both Google keys from the configuration, including whether the browser key is restricted to your website.
- Works with Luma and Hyvä, on desktop, tablet and mobile, in English and Dutch, with documentation in both languages. Tests:
- 163 unit tests with the module-standards architecture checks on Magento 2.4.7 and 2.4.9, 39 tests of the storefront and admin scripts, and PHPStan level 8 on both versions. Compatibility:
- Magento 2.4.4 and up
- PHP 8.1 and up
100% Ongecodeerde codekwaliteit gegarandeerd.

Adobe Commerce Goedgekeurd door Marketplace
Deze extensie staat op de officiele Adobe Commerce Marketplace en heeft het reviewproces doorlopen op codekwaliteit, performance en beveiliging.
Goedkeuring via de Adobe Marketplace betekent dat de extensie voldoet aan de Magento coding standards en correct integreert met het platform. Updates doorlopen hetzelfde reviewproces.

Hyvä Compatibele Plugin
Deze extensie biedt volledige ondersteuning voor Hyva Themes. Alle frontend-componenten, widgets en templates werken native met Hyva's Alpine.js en Tailwind CSS stack.
De extensie werkt direct op Hyva en wordt bij elke nieuwe Hyva-release getest om compatibiliteit te blijven garanderen.

GraphQL Klaargemaakt
Deze extensie stelt data en configuratie beschikbaar via Magento's GraphQL API. Je kunt data direct opvragen en muteren vanuit headless frontends of eigen applicaties.
Het GraphQL-schema volgt de conventies van Magento en dekt alle kernfunctionaliteit van de extensie. Hierdoor is het geschikt voor PWA Studio, Vue Storefront of elke andere headless setup.

Magento Cloud Ondersteuning
Deze extensie is volledig compatibel met Adobe Commerce Cloud (Magento Cloud). Het werkt met het read-only filesystem, de build- en deploy-pipeline en cloud-specifieke caching-lagen.
Er is geen extra configuratie of workaround nodig voor cloud-omgevingen. De extensie gaat op dezelfde manier om met static content deployment en configuratiebeheer als bij on-premise installaties.

Privé Composer Repo
Na aankoop krijg je toegang tot een prive Composer-repository met persoonlijke credentials. Installeer en update de extensie met een enkel composer-commando, net als elke andere dependency.
Je Composer-credentials zijn beschikbaar in je accountdashboard. Updates worden gepubliceerd zodra een nieuwe versie beschikbaar is, zodat je altijd toegang hebt tot de laatste versie.