Next Lead — Rijschool Dation Plugin

Plugin-documentatie · v1.0.0

Shortcodes

Deze plugin biedt vier shortcodes om de koppeling met Dation in een WordPress-site te gebruiken. Per shortcode staat hieronder wat hij toont en welke parameters hij accepteert. Klik op een titel voor een voorbeeld.

  1. 01

    Cursuskalender

    shortcode

    Tabel met alle cursussen die Dation aanlevert. Bezoekers kunnen filteren op datum, type en beschikbare plekken.

    [dation_course_calendar]
  2. 02

    Productdetail

    shortcode

    Toont een WooCommerce-product inclusief de Dation-dropdown om een cursusdatum of praktijkslot te kiezen.

    [dation_product id="12"]
  3. 03

    Cursistgegevens op de checkout

    automatisch op /checkout/

    Geboortedatum en per cursusplaats een set persoonsgegevens. Op de echte /checkout/ verschijnen deze velden vanzelf zodra een Dation-product in de cart zit; de shortcode is voor previews.

    [dation_checkout_preview students="2"]
  4. 04

    Bevestiging op de bedankpagina

    automatisch op /order-received/

    Cursusdetails plus de Dation sync-status. Wordt automatisch toegevoegd aan de WooCommerce bedankpagina via de woocommerce_thankyou-hook.

    [dation_thankyou_preview]
  5. 05

    Lead-formulier

    shortcode of Gravity Forms

    Formulier voor informatie-aanvragen. POST naar /v1/leads + /v1/lead_notes. Schakelbaar tussen Gravity Forms en vanilla shortcode in de plugin-instellingen.

    [dation_lead_form]
  6. 06

    Code 95 flow / template

    coming soon

    Aparte registratie- en cursistenflow voor Code 95 nascholingen (BCT-codering, certificaatuitgifte). In ontwikkeling.

Installatie
  1. Activeer de plugin via /wp-admin/plugins.php. WooCommerce moet ook actief zijn.
  2. Open Dation → Administraties en vul je API-key + bank-ID in. De pagina test direct de verbinding.
  3. Koppel je producten op de WC product-edit pagina via de Dation-metabox (course of appointment + filter).
  4. Plak een shortcode (zie overzicht hierboven) op een willekeurige WordPress-pagina.
  5. De extra checkout-velden en de bedankpagina-sync werken automatisch zodra een Dation-product in de cart zit — daar is geen shortcode voor nodig.
Caching & performance

De plugin maakt Dation-data direct beschikbaar voor bezoekers door drie cache-lagen achter elkaar te zetten. Live API-calls zijn de uitzondering, niet de regel.

  • 1

    Proactive cache

    Een WordPress cron-job draait elke 5 minuten en synchroniseert alle aankomende cursus-instances en appointments uit Dation naar een eigen DB-tabel (wp_dation_cache). Page-loads hoeven nooit op een live API te wachten.

  • 2

    Transient cache

    Korte-termijn cache per (product, filter)-combinatie via de standaard WP transient-API. Vangt occasionele Dation-traagheid op tussen de cron-runs door.

  • 3

    Direct API (fallback)

    Pas als beide caches leeg zijn doet de plugin een live GET /v1/course-instances of /v1/appointments. Bij Dation-uitval blijft de site werken op de laatst gesynchroniseerde cache; bezoekers zien geen foutmeldingen.

Cache leegmaken kan via Dation → Cache in WP-admin. Daar zie je ook hoeveel cursussen + appointments er nu in zitten en wanneer de volgende sync staat ingepland.