CMS en API

WordPress-implementatiehandleiding.

Kies bewust voor widget- of API-levering, houd de originele pagina canoniek en publiceer taalversies via revisies.

Verduidelijk de taak en het besluit

Deze handleiding verandert de wordpress-implementatiegids in een controleerbare operationele workflow. Het verbindt domeinbeslissingen, eigendom, bewijsmateriaal en acceptatie, zodat het resultaat blijft werken in de productie.

Kies bewust voor widget- of API-levering, houd de originele pagina canoniek en publiceer taalversies via revisies.

Praktische werkwijze

  1. 1

    Inventarisatiebrontypen, ID's, velden, landinstellingen, eigenaren en publicatiestatussen.

  2. 2

    Kies het leveringspatroon op basis van volume, latentie, redactionele controle en fouttolerantie.

  3. 3

    Wijs het bronrecord toe aan een afzonderlijk taalversierecord met duurzame koppeling.

  4. 4

    Voeg authenticatie, idempotentie, opnieuw proberen, cache-invalidatie, logboekregistratie en toegangscontroles toe.

  5. 5

    Testpublicatie, bronwijzigingen, niet-beschikbare resultaten, terugdraaien, toetsenbordbediening en monitoring vóór release.

Voorbeeld of hulpmiddel

Een Gutenberg-workflow brengt bronpagina's, beoordelingsstatussen, cachesleutels en taalnavigatie in kaart. Leg in de tool ook de uitgangssituatie, de eigenaar, het besluit, het bewijsmateriaal, het openstaande probleem en de goedkeuringsdatum vast. Gebruik een echte pagina of transactie zodat het team afhankelijkheden, uitzonderingen en het onderhoudswerk dat volgt op de release ziet.

BeslissingspuntDossierAcceptatiecriterium
BasislijnHuidige staat waargenomenBron en datum vastgelegd
BeslissingGeselecteerde optie en redenEr wordt rekening gehouden met risico en publiek
BewijsTest, documenteer of meetReviewbaar en versiespecifiek
GoedkeuringNaam, rol en datumEr werd aan alle verplichte criteria voldaan

Kies voor widget-, plug-in- of server-side API-levering

Gebruik een widget als de implementatiesnelheid van belang is, de bronpagina's al duurzame ID's hebben en een afhankelijkheid aan de clientzijde acceptabel is. Gebruik een WordPress-plug-in wanneer redacteuren binnen de beheerinterface moeten genereren en beoordelen. Gebruik API-levering op de server wanneer taalversies moeten worden geïndexeerd, in de cache opgeslagen, in feeds moeten worden opgenomen en moeten worden weergegeven, zelfs als JavaScript niet beschikbaar is. Grote uitgevers combineren vaak een plug-in voor workflow met weergave op de server voor levering.

Documenteer de keuze op het gebied van redactionele controle, prestaties, toegankelijkheid, zoeken, foutgedrag, gegevensstroom en onderhoudseigendom. De originele pagina blijft de gezaghebbende bron. Een taalversie krijgt een eigen bericht of gestructureerd record, stabiele URL, beoordelingsstatus en bron-revisielink. Vermijd het opslaan van alternatieve inhoud alleen in een aangepast veld of browsercache zonder versiebeheer, omdat revisoren deze niet op betrouwbare wijze kunnen goedkeuren, herstellen of controleren.

PatroonBeste pasvormPrimaire controle
WidgetSnelle toevoeging aan een gecontroleerde siteToegankelijke terugval- en storingsstatus
Plugin-workflowEditors werken volledig in WordPressRollen, nonces, mogelijkheden en revisies
Serverzijde APIGeïndexeerde, cachebare, veerkrachtige pagina'sWachtrij, cache-invalidatie en implementatiebewerkingen

Modelleer bronrelaties en redactionele staten

Maak een berichttype met een taalversie of gebruik een meertalige structuur die expliciete bronrelaties ondersteunt. Bewaar bronpost-ID, bronrevisie-ID, doellandinstelling, taalmodus, resultaat-ID, woordenlijstversie, beoordelingsstatus, goedkeurders, gepubliceerde revisie en beoordelingstrigger. Houd de getransformeerde blokstructuur waar mogelijk behouden, zodat koppen, lijsten, links, tabellen en mededelingen semantisch blijven en niet in één HTML-veld worden samengevoegd.

Definieer de statussen voor aangevraagd, gegenereerd, concept, onderwerpbeoordeling, taalbeoordeling, goedgekeurd, gepubliceerd, verouderd en mislukt. Wijs elke overgang toe aan een WordPress-mogelijkheid, niet alleen aan een zichtbare knop. Een generator kan een concept maken, maar kan dit niet goedkeuren. Wanneer de bron verandert, vergelijk dan de revisie ervan met de goedgekeurde bronrevisie en verplaats de taalversie naar verouderd of revisie vereist. Publiceer niet stilletjes een opnieuw gegenereerd resultaat.

  1. 1

    Registreer de taalversierecord en de vereiste metagegevens met opschonings- en REST-machtigingen.

  2. 2

    Breng ondersteunde Gutenberg-blokken in kaart en definieer het gedrag van niet-ondersteunde blokken.

  3. 3

    Configureer rollen en toegestane statusovergangen.

  4. 4

    Genereer deze in een aparte revisie en presenteer een bronvergelijking.

  5. 5

    Publiceer alleen na de vereiste goedkeuringen voor het inhoudsrisiconiveau.

