Dealers importeren via CSV | Magento 2 Dealer Locator
Op zoek naar Dealer Locator? Bekijk de volledige Dealer Locator pagina voor functies, configuratieopties en prijzen.
Met de CSV-import van de Dealer Locator voeg je in één keer honderden dealers toe of werk je ze bij, rechtstreeks vanuit een spreadsheet. Deze handleiding laat zien hoe je het bestand voorbereidt in Excel of Google Sheets, welke kolommen de import begrijpt, welke opties de importpagina heeft en hoe je het rapport daarna leest. We leggen ook uit hoe opnieuw importeren werkt, zodat je je dealerlijst in een spreadsheet kunt bijhouden en na wijzigingen gewoon opnieuw uploadt, en wat je kunt verwachten als de module voor veel adressen tegelijk coördinaten opzoekt. In de admin staat een voorbeeldbestand klaar om mee te beginnen.
Waar vind je het
Ga naar: Inhoud → Dealer Locator → Dealers → CSV importeren
Met de knop Voorbeeld-CSV downloaden (op de dealer-grid en de importpagina) krijg je een kant-en-klaar voorbeeld om mee te beginnen.
Hoe de import werkt
- Elke rij is één dealer. Dealers worden herkend aan de code: een bestaande code wordt bijgewerkt, een nieuwe code maakt een dealer aan.
- Rijen worden één voor één verwerkt. Een rij met een probleem wordt gemeld en overgeslagen; de andere rijen worden gewoon geïmporteerd.
- Kolommen die niet in het bestand staan, blijven bij bestaande dealers ongewijzigd. Een bestand met alleen
code,name,country,phonewerkt alleen de telefoonnummers bij. - Een lege cel maakt de waarde leeg, een lege telefooncel verwijdert bijvoorbeeld het telefoonnummer.
- Rijen die niets veranderen, tellen als "Ongewijzigd" en worden niet opnieuw opgeslagen.
Het bestand voorbereiden
- De eerste rij bevat de kolomnamen. De volgorde maakt niet uit.
- Gescheiden door komma's, puntkomma's of tabs: de import herkent het zelf.
- Opgeslagen vanuit Excel? Zowel "CSV UTF-8" als het gewone "CSV" van Excel werken, dus letters met accenten zoals "é" of "ü" komen goed door.
- Waarden met het scheidingsteken erin, zoals meerdere categorieën, staan tussen dubbele aanhalingstekens:
"Tenten, Rugzakken". Excel en Google Sheets doen dit voor je. - Maximaal 10 MB per bestand in de admin. Voor grotere bestanden gebruik je de command line (zie de handleiding voor CLI-commando's).
Kolommen
| Kolom | Verplicht | Wat vul je in |
|---|---|---|
code |
Ja | Unieke referentie voor de dealer. Alleen letters, cijfers, "-", "_" en ".", max. 64 tekens. |
name |
Ja | Naam van de dealer zoals bezoekers die zien. |
country |
Ja | Landcode van twee letters: NL, BE, DE, FR, GB... |
street |
Straat en huisnummer, bijv. Domplein 9. |
|
postcode |
Postcode. | |
city |
Plaats. Een postcode of plaats is nodig om de dealer op de kaart te zetten. | |
phone |
Telefoonnummer zoals je het wilt tonen. | |
website |
Volledig adres inclusief https://. |
|
categories |
Namen van productcategorieën, gescheiden door komma's (of een verticale streep): "Tenten, Rugzakken". |
|
stores |
Codes van store views, gescheiden door komma's: "nl, be_nl". Leeg of all betekent alle store views. |
|
active |
1 of 0. yes/no, true/false en ja/nee werken ook. Leeg betekent actief. |
|
latitude, longitude |
Coördinaten, als je ze hebt. Gebruik ze allebei of geen van beide. |
Kolomnamen zijn niet hoofdlettergevoelig, en een paar gangbare alternatieven worden herkend: zip of postal_code voor postcode, country_code voor country, lat en lng voor de coördinaten, is_active voor active, telephone voor phone. Andere kolommen worden genegeerd en in het rapport als melding genoemd.
Productcategorieën
Categorieën worden herkend aan hun standaardlabel, ongeacht hoofd- of kleine letters. Met Productcategorieën aanmaken die nog niet bestaan aan worden onbekende namen automatisch aangemaakt, elk maar één keer. Zet het uit als je wilt dat tikfouten worden gemeld in plaats van nieuwe categorieën te worden.
Coördinaten
- Coördinaten in het bestand worden gebruikt zoals ze zijn.
- Als ze leeg zijn, houden bestaande dealers hun coördinaten, zodat opnieuw importeren niet elk adres opnieuw opzoekt.
- Dealers zonder coördinaten, en dealers waarvan het adres is gewijzigd, krijgen hun coördinaten opgezocht (als die optie aan staat).
Opties op de importpagina
- Ontbrekende coördinaten opzoeken op basis van het adres - standaard aan. Zet het uit om snel te importeren en de dealers daarna op de kaart te zetten.
- Productcategorieën aanmaken die nog niet bestaan - zie hierboven.
- Alleen controleren, niets opslaan - controleert het hele bestand en laat zien wat er zou gebeuren, zonder iets op te slaan. Aanbevolen voor de eerste import van een nieuw bestand.
Grote bestanden en coördinaten opzoeken
Met OpenStreetMap kan de module ongeveer één adres per seconde opzoeken (hun gebruiksvoorwaarden). Een adminpagina kan niet wachten op honderden opzoekingen, dus in de admin stopt het opzoeken na 60 seconden: de overige dealers worden zonder coördinaten geïmporteerd, en het rapport meldt dat. Daarna kun je:
- de dealer-grid filteren op Op kaart: Nee, de dealers selecteren en Locatie zoeken gebruiken (opnieuw 60 seconden per keer), of
- op de server
bin/magento dealerlocator:geocodeuitvoeren, zonder tijdslimiet.
Met Google Maps gaat het opzoeken veel sneller, dus daar wordt de limiet zelden bereikt.
Het rapport
Na de import toont de pagina:
- Aangemaakt, Bijgewerkt, Ongewijzigd, Mislukt - het aantal rijen per resultaat
- Aangemaakte productcategorieën
- Opgezochte coördinaten en Dealers zonder coördinaten
- Een lijst met meldingen per rij, met het rijnummer en de dealercode:
- Fout - de rij is niet geïmporteerd, bijvoorbeeld "Land "XX" is geen bekende landcode van twee letters" of "Code "D-12" staat ook in rij 4"
- Waarschuwing - de dealer is geïmporteerd, maar het adres is niet gevonden op de kaart
- Melding - ter informatie, zoals een kolom die niet gebruikt wordt
Rijnummers komen overeen met de rijen in je spreadsheet: rij 1 is de kopregel.
Voorbeeld
code,name,street,postcode,city,country,phone,website,categories,stores,active,latitude,longitude
D-1001,Outdoor Centre Utrecht,Domplein 9,3512 JE,Utrecht,NL,+31 30 000 0001,https://www.example.com,"Tents, Backpacks",all,1,,
D-1003,Adventure Store Brussels,Grote Markt 1,1000,Brussel,BE,,,"Backpacks, Sleeping bags",all,1,50.8467,4.3525
Voor de eerste dealer worden de coördinaten opgezocht; de tweede gebruikt die uit het bestand.
Alleen de actieve status van twee dealers bijwerken:
code,name,country,active
D-1001,Outdoor Centre Utrecht,NL,0
D-1003,Adventure Store Brussels,BE,1
name en country zijn in elk bestand verplicht, dus neem ze ook op als ze niet veranderen.
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.