HNY Keuzehulp

WordPress-plugin voor hellonewyou.academy: een trainingskeuzehulp die bezoekers in 2–4 vragen naar de best passende training leidt. Gebaseerd op het bouwdocument "Keuzehulp Hello New You" (juli 2026).

Status: functioneel compleet, in validatie. Vragenflow, gepersonaliseerd resultaat met top-3 en actuele prijzen/startdata, fullscreen pagina, huisstijl-styling, GTM-metingen, settingspagina en automatische updates zitten erin. Voor livegang: trainingsmatches valideren met sales/trainers en interne links omzetten.

Gebruik

1. Activeer de plugin — dat is alles. Bij activatie (en na elke update) maakt de plugin automatisch een pagina aan op /keuzehulp/ met een fullscreen template: geen header of footer, alleen de keuzehulp op volledige hoogte/breedte. Bestaat er al een keuzehulp-pagina (herkenbaar aan de shortcode), dan wordt die geadopteerd en krijgt die hetzelfde template. Is de slug bezet door een andere pagina, dan blijft die ongemoeid en verschijnt een admin-melding.

   De shortcode [hny_keuzehulp] blijft beschikbaar om de keuzehulp daarnaast op een gewone pagina (mét header/footer) te embedden.

2. Configureer via Instellingen → HNY Keuzehulp:

   • adviesgesprek-URL, aantal aanbevelingen, social proof en CTA-teksten;
   • dataLayer aan/uit en event-prefix;
   • GitHub-token voor updates (nodig omdat de repo privé is, zie hieronder).

   Prijs en startdatum per training worden automatisch gedetecteerd uit de post-meta van hny_training; de settingspagina toont welke velden in gebruik zijn. Alleen als de detectie ernaast zit, kies je daar handmatig andere meta-keys (met een referentietabel van alle gevonden velden).

Architectuur in het kort

• PHP rendert alleen een container en registreert een publiek REST-endpoint hny-keuzehulp/v1/config (flow + actuele trainingsdata). Daardoor blijft de pagina cachebaar door LiteSpeed terwijl prijzen/startdata uit de EduDex-sync altijd vers zijn.
• data/flow.json bevat de volledige vragenflow met scoringsgewichten per antwoord. Het primaire pad-resultaat uit het bouwdocument heeft gewicht 10; aangrenzende trainingen 2–5, zodat er altijd een top-3 ontstaat.
• assets/js/keuzehulp.js is een dependency-vrije flow-engine: voortgangsbalk, browser-terugknop (history-state), cijfertoetsen/Enter/pijltjes, auto-advance en dataLayer-events.
• Trainingsdata komt uit het bestaande post type hny_training (gevuld door de hny-training-feed-plugin/EduDex-cron). Prijs en startdatum worden via instelbare meta-keys gelezen.

GTM dataLayer-events

Alle events krijgen de instelbare prefix (standaard keuzehulp):

Releases & automatische updates

Updates lopen via plugin-update-checker (gevendored in includes/lib/). WordPress controleert de main-branch van deze repo en toont de standaard update-melding zodra de versie in de pluginheader hoger is dan de geïnstalleerde versie.

Releaseproces — belangrijk:

1. Verhoog de versie op twee plekken in hny-keuzehulp.php: de Version:-header én HNY_KEUZEHULP_VERSION.
2. Commit en push naar main.
3. Binnen ±12 uur (of direct via "Nogmaals controleren" op de plugins-pagina) verschijnt de update-melding op de site.

Een commit zonder versie-bump levert géén update-melding op — WordPress vergelijkt versienummers, niet commits. Bumpen dus, ook bij kleine fixes.

De repo is public, dus er is geen token nodig — het tokenveld op de settingspagina blijft leeg. Alleen als de repo ooit weer privé wordt, heeft de site een fine-grained token nodig (Resource owner clickwave, alleen deze repo, permissie Contents: Read-only), in te vullen bij Instellingen → HNY Keuzehulp → Updates via GitHub.

Eerste installatie op de site: download de repo als zip, hernoem de map in de zip naar hny-keuzehulp en upload via Plugins → Nieuwe plugin → Plugin uploaden. Daarna verlopen updates automatisch.

Ontwikkelen

Geen build-stap: vanilla PHP/JS/CSS. Structuur:

hny-keuzehulp.php            Bootstrap + pluginheader (versie!)
includes/
  class-settings.php         Settingspagina (Instellingen → HNY Keuzehulp)
  class-trainings.php        Trainingsdata uit hny_training + transient-cache
  class-flow.php             Laadt data/flow.json (filter: hny_keuzehulp_flow)
  class-rest.php             GET hny-keuzehulp/v1/config
  class-shortcode.php        [hny_keuzehulp] + assets
  class-template.php         Automatische /keuzehulp/-pagina + fullscreen template
  class-updater.php          GitHub-updates (plugin-update-checker)
templates/page-keuzehulp.php Fullscreen template (geen header/footer)
  lib/plugin-update-checker/ Gevendorde library (MIT)
data/flow.json               Vragenflow + scoringsgewichten
assets/css/keuzehulp.css     Mobile-first styling op thema-variabelen
assets/js/keuzehulp.js       Flow-engine