Veilig cachen en duurzame taalnavigatie bieden

Bouw cachesleutels op basis van site, bronpost-ID, bronrevisie, landinstelling, taalmodus en rendererversie. Maak de gerelateerde taalpagina ongeldig wanneer de goedgekeurde revisiewijzigingen, de bronwijzigingen, een gedeeld blokwijzigingen of een relevante terminologieregel opnieuw wordt gepubliceerd. Als de verwerking asynchroon verloopt, dient u de laatst goedgekeurde versie te presenteren terwijl het nieuwe concept wordt beoordeeld. Vervang goedgekeurde inhoud nooit door een lege status, omdat het genereren ervan niet beschikbaar is.

Voeg taallinks toe als gewone, door de server weergegeven ankers met duidelijke namen zoals ‘begrijpelijke taal’ en ‘makkelijk lezen’. Voeg wederzijdse links naar de bronpagina toe en corrigeer metagegevens in alternatieve talen. Behoud de toetsenbordfocus na een paginawisseling en kondig een routewijziging alleen aan via de normale paginatitel en kop. Een ontbrekende versie moet uitleggen dat deze niet beschikbaar is en teruglinken naar de bron, en niet de bediening verbergen of stil teruggaan.

  • Cachesleutels omvatten bron- en rendererversies.

  • De laatst goedgekeurde pagina overleeft API en wachtrij-uitval.

  • Taallinks werken zonder JavaScript en gebruiken goedgekeurde terminologie.

  • Canonieke en alternatieve metadata weerspiegelen de feitelijke relatie.

  • Wijzigingen in gedeelde blokken en woordenlijsten activeren de betreffende beoordelingstaken.

Test het volledige publicatie- en terugdraaipad

Gebruik een staging-kopie met representatieve Gutenberg-blokken, aangepaste velden, ingesloten formulieren, herbruikbare blokken en beperkte berichten. Testgeneratie, rolafdwinging, beoordelingsopmerkingen, geplande publicatie, preview, cache-invalidatie, bronupdate, verouderde markering, verwijdering, herstel en terugdraaien. Bevestig dat REST-eindpunten ongeautoriseerde lees- en schrijfbewerkingen weigeren en dat achtergrondtaken niet cross-site kunnen worden geactiveerd zonder geldige nonce- of serverreferenties.

Definieer vóór de productie wachtrijbewaking, fouteigendom, rotatie van inloggegevens, testen van plug-inupdates, databaseback-up en een procedure voor veilige uitschakeling. Acceptatie vereist correcte weergave op algemene breekpunten, toetsenbord- en schermlezernavigatie, geen lay-outverschuiving van late inhoud, geldige gestructureerde koppen, traceerbare goedkeuring en herstel van de laatst goedgekeurde revisie. Registreer de ondersteunde WordPress-, PHP-, editor-, meertalige plug-in- en cachingconfiguraties.

Rollen, bewijs en goedkeuring

Houd generatie gescheiden van publicatie. Een succesvol antwoord is een concept, geen goedkeuring. Bewaar de bron-ID en -versie, transformatie-instellingen, resultaat-ID, beoordelingsstatus, goedkeurder en publicatietijd. Wanneer de bron verandert, markeer dan de taalversie ter beoordeling in plaats van goedgekeurde inhoud stilzwijgend te vervangen. Dit maakt rollback en audit mogelijk op verschillende platforms.

Bediening en onderhoud

Het werk eindigt niet bij de publicatie. Koppel de taalversie of configuratie aan de bron, bewaak de kwaliteit en servicemaatregelen en definieer concrete beoordelingstriggers. Triggers zijn onder meer bronwijzigingen, juridische wijzigingen, nieuwe doelgroepbehoeften, terugkerende ondersteuningsvragen, technische wijzigingen en incidenten. Een benoemde eigenaar evalueert de trigger, opent indien nodig een nieuwe revisie en registreert de vernieuwde goedkeuring.

Controlelijst voor publicatie

  • De integratie maakt gebruik van duurzame bronidentificaties.

  • Inloggegevens worden op de server opgeslagen en gerouleerd.

  • Time-out, nieuwe poging en snelheidslimietgedrag zijn gedefinieerd.

  • Herhaalde verzoeken zijn idempotent.

  • Gegenereerde inhoud komt in een beoordelingsstatus.

  • Bronwijzigingen maken de versie ongeldig of heropenen deze.

  • Taalnavigatie werkt via toetsenbord en ondersteunende technologie.

  • Monitoring heeft betrekking op fouten, wachtrijen, latentie en verouderde inhoud.

Gezaghebbende bronnen

  1. Simple8 API-documentatie
  2. Simple8-leveringspatronen
  3. Richtlijnen voor toegankelijkheid van webinhoud (WCAG) 2.2

Breng de gids in de praktijk

Test de Simple8 met representatieve inhoud en gebruik de checklist om een ​​gecontroleerde productieworkflow te plannen.

Test je eigen tekst