CMS och API

Drupal implementeringsguide.

Använd Drupal-revisioner, innehållsmoderering och behörigheter för att separera generering, specialistgranskning och publicering.

Förtydliga uppgiften och beslutet

Denna guide förvandlar implementeringsguiden för drupal till ett operativt arbetsflöde som kan granskas. Det kopplar samman domänbeslut, ägande, bevis och acceptans så att resultatet fortsätter att fungera i produktionen.

Använd Drupal-revisioner, innehållsmoderering och behörigheter för att separera generering, specialistgranskning och publicering.

Praktiskt arbetsflöde

  1. 1

    Källtyper, identifierare, fält, lokaler, ägare och publiceringstillstånd.

  2. 2

    Välj leveransmönster från volym, latens, redaktionell kontroll och feltolerans.

  3. 3

    Mappa källposten till en separat språkversionspost med hållbar länkning.

  4. 4

    Lägg till autentisering, idempotens, försök igen, cache-ogiltigförklaring, loggning och åtkomstkontroller.

  5. 5

    Testpublicering, källändringar, otillgängliga resultat, återställning, tangentbordsdrift och övervakning före release.

Exempel eller verktyg

En modererad innehållstyp visar fält, roller, revisioner, leverans och återställning. I verktyget registrerar du även baslinje, ägare, beslut, bevis, öppen fråga och godkännandedatum. Använd en riktig sida eller transaktion så att teamet ser beroenden, undantag och underhållsarbetet som följer efter release.

BeslutspunktSpela inAcceptanskriterium
BaslinjeObserverat aktuellt tillståndKälla och datum registreras
BeslutValt alternativ och motiveringRisk och publik beaktas
BevisTesta, dokumentera eller mätaGranskbar och versionsspecifik
GodkännandeNamn, roll och datumAlla obligatoriska kriterier uppfyllda

Skapa en innehållsmodell som bevarar härkomst

Skapa en innehållstyp på ett tillgängligt språk eller en strukturerad enhet med en enhetsreferens till den auktoritativa källan. Inkludera källversions-ID, språkläge, språkläge, resultat-ID, granskningsstatus, ordlistaversion, risknivå, godkännare och nästa granskningsutlösare. Använd stycken eller strukturerade fält för rubriker, listor, länkar, meddelanden, nedladdningar och kontaktinformation. Ett enda obegränsat rikttextfält gör validering, återanvändning och säker rendering på fältnivå svårare.

Välj medvetet mellan Drupal:s översättningsrelation och en separat relaterad enhet. Standardöversättning fungerar när fältstruktur och redaktionell livscykel förblir likvärdiga. En separat enhet är säkrare när den tillgängliga versionen kombinerar, ordnar om eller förklarar källfält och behöver annan moderering. I båda fallen, håll källversionen oföränderlig för transformationen och visa inaktuell status när den aktuella källan inte längre matchar den.

DesignvalAnvänd närKrävs skydd
Översättning av innehållStruktur och livscykel förblir likvärdigaRevisionsöversättningen påverkas och måttlighetstestades
Relaterad enhetStruktur, ägande eller recension skiljer sig åtExplicit källhänvisning och ömsesidig navigering
ParagrafkartläggningKällan innehåller återanvändbara strukturerade blockGenerering av paketblock eller flaggor som inte stöds

Separat skapande, specialistgranskning och publicering

Konfigurera tillstånd för innehållsmoderering som begärd, generering, utkast, ämnesgranskning, språkgranskning, godkänd, publicerad, inaktuell och misslyckad. Definiera övergångar för dedikerade roller och verifiera dem med Drupal-behörigheter och åtkomsthanterare. API-integreringskontot kan skapa och uppdatera ett utkast men kan inte godkänna eller publicera. En ämnesgranskare kan inte godkänna sin egen högriskgenerering om inte den dokumenterade riskpolicyn tillåter det.

Aktivera revisioner och se till att varje omvandling, kommentarupplösning, statusövergång och källomläggning skapar en revision med författare och tidsstämpel. Bygg en recensionsvy som visar källa och utkast, skillnader, varningar, länkar och det renderade resultatet. Om källan ändras, markera det aktiva utkastet och den publicerade versionen på lämpligt sätt och blockera publiceringen tills en granskare löser missmatchningen.

  1. 1

    Konfigurera entitetsfält, validering, revisioner och källrelationer.

  2. 2

    Skapa modereringstillstånd och rollspecifika övergångar.

  3. 3

    Skapa ett utkast genom en begränsad köarbetare.

  4. 4

    Komplettera ämnes- och språkgenomgångar på en identifierad revision.

  5. 5

    Publicera, indexera och behåll granskningsspåret från källa till släpp.

