functions-civcity-single-page-wxr-download.php
Klikbare navigatie
Executive Summary
Deze pagina vormt de canonieke beschrijving van functions-civcity-single-page-wxr-download.php binnen CIV-CITY. De functie ondersteunt de gecontroleerde export van individuele CIV-CITY-pagina’s naar een single-page WXR/XML-bestand, met behoud van de relevante WordPress-kernvelden, de canonieke CIV-CITY-meta en de bestuurlijk vereiste parent-child-relatie.
Daarmee fungeert dit bestand als technische en bestuurlijke schakel tussen paginaopbouw, overdraagbare bronexport en federatieve uitwisseling. Deze bestandspagina heeft een operationeel-bestuurlijke functie en beschrijft niet alleen wat de helper technisch doet, maar ook waarom deze helper nodig is voor bronzuivere export, gecontroleerde migratie en navolgbare overdracht binnen CIV-CITY.
Juridisch / bestuurlijk kader
De functie moet worden gelezen in samenhang met de CIV-CITY projectprompt v2.1, waarin is vastgelegd dat WXR/XML alleen met de actuele CIV-CITY-meta wordt opgebouwd en standaard importeert als concept en draft. Ook het paginaregister bevestigt dat CIV-CITY_FUN_P003 canoniek is gekoppeld aan de stabiele bestandsnaam functions-civcity-single-page-wxr-download.php en aan de child-structuur FUN_P031 tot en met FUN_P035.
Normatief betekent dit dat de bestandsnaam van de helper stabiel blijft, versiebeheer op de beschrijvende pagina ligt en export geen vervuilde site-export mag worden. De helper ondersteunt dus de canonieke governance- en exportlogica en is niet bedoeld als vrijblijvende technische downloadfunctie.
Functionele werking / inhoud
De functie heeft vier kerntaken. Ten eerste maakt zij export per individueel pagina-object mogelijk, zodat niet een volledige site of bundle nodig is maar één concreet CIV-CITY-object. Ten tweede bewaakt zij het behoud van canonieke meta, zoals documentcode, subtitle, version, status, bestandsnaam, slug, paginatype, parentvelden, wijzigingsvelden, relatievelden en archiefvelden.
Ten derde neemt de helper de noodzakelijke WordPress-kernvelden mee voor herbruikbare import, waaronder post_type = page, wp:status = draft, wp:post_name, wp:post_parent en _wp_page_template. Ten vierde ondersteunt zij gecontroleerde overdracht en migratie van één bronpagina tussen ontwikkel-, review- en productieomgevingen en tussen federatieve nodes.
Relaties en afhankelijkheden
Deze parentpagina is een child van de functions-overzichtspagina en vormt zelf het anker voor de child pages CIV-CITY_FUN_P031 tot en met CIV-CITY_FUN_P035. Inhoudelijk bestaat een directe relatie met de WXR-reeks, met name wxr-basisbeleid, single-page-wxr-export, importbeleid-conceptstatus en downloadbeleid-xml, en met functions-civcity-meta voor de canonieke meta- en validatielaag.
Implementatie in WordPress / Astra Child
Binnen WordPress en Astra Child wordt deze helper idealiter centraal geladen via functions.php of een vaste require_once-structuur, zodat de exportfunctie bestuurlijk beheersbaar blijft en andere templates of pagina’s geen alternatieve exportlogica hoeven te introduceren. De helper hoort te werken met een doelpagina-ID of vergelijkbaar query-argument, waarna de relevante kernvelden en meta worden verzameld en als downloadbare WXR/XML worden aangeboden.
Daarbij moet de helper rekening houden met juiste templatekoppeling, parent-child-structuur, exportstatus, schone XML-opbouw en correcte bestandsnaam voor de download.
Federatief gebruik
In een federatief netwerk is deze functie van groot belang, omdat niet iedere node een volledige bulkexport nodig heeft. Single-page export maakt het mogelijk om één bronpagina te delen, één wijziging gecontroleerd door te zetten, één bestandspagina met bestuurlijke betekenis te migreren of één object ter review of herstel over te dragen.
Wat centraal gelijk moet blijven is de canonieke meta-set, concept en draft als standaard importuitkomst, de opname van noodzakelijke WordPress-kernvelden en de uitsluiting van vervuilende plugin- of themameta. Wat lokaal mag verschillen is de manier waarop de downloadknop, beheerinterface of logging is ingericht, zolang de canonieke export niet wordt vervuild.
Risico’s en beheersmaatregelen
De voornaamste risico’s zijn vervuilde export, onjuiste parent-child-relatie, foutieve importstatus en lokale afwijking in federatief gebruik. Die risico’s worden beperkt door de uitvoer te beperken tot noodzakelijke WordPress-kernvelden en bestuurlijk relevante CIV-CITY-meta, parentinformatie uit gevalideerde meta te halen en exportbestanden standaard te laten landen als concept en draft.
Ook moet de helper als canonieke referentie voor single-page WXR-export binnen CIV-CITY behouden blijven, zodat lokale nodes geen incompatibele exportstructuren gaan gebruiken.
Versiebeheer en mutaties
De bestandsnaam functions-civcity-single-page-wxr-download.php blijft stabiel; nieuwe versies worden dus op de beschrijvende pagina en de child pages vastgelegd. Typische wijzigingen betreffen aanscherping van exportregels, wijziging van downloadnaamgeving, uitbreiding of beperking van toegestane meta en aanpassing van query-argument of triggerlogica.
Bij substantiële wijziging moet de actuele beschrijving worden bijgewerkt, de wijziging in de versielog worden vastgelegd en zo nodig een eerdere beschrijving naar archief worden verplaatst.
Update-informatie
- Versie v0.2 — 10-04-2026: eerste inhoudelijk volledig uitgewerkte parentpagina voor
functions-civcity-single-page-wxr-download.php.
- Uitwerking afgestemd op het paginaregister, de projectprompt, het compacte werkprotocol en het FUN-generatiesjabloon.
- Inhoud aangescherpt op single-page export, canonieke meta, importstatus, federatieve overdracht en relatie met de WXR-reeks.
- De metadata voor deze pagina worden templategestuurd weergegeven en niet opnieuw als losse metadata-alinea in de hoofdtekst opgenomen.