WordPress plugin
De Vakgarage Occasions Plugin is een WordPress plugin waarmee je de occasions-voorraad van jouw garage direct op je eigen WordPress website toont. Na installatie en configuratie worden de occasions automatisch opgehaald en weergegeven.
Downloaden
Download de plugin als zip-bestand en installeer deze via het WordPress dashboard onder Plugins > Nieuwe plugin > Plugin uploaden:
Vereisten
Je hebt een API key nodig om de plugin te koppelen aan de Vakgarage API. Neem contact op met Problicity om een API key aan te vragen:
- E-mail: charneal@problicity.nl
- Telefoon: 050 879 5403
Caching
De response wordt 20 minuten gecacht. Dit verbetert de laadtijd van WordPress-pagina's aanzienlijk. Ververs de cache niet bij elk pageview, gebruik de gecachte response. De cache wordt automatisch geleegd wanneer de gegevens opnieuw worden opgeslagen.
Configuratie
Na installatie verschijnt Vakgarage in het WordPress dashboard. Ga naar dit menu om:
- Je API key in te voeren
- De weergave van de occasionslijst aan te passen
De volledige plugin documentatie is ook beschikbaar vanuit het WordPress dashboard onder Vakgarage > Documentatie.
Shortcode
Gebruik de onderstaande shortcode op elke pagina of post om de occasionslijst te tonen:
[vakgarage_stocklist]
Parameters
| Parameter | Waarde | Standaard | Omschrijving |
|---|---|---|---|
grid |
1 - 4 | 4 | Aantal kolommen in het grid |
filterui |
true / false | false | Toon de filterbalk boven de occasions |
sortfield |
price, build_year, mileage, brand, model, brand_model |
Veld waarop gesorteerd wordt | |
sortorder |
ASC / DESC | ASC | Sorteerrichting (oplopend of aflopend) |
defaultfilters |
JSON-array | Vaste filters die altijd worden toegepast, los van de filterbalk |
Voorbeelden
3 kolommen, gesorteerd op prijs (laag naar hoog):
[vakgarage_stocklist grid="3" sortfield="price" sortorder="ASC"]
Met filterbalk, gesorteerd op merk en model:
[vakgarage_stocklist filterui="true" sortfield="brand_model" sortorder="ASC"]
Alleen elektrische occasions:
[vakgarage_stocklist defaultfilters='[{"field":"fuel_type","operator":"==","value":"Elektrisch"}]']
Alleen occasions t/m €25.000:
[vakgarage_stocklist defaultfilters='[{"field":"price","operator":"<=","value":"25000"}]']
Meerdere filters combineren:
[vakgarage_stocklist defaultfilters='[{"field":"fuel_type","operator":"==","value":"Elektrisch"},{"field":"price","operator":"<=","value":"40000"}]']
Filtervelden
| Veld | Type | Voorbeeld |
|---|---|---|
brand |
tekst | Volkswagen |
model |
tekst | Golf |
fuel_type |
tekst | Benzine, Elektrisch |
transmission |
tekst | Automaat, Handgeschakeld |
price |
getal | 25000 |
mileage |
getal | 50000 |
build_year |
getal | 2020 |
Operatoren
| Operator | Betekenis |
|---|---|
== |
Gelijk aan |
!= |
Niet gelijk aan |
<= |
Kleiner dan of gelijk aan |
>= |
Groter dan of gelijk aan |
< |
Kleiner dan |
> |
Groter dan |
Het endpoint erachter
De plugin praat met één endpoint. Bouw je een eigen integratie in plaats van de plugin te gebruiken, dan kun je datzelfde endpoint aanroepen.
GET /api/wordpress-plugin/occasions
De volledige responsestructuur staat in de API-referentie.
Authenticatie
Dit endpoint werkt met een API key in de header, zonder bearer token:
X-API-KEY: <jouw api key>
Alleen een vestigingssleutel
De sleutel moet van het type establishment zijn — hij hoort bij één garage, en het endpoint levert de voorraad van die garage. Een global sleutel wordt geweigerd:
HTTP 403 Forbidden
{
"message": "Access denied. Only establishment API keys have access to this endpoint."
}
Zonder voertuigkoppeling
Heeft de vestiging geen voertuigkoppeling ingesteld, dan krijg je:
HTTP 400 Bad Request
{
"message": "Establishment heeft geen voertuig-integratie ingesteld."
}
Zie Client types voor het verschil tussen de sleuteltypes.