Leverera med Drupal cachebarhet och tillgänglighet intakt

Bifoga cachetaggar för källentiteten, källversionsrelationen, språkentiteten, refererade stycken och media, ordlistaskonfiguration och renderare. Använd cachekontexter för språk och eventuella legitima åtkomstvarianter, men låt inte godkända offentliga sidor bero på användarspecifikt genereringstillstånd. Ogiltigförklara berörda sidor genom enhetsändringar eller köslutförande, och håll den senast godkända revisionen synlig medan en ersättning granskas.

Gör språknavigering som vanliga länkar genom Drupal-routing och språkmedveten URL-generering. Lägg till ömsesidiga källlänkar, metadata på alternativa språk, brödsmulor och poster i webbplatskartor. Verifiera rubrikhierarki, länksyfte, fokusordning, statusmeddelanden och formulärfelassociation i det sista temat. Rensa API-utdata genom tillåtna strukturerade fält och Drupal:s renderingssystem. Markera aldrig genererad HTML säker bara för att den kom från en betrodd server.

  • Cache-taggar täcker källa, språkversion, komponenter, media, ordlista och renderare.

  • Köbehandling kan inte publicera innehåll eller rensa det senast godkända resultatet i förtid.

  • Språkvägar och källlänkar fungerar utan JavaScript.

  • Textformat och återgivningsmatriser förhindrar osäker uppmärkning.

  • Sök indexerar endast den godkända versionen och tar bort pensionerade rutter.

Bevisa behörigheter, revisioner och återställning

Kärn- och funktionstester bör täcka fältvalidering, åtkomstkontroll, modereringsövergångar, skapande av revisioner, upptäckt av gammal källa, återförsök i kö, ogiltigförklaring av cache, ruttåtkomst och rendering av varje komponent som stöds. Testa Drupal cron och externa kölöpare, inklusive överlappande arbetare och upprepade jobb. Webbläsartester bör utöva det fullständiga redaktionella arbetsflödet med varje roll och enbart tangentbordsanvändning.

Släpp med konfigurationshantering, uppdateringskrokar, rotation av autentiseringsuppgifter, köinstrumentpaneler, återuppspelning av misslyckade jobb, loggminimering, säkerhetskopiering av databas och en återställningsbok. Importera konfigurationen till en produktionsliknande miljö och bekräfta att befintliga paket, översättningar, behörigheter och vyer förblir intakta. Godkännandet inkluderar att återställa en tidigare godkänd revision, bygga om cachar och index och bekräfta att offentliga webbadresser och revisionsposter förblir korrekta.

Roller, bevis och godkännande

Håll generation åtskild från publicering. Ett framgångsrikt svar är ett utkast, inte ett godkännande. Lagra källidentifierare och version, transformationsinställningar, resultatidentifierare, granskningsstatus, godkännare och publiceringstid. När källan ändras, markera språkversionen för granskning istället för att tyst ersätta godkänt innehåll. Detta gör återställning och revision möjlig över plattformar.

Drift och underhåll

Arbetet slutar inte vid publicering. Länka språkversionen eller konfigurationen till dess källa, övervaka kvalitets- och serviceåtgärder och definiera konkreta granskningsutlösare. Triggers inkluderar källändringar, juridiska ändringar, nya publikbehov, återkommande supportfrågor, tekniska förändringar och incidenter. En namngiven ägare utvärderar utlösaren, öppnar en ny revision vid behov och registrerar förnyat godkännande.

Checklista före publicering

  • Integrationen använder hållbara källidentifierare.

  • Inloggningsuppgifter lagras på serversidan och roteras.

  • Timeout, försök igen och hastighetsgräns-beteende definieras.

  • Upprepade förfrågningar är idempotenta.

  • Genererat innehåll går in i ett granskningsläge.

  • Källändringar ogiltigförklarar eller öppnar versionen igen.

  • Språknavigering fungerar med tangentbord och hjälpmedel.

  • Övervakning täcker fel, köer, latens och inaktuellt innehåll.

Auktoritativa källor

  1. Simple8 API dokumentation
  2. Simple8 leveransmönster
  3. Riktlinjer för tillgänglighet till webbinnehåll (WCAG) 2.2

Omsätt guiden i praktiken

Testa Simple8 med representativt innehåll och använd checklistan för att planera ett kontrollerat produktionsarbetsflöde.

Testa din egen text