Documentatie BuurtRadar WordPress plugin

Installatie

Home » BuurtRadar WordPress plugin » Documentatie » Installatie

Installatie Shortcode

Installatie

  1. Download het pluginbestand (.zip) na aankoop via wielands.nl.
  2. Ga in het WordPress-dashboard naar Plugins → Nieuwe plugin → Plugin uploaden.
  3. Selecteer het gedownloade .zip-bestand en klik op Nu installeren.
  4. Activeer de plugin via Plugins → Geïnstalleerde plugins.
  5. Ga naar Instellingen → BuurtRadar Instellingen om de plugin te configureren.

Configuratie: Kaartprovider

Ga naar Instellingen → BuurtRadar Instellingen → Kaartprovider en kies de gewenste provider:

  1. Google Maps – vereist een Google API-sleutel en (aanbevolen) een Map ID voor geavanceerde markers. Activeer in de Google Cloud Console de Maps JavaScript API en maak een Map ID aan met “Advanced markers” ingeschakeld.
  2. OpenStreetMap – geen API-sleutel nodig. Leaflet wordt automatisch geladen via CDN.
  3. Mapbox – vul je Mapbox Access Token in. Maak een gratis account aan op mapbox.com.

Configuratie: Google Maps Platform

  1. Vul bij Google API sleutel je sleutel in (verplicht bij keuze voor Google Maps).
  2. Stel de Zoekradius in meters in (standaard wordt deze ook in de shortcode gebruikt als je geen radius-attribuut opgeeft).

Google Map ID aanmaken

Een Map ID is nodig voor geavanceerde markers (AdvancedMarkerElement). Volg deze stappen:

  1. Ga naar de Google Cloud Console (console.cloud.google.com) en open je project.
  2. Ga via het menu naar Google Maps Platform → Map Management.
  3. Klik op Create Map ID.
  4. Geef het Map ID een naam (bijv. “Buurtinfo kaart”).
  5. Kies bij Map type voor JavaScript.
  6. Zet de optie Advanced markers aan.
  7. Klik op Save. Je Map ID verschijnt in de lijst.
  8. Kopieer het Map ID en plak het in de plugin-instelling Map ID onder Instellingen → BuurtRadar Instellingen → Kaartprovider.

Let op: het Map ID is gekoppeld aan je Google Cloud-project en API-sleutel. Zorg dat de Maps JavaScript API ingeschakeld is in datzelfde project.

Configuratie: Licentiesleutel

  1. Ga naar Plugins → Geïnstalleerde plugins en klik op Licentie activeren onder de plugin.
  2. Voer je licentiesleutel in en klik op Activeren.
  3. Een actieve licentie is vereist voor automatische updates.

Configuratie: Categoriekleuren (optioneel)

Onder Categoriekleuren kun je per locatietype de kleur van de kaartmarker en legenda aanpassen. Klik op een kleurvlak om de kleur te wijzigen. Sla de instellingen op.

Data importeren

Na de eerste configuratie worden de NL-databronnen (scholen, OV, zorg etc.) automatisch op de achtergrond geïmporteerd via WordPress cron. Op een lokale ontwikkelomgeving kan cron problemen geven; gebruik dan de knop Nu uitvoeren per databron onder het tabblad Synchronisatie in de instellingen.

Shortcode plaatsen

Voeg de shortcode toe aan een pagina of bericht met de coördinaten van de gewenste locatie:

[buurtradar lat="52.3676" lng="4.9041"]

Zie de shortcode-documentatie voor alle beschikbare parameters.