Pas uitgebracht

Dealer Locator voor Magento 2


Voeg een dealerpagina met kaart toe aan je Magento 2-winkel waarmee bezoekers eenvoudig de dichtstbijzijnde dealer vinden op basis van plaats, postcode of naam en je dealers zelf beheert via de admin of importeert vanuit CSV.
15 dagen geld-terug-garantie Eenmalige betaling
Magento Cloud Ondersteuning GraphQL Ondersteuning Hyvä Ondersteuning Adobe Goedgekeurd Privé Composer Repo
Inclusief deze gratis add-ons
hyva-themes/magento2-default-theme ...
Documentatie

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.

De dealerpagina van Nordic Living met een zoekopdracht op Utrecht, drie dealers gesorteerd op afstand en een kaart met hun locaties.

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.

De dealerpagina op een telefoon met de tabs voor lijst en kaart en drie dealers met hun afstand, naast de instellingen onder Results.
De instellingen onder Map & Geocoding met Google Maps als provider, beide velden voor de API-sleutels en onder elk veld een knop om de sleutel te testen.

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.

Het onderdeel Address and Location van een dealer in Antwerpen met lege velden voor Latitude en Longitude, en de uitvoer van het geocode-commando met de gevonden coördinaten.
Het formulier Import Dealers from CSV met een gekozen bestand en drie opties, en de uitvoer van een proefimport op de commandoregel.

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, name en country verplicht zijn. Kolomnamen als zip, lat, lng en telephone worden 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: active accepteert 1 en 0, yes en no, en ook "ja" en "nee". Bij stores vul je codes van store views in, of all. 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.

De instellingen onder Page & SEO met de URL Key dealers en een paginatitel, meta title en meta description voor Nordic Living.
De privacy-instelling Load Map Only After Cookie Consent op Yes, en de melding met een knop om de kaart te tonen die de bezoeker ziet in plaats van de kaart.

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-granted op window om 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.

Het dealeroverzicht met vijf dealers van Nordic Living, de knoppen voor de voorbeeld-CSV, de import en een nieuwe dealer, en het actiemenu met Find Location geselecteerd.

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-geocode en --no-create-categories. Met -v zie 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 --limit voor een maximumaantal dealers.
  • Consent-hook: elke consent-tool kan de kaart starten met het event dealer-locator:consent-granted op window.
  • 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.

Bekijk de extensie Lees de documentatie

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.

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