Functionele documentatie gereformeerdebond.nl¶
Deze documentatie beschrijft de huidige website gereformeerdebond.nl functioneel, per scherm en per feature. Zij dient als acceptatiekader voor project VSS-2562: het headless nabouwen van de site in Next.js, met WordPress als (blijvend) CMS en API-backend.
Living documentation
Dit is levende documentatie: zij beschrijft wat de site vandaag observeerbaar
doet, niet wat ooit bedoeld was. Wijzigt de site, dan wijzigt deze documentatie
mee. Peildatum van de inventarisatie: 6 augustus 2026. Bronnen: de codebase
(thema gereformeerde-bond, mu-plugins), de lokale omgeving met een kopie van de
productiedatabase, en steekproeven tegen dev.gereformeerdebond.nl.
De vier subsites¶
De site is één WordPress-installatie die vier "subsites" bedient. Een subsite is geen aparte installatie maar een presentatielaag: eigen huisstijl (kleuren, logo), eigen menu, eigen ACF-instellingen en eigen content-types, geselecteerd op basis van de URL. Zie Subsites & routing voor het mechanisme.
| Key | Naam | URL-prefix | Inhoud in het kort |
|---|---|---|---|
| GB | Gereformeerde Bond | (geen — root) | Hoofdsite van de vereniging: over de GB, nieuws, agenda, boeken & publicaties, fondsen, predikantendatabase, ledenwerving en donaties |
| WV | De Waarheidsvriend | /de-waarheidsvriend/ |
Het weekblad: ±8.700 artikelen (deels achter een paywall), abonnementswerving, digitale uitgaven (bladerbare PDF's, alleen voor abonnees) |
| TR | Theologia Reformata | /theologia-reformata/ |
Wetenschappelijk theologisch tijdschrift: inhoudsopgaven per nummer, abonnee-aanmelding |
| CGC | Cornelis Graafland Centrum | /cornelis-graafland-centrum/ |
Onderzoekscentrum aan de VU: publicaties, nieuws, stuurgroep, vriendennetwerk |
De oude domeinen dewaarheidsvriend.nl, theologiareformata.nl en
cornelisgraaflandcentrum.nl verwijzen met 301-redirects door naar de bijbehorende
subsite-prefix op gereformeerdebond.nl.
Leeswijzer¶
De documentatie is als volgt opgebouwd:
- Architectuur — sitebrede mechanismen: subsites & routing, rollen & toegang, het volledige paginaoverzicht (de master-checklist voor de rebuild) en de verzamelde bekende afwijkingen.
- Per subsite (secties GB, WV, TR, CGC) — de schermen en features van die subsite.
- Formulieren — alle Gravity Forms-formulieren met velden, betaal- en registratieflows.
- API — het bestaande headless API-oppervlak (REST, app-endpoints) en de gaten die voor de rebuild gedicht moeten worden.
Elke scherm-/featurepagina volgt een vast stramien:
| Kopje | Inhoud |
|---|---|
| Doel & URL('s) | Wat het scherm is, voor wie, exacte URL('s) |
| Opbouw | Secties van boven naar beneden |
| Databronnen | Post types, ACF-velden, opties |
| Gedrag & rollen | Interactie en wie wat ziet (anoniem / ingelogd / wv-subscriber / pastor / …) |
| Acceptatiecriteria | Checklist met observeerbaar gedrag, testbaar met Playwright |
| Bekende afwijkingen | Defecten in de huidige site — niet nabouwen, wel vermelden in het testrapport |
Scope van de rebuild (VSS-2562)¶
In scope — de volledige publieke frontend van alle vier subsites in Next.js:
- alle pagina's, archieven, artikelen, zoekfunctie, menu's en de subsite-mechaniek;
- authenticatie en de accountomgeving (inloggen, registreren, account bijwerken, wachtwoord wijzigen, predikant-gegevens);
- content-afscherming: artikel-paywall, uitgaven voor abonnees, beschermde PDF's;
- de frontend-kant van de formulieren (weergave, validatie, inzending, bevestiging, Mollie-betaalflow);
- redirects, sitemaps en SEO-pariteit.
Buiten scope van de frontend-rebuild (blijft in/achter WordPress):
- wp-admin en alle redactionele beheerflows (ACF, nested pages, imports);
- de abonnee-import (WP All Import) en de rol-synchronisatie;
- de productie en verzending van de nieuwsbrief (
newsletter-edition, Listmonk); - de Waarheidsvriend-app (eigen repository en omgeving; gebruikt dezelfde API).
Bekende afwijkingen niet nabouwen
De huidige site bevat aantoonbare defecten (dode links, 404's, kapotte knoppen — zie Bekende afwijkingen). Deze worden in de Next.js-rebuild niet een-op-een nagebouwd: waar deze documentatie een afwijking markeert, geldt het daar beschreven besluit (herstellen dan wel bewust weglaten). Het testrapport van de rebuild vermeldt elke afwijking expliciet, zodat een verschil met de oude site aantoonbaar bewust is.
Conventies¶
- URL's zijn relatief ten opzichte van het productiedomein
https://gereformeerdebond.nl. - "Anoniem" = een niet-ingelogde bezoeker. Rollen (
wv-subscriber,pastor, …) staan toegelicht in Rollen & toegang. - De site is volledig Nederlandstalig (nl_NL); er is geen meertaligheid.
- Voorbeelden bevatten geen persoonsgegevens van echte abonnees of predikanten.