CMS en API

Drupal-implementatiehandleiding.

Gebruik Drupal-revisies, contentmoderatie en machtigingen om generatie, specialistische beoordeling en publicatie te scheiden.

Verduidelijk de taak en het besluit

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

Gebruik Drupal-revisies, contentmoderatie en machtigingen om generatie, specialistische beoordeling en publicatie te scheiden.

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 gemodereerd inhoudstype toont velden, rollen, revisies, levering en terugdraaien. 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

Creëer een contentmodel dat de herkomst behoudt

Maak een inhoudstype in toegankelijke taal of een gestructureerde entiteit met een entiteitsverwijzing naar de gezaghebbende bron. Vermeld de bronrevisie-ID, landinstelling, taalmodus, resultaat-ID, beoordelingsstatus, woordenlijstversie, risiconiveau, goedkeurders en volgende beoordelingstrigger. Gebruik alinea's of gestructureerde velden voor koppen, lijsten, links, mededelingen, downloads en contactgegevens. Eén enkel onbeperkt rich-text-veld maakt validatie, hergebruik en veilige weergave op veldniveau moeilijker.

Kies bewust tussen de vertaalrelatie van Drupal en een afzonderlijke gerelateerde entiteit. Standaardvertalingen werken wanneer de veldstructuur en de redactionele levenscyclus gelijkwaardig blijven. Een afzonderlijke entiteit is veiliger wanneer de toegankelijke versie bronvelden combineert, opnieuw rangschikt of uitlegt en andere moderatie nodig heeft. In beide gevallen moet u de bronrevisie onveranderlijk houden voor de transformatie en de verouderde status weergeven wanneer de huidige bron er niet langer mee overeenkomt.

Ontwerp keuzeGebruik wanneerVereiste beveiliging
Vertaling van inhoudStructuur en levenscyclus blijven gelijkwaardigRevisievertaling beïnvloed en moderatie getest
Gerelateerde entiteitStructuur, eigendom of beoordeling verschiltExpliciete bronverwijzing en wederzijdse navigatie
AlineatoewijzingBron bevat herbruikbare gestructureerde blokkenNiet-ondersteunde generatie van bundelblokken of vlaggen

Afzonderlijke creatie, specialistische beoordeling en publicatie

Configureer de statussen van inhoudsmoderatie, zoals aangevraagd, gegenereerd, concept, onderwerpbeoordeling, taalbeoordeling, goedgekeurd, gepubliceerd, verouderd en mislukt. Definieer overgangen voor specifieke rollen en verifieer deze met Drupal-machtigingen en toegangshandlers. Het API-integratieaccount kan een concept maken en bijwerken, maar kan het niet goedkeuren of publiceren. Een subjectreviewer kan het genereren van eigen risico's niet goedkeuren, tenzij het gedocumenteerde risicobeleid dit toestaat.

Schakel revisies in en zorg ervoor dat elke transformatie, reactieresolutie, statusovergang en bronrebase een revisie met auteur en tijdstempel creëert. Bouw een recensieweergave die de bron en het concept, de verschillen, waarschuwingen, links en het weergegeven resultaat toont. Als de bron verandert, markeer dan het actieve concept en de gepubliceerde versie op de juiste manier en blokkeer de publicatie totdat een recensent de discrepantie heeft opgelost.

  1. 1

    Configureer entiteitsvelden, validatie, revisies en bronrelaties.

  2. 2

    Creëer moderatiestatussen en rolspecifieke overgangen.

  3. 3

    Genereer een concept via een beperkte wachtrijmedewerker.

  4. 4

    Volledige onderwerp- en taalrecensies voor één geïdentificeerde revisie.

  5. 5

    Publiceer, indexeer en bewaar het audittraject van bron tot release.

Lever met intacte cachebaarheid en toegankelijkheid van Drupal

Voeg cachetags toe voor de bronentiteit, de bronrevisierelatie, de taalentiteit, de alinea's en media waarnaar wordt verwezen, de configuratie van de woordenlijst en de renderer. Gebruik cachecontexten voor de landinstelling en eventuele legitieme toegangsvariaties, maar zorg ervoor dat goedgekeurde openbare pagina's niet afhankelijk zijn van de gebruikersspecifieke generatiestatus. Maak de betrokken pagina's ongeldig door entiteitswijzigingen of voltooiing van de wachtrij, en houd de laatste goedgekeurde revisie zichtbaar terwijl een vervanging wordt beoordeeld.

Geef taalnavigatie weer als gewone links via Drupal-routering en taalbewuste URL-generatie. Voeg wederkerige bronlinks, metadata in alternatieve talen, broodkruimels en sitemapvermeldingen toe. Controleer de kophiërarchie, het doel van de koppeling, de focusvolgorde, statusberichten en de associatie van formulierfouten in het uiteindelijke thema. Reinig de API-uitvoer via toegestane gestructureerde velden en het weergavesysteem van Drupal. Markeer gegenereerde HTML nooit als veilig alleen maar omdat deze afkomstig is van een vertrouwde server.

  • Cachetags omvatten bron, taalversie, componenten, media, woordenlijst en renderer.

  • Wachtrijverwerking kan geen inhoud publiceren of het laatst goedgekeurde resultaat voortijdig wissen.

  • Taalroutes en bronlinks werken zonder JavaScript.

  • Tekstformaten en weergavearrays voorkomen onveilige opmaak.

  • Zoeken indexeert alleen de goedgekeurde revisie en verwijdert buiten gebruik gestelde routes.

Bewijs machtigingen, revisies en terugdraaiing

Kernel- en functionele tests moeten betrekking hebben op veldvalidatie, toegangscontrole, moderatie-overgangen, het maken van revisies, detectie van verouderde bronnen, nieuwe pogingen in de wachtrij, ongeldigverklaring van de cache, routetoegang en weergave van elk ondersteund onderdeel. Test Drupal cron- en externe wachtrijlopers, inclusief overlappende werknemers en herhaalde taken. Browsertests moeten de volledige redactionele workflow uitvoeren bij elke rol en frontend-gebruik met alleen een toetsenbord.

Release met configuratiebeheer, updatehooks, rotatie van referenties, wachtrijdashboards, herhaling van mislukte taken, minimalisatie van logboeken, databaseback-up en een rollback-runbook. Importeer de configuratie in een productie-achtige omgeving en bevestig dat bestaande bundels, vertalingen, machtigingen en weergaven intact blijven. Acceptatie omvat het herstellen van een eerder goedgekeurde revisie, het opnieuw opbouwen van caches en indexen, en het bevestigen dat openbare URL's en auditrecords correct blijven.

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