Implementatie in WordPress

Klikbare navigatie

Executive Summary

Deze pagina beschrijft de concrete implementatie van functions-civcity-meta.php in WordPress en in het bijzonder binnen de Astra Child-omgeving van CIV-CITY. De kern is dat meta-registratie, validatie, statuslogica en registerkoppeling niet los worden toegepast, maar via de child theme-structuur gecontroleerd worden geladen, beheerd en getoetst.

Plaatsing in Astra Child

De functionlaag behoort te worden opgenomen binnen de CIV-CITY implementatiestructuur van de Astra Child theme. Dat betekent dat de functie niet als los plugin-experiment of als incidenteel snippetbestand wordt beheerd, maar als herkenbaar en navolgbaar onderdeel van de canonieke codebasis. Het laden gebeurt vanuit de centrale functions.php of via een gestructureerde include- of require_once-opzet die in de hoofdimplementatie wordt vastgelegd.

Technische laadvolgorde

De implementatie moet zo zijn ingericht dat functions-civcity-meta.php beschikbaar is voordat dashboardweergave, registerlogica, template-afhankelijke metadata-uitvoer of WXR/XML-hulplogica er een beroep op doen. In de praktijk betekent dit dat de functie vroeg in de WordPress laadketen moet worden meegenomen en dat latere componenten, zoals registertemplates en exportfuncties, niet zelf alternatieve meta-definities gaan introduceren.

Metaboxen en admin-omgeving

Een correcte implementatie in WordPress veronderstelt dat de beheeromgeving de canonieke CIV-CITY meta-set op een bruikbare manier aanbiedt. Dat kan via metaboxen, adminvelden of andere beheerschermen, zolang de functionlaag de uiteindelijke bron blijft die bepaalt welke waarden zijn toegestaan. De beheerinterface is dus een invoerschil, geen zelfstandige normlaag.

Validatie bij opslag

Bij het opslaan van een pagina moet de implementatie server-side toetsen op verplichte velden, toegestane statuswaarden, logische combinaties tussen paginatype en status en de aanwezigheid van juiste parentrelaties. WordPress mag daarbij geen situatie toelaten waarin een pagina wel opslaat, maar bestuurlijk onzuiver wordt. Waar nodig hoort de implementatie ongeldige waarden terug te zetten, opslag te blokkeren of een veilige fallback toe te passen.

Samenhang met templates

De implementatie moet expliciet rekening houden met de governance-template en de dashboardtemplates. Wanneer templates een metadata-box renderen, mag de functionlaag niet aansturen op dubbele presentatie in de body. Omgekeerd moeten templates erop kunnen vertrouwen dat de metawaarden waarop zij draaien volledig, schoon en consistent zijn aangeleverd.

Samenhang met registers en export

De WordPress-implementatie van deze function heeft direct effect op registerpagina’s, sorteerbare overzichten en exportbestanden. Wanneer documentcodes, statussen of parentvelden onjuist worden opgeslagen, raakt dat direct de werking van registertemplates, navigatielogica en WXR/XML-export. Daarom moet implementatie in WordPress steeds worden beoordeeld op downstream-effecten in registers, dashboards en overdraagbare bronbestanden.

Lokale foutbronnen

Veelvoorkomende fouten zijn: dubbellaagse meta-opslag, het gebruik van verouderde _civ_*-velden als primaire governance-meta, handmatige override van statuswaarden in templates, te late laadvolgorde in de child theme-structuur en beheerschermen die waarden laten opslaan buiten de canonieke validatielaag om. Deze fouten maken WordPress technisch ogenschijnlijk werkend, maar bestuurlijk onbetrouwbaar.

Operationele beheersmaatregelen

Om de implementatie schoon te houden, moet elke wijziging aan functions-civcity-meta.php worden getoetst op: laadvolgorde, samenhang met functions.php, effect op templates, effect op registerweergave, effect op WXR/XML en effect op federatieve overdraagbaarheid. Daarnaast moet elke relevante wijziging bestuurlijk terugkomen in versielog en mutatieoverzicht, zodat technische implementatie en documentbeheer niet uit elkaar gaan lopen.

Update-informatie

Versie v0.2 — 09-04-2026: eerste inhoudelijk uitgewerkte operationele child page voor de implementatie van functions-civcity-meta.php in WordPress.
Inhoud afgestemd op de bijgewerkte parentpagina CIV-CITY_FUN_P002 en de child pages CIV-CITY_FUN_P021 en CIV-CITY_FUN_P022.
Operationele implementatie verduidelijkt voor Astra Child, laadvolgorde, metaboxen, server-side validatie en samenhang met templates en registers.
De metadata voor deze pagina worden templategestuurd weergegeven en niet herhaald in een body-paragraaf.