Documentatie BuurtRadar WordPress plugin

Shortcode

Home » BuurtRadar WordPress plugin » Documentatie » Shortcode

Shortcode

Toont een interactieve kaart met voorzieningen in de buurt van de opgegeven coördinaten. De kaart bevat een legenda waarmee bezoekers categorieën kunnen aan- en uitzetten, en straalcirkels die de afstand visualiseren.

Parameters

  • lat (decimaal getal) – De breedtegraad van de locatie. Gebruik een punt als decimaalteken. Verplicht, tenzij je lat_field gebruikt.
  • lng (decimaal getal) – De lengtegraad van de locatie. Gebruik een punt als decimaalteken. Verplicht, tenzij je lng_field gebruikt.
  • lat_field (optioneel, tekst) – De naam van het custom field (post meta) dat de breedtegraad bevat. Handig bij plugins zoals ACF of WP Geo die coördinaten opslaan in veldnamen. Wordt alleen gebruikt als lat leeg of nul is.
  • lng_field (optioneel, tekst) – De naam van het custom field (post meta) dat de lengtegraad bevat. Wordt alleen gebruikt als lng leeg of nul is.
  • radius (optioneel, geheel getal in meters) – De zoekradius voor voorzieningen. Standaard: de waarde ingesteld in de plugin-instellingen.
  • types (optioneel, kommagescheiden lijst) – Welke categorieën voorzieningen worden getoond. Standaard worden alle 23 categorieën geladen. Zie hieronder voor geldige waarden.
  • preselect (optioneel, kommagescheiden lijst) – Welke categorieën standaard actief (zichtbaar) zijn bij het laden van de kaart. Overige categorieën worden wel geladen maar starten als verborgen in de legenda. Als dit attribuut leeg is, zijn alle categorieën actief.
  • height (optioneel, geheel getal in pixels) – De hoogte van de kaart in pixels. Standaard: 500. Minimum: 200.
  • layout (optioneel, tekst) – Stel in op sidebar voor een sidebarindeling waarbij de legenda naast de kaart staat. Laat leeg voor de standaardindeling (legenda boven de kaart).
  • show_counts (optioneel, true/false) – Toon het aantal gevonden locaties per categorie in de legenda. Standaard: false.
  • hide_legend (optioneel, true/false) – Verberg de legenda volledig. Handig wanneer je de kaart puur ter illustratie wilt tonen zonder filteropties. Standaard: false.

Geldige waarden voor types en preselect

school – Scholen (PO, VO, MBO)
university – Universiteiten en hogescholen
train_station – Treinstations
bus_station – Busstations
subway_station – Metrostations
hospital – Ziekenhuizen
pharmacy – Apotheken
childcare_center – Kinderopvang
restaurant – Restaurants
cafe – Cafés
supermarket – Supermarkten
bakery – Bakkerijen
park – Parken
gym – Sportscholen
bank – Banken
parking – Parkeerplaatsen
museum – Musea
store – Winkels
shopping_mall – Winkelcentra
gas_station – Tankstations
city_hall – Gemeentehuizen
airport – Vliegvelden
entertainment_venue – Uitgaansgelegenheden

Voorbeelden

Basisgebruik – toont alle categorieën rondom een locatie

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

Alleen scholen en openbaar vervoer tonen

[buurtradar lat="52.3676" lng="4.9041" types="school,university,train_station,bus_station,subway_station"]

Alle categorieën laden, maar alleen scholen standaard actief

[buurtradar lat="52.3676" lng="4.9041" preselect="school,university"]

Kaart met grotere hoogte, aangepaste radius en sidebarindeling

[buurtradar lat="52.3676" lng="4.9041" radius="1000" height="700" layout="sidebar"]

Aantallen tonen in de legenda

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

Coördinaten uit custom fields ophalen (bijv. ACF of WP Geo)

[buurtradar lat_field="latitude" lng_field="longitude"]

Kaart zonder legenda

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

Opmerkingen

De coördinaten zijn verplicht. Geef ze op via lat/lng direct in de shortcode, of via lat_field/lng_field als de waarden in een custom field van het huidige bericht staan. Ontbreken alle vier of zijn de waarden 0, dan toont de plugin een foutmelding.
Bij de eerste opvraging van een locatie worden de gegevens op de achtergrond opgehaald. De pagina toont dan tijdelijk een laadmelding; ververs na enkele seconden om de kaart te zien.
Je kunt de shortcode meerdere keren op dezelfde pagina gebruiken met verschillende locaties.