CMS a API

Průvodce implementací Drupal.

Použijte revize Drupal, moderování obsahu a oprávnění k oddělení generování, odborné recenze a publikace.

Ujasněte si úkol a rozhodnutí

Tato příručka přemění průvodce implementací drupal na přehledný provozní pracovní postup. Propojuje rozhodování o doméně, vlastnictví, důkazy a přijímání, takže výsledek nadále funguje v produkci.

Použijte revize Drupal, moderování obsahu a oprávnění k oddělení generování, odborné recenze a publikace.

Praktický postup

  1. 1

    Typy zdrojů inventáře, identifikátory, pole, národní prostředí, vlastníci a stavy publikace.

  2. 2

    Vyberte vzor doručení z objemu, latence, redakční kontroly a odolnosti proti selhání.

  3. 3

    Mapujte zdrojový záznam na samostatný záznam jazykové verze s trvalým propojením.

  4. 4

    Přidejte ověřování, idempotency, opakování, zneplatnění mezipaměti, protokolování a řízení přístupu.

  5. 5

    Testovací publikace, změny zdroje, nedostupné výsledky, vrácení zpět, ovládání klávesnice a monitorování před vydáním.

Příklad nebo nástroj

Moderovaný typ obsahu zobrazuje pole, role, revize, doručení a vrácení zpět. V nástroji také zaznamenejte výchozí stav, vlastníka, rozhodnutí, důkazy, otevřený problém a datum schválení. Použijte skutečnou stránku nebo transakci, aby tým viděl závislosti, výjimky a údržbu, která následuje po vydání.

Rozhodovací bodZáznamKritérium přijetí
Základní liniePozorovaný aktuální stavZdroj a datum zaznamenány
RozhodnutíVybraná možnost a zdůvodněníZváženo riziko a publikum
DůkazTestujte, dokumentujte nebo měřteKontrolovatelné a specifické pro verzi
SchváleníJméno, role a datumSplněna všechna povinná kritéria

Vytvořte model obsahu, který zachovává původ

Vytvořte typ obsahu v přístupném jazyce nebo strukturovanou entitu s odkazem na entitu na autoritativní zdroj. Zahrňte ID revize zdroje, národní prostředí, jazykový režim, ID výsledku, stav recenze, verzi glosáře, úroveň rizika, schvalovatele a spouštěč příští kontroly. Použijte odstavce nebo strukturovaná pole pro nadpisy, seznamy, odkazy, upozornění, soubory ke stažení a kontaktní informace. Jediné neomezené pole formátovaného textu znesnadňuje ověření na úrovni pole, opětovné použití a bezpečné vykreslování.

Záměrně si vyberte mezi překladovým vztahem Drupal a samostatnou související entitou. Standardní překlad funguje, když struktura pole a životní cyklus redakce zůstávají ekvivalentní. Samostatná entita je bezpečnější, když přístupná verze kombinuje, mění pořadí nebo vysvětluje zdrojová pole a vyžaduje jiné moderování. V obou případech ponechte revizi zdroje neměnnou pro transformaci a zobrazte zastaralý stav, když mu aktuální zdroj již neodpovídá.

Výběr designuPoužijte, kdyžPožadovaná ochrana
Překlad obsahuStruktura a životní cyklus zůstávají rovnocennéDotčen překlad revize a testováno moderování
Související entitaStruktura, vlastnictví nebo recenze se lišíExplicitní odkaz na zdroj a reciproční navigace
Mapování odstavcůZdroj obsahuje opakovaně použitelné strukturované blokyNepodporované generování bloků nebo příznaků svazků

Samostatná tvorba, recenze specialisty a publikace

Nakonfigurujte stavy moderování obsahu, jako je požadováno, generování, koncept, předmětová recenze, jazyková recenze, schváleno, publikováno, zastaralé a neúspěšné. Definujte přechody pro vyhrazené role a ověřte je pomocí oprávnění Drupal a obslužných rutin přístupu. Integrační účet API může vytvořit a aktualizovat koncept, ale nemůže schválit ani publikovat. Kontrolor předmětu nemůže schválit svou vlastní vysoce rizikovou generaci, pokud to dokumentovaná politika rizik nepovoluje.

Povolte revize a zajistěte, aby každá transformace, rozlišení komentářů, přechod stavu a zdrojová rebase vytvořily revizi s autorem a časovým razítkem. Vytvořte zobrazení recenze, které zobrazuje zdroj a koncept, rozdíly, varování, odkazy a vykreslený výsledek. Pokud se zdroj změní, označte odpovídajícím způsobem aktivní pracovní verzi a publikovanou verzi a zablokujte publikaci, dokud recenzent nesoulad nevyřeší.

  1. 1

    Nakonfigurujte pole entity, ověření, revize a zdrojový vztah.

  2. 2

    Vytvářejte stavy moderování a přechody specifické pro role.

  3. 3

    Vygenerujte koncept prostřednictvím omezeného pracovníka fronty.

  4. 4

    Kompletní předmětové a jazykové recenze na jedné identifikované revizi.

  5. 5

    Publikovat, indexovat a uchovávat auditní záznam od zdroje k vydání.

Dodávejte s neporušenou mezipamětí a přístupností Drupal

Připojte značky mezipaměti pro zdrojovou entitu, vztah revize zdroje, jazykovou entitu, odkazované odstavce a média, konfiguraci glosáře a vykreslovací modul. Používejte kontexty mezipaměti pro národní prostředí a jakékoli legitimní varianty přístupu, ale nenechte schválené veřejné stránky záviset na stavu generování specifickém pro uživatele. Zrušte platnost dotčených stránek prostřednictvím změn entit nebo dokončením fronty a během kontroly náhrady udržujte viditelnou poslední schválenou revizi.

Vykreslujte jazykovou navigaci jako běžné odkazy pomocí směrování Drupal a generování adres URL podle jazyka. Přidejte vzájemné odkazy na zdroje, metadata v alternativním jazyce, drobečky a položky mapy webu. Ověřte hierarchii nadpisů, účel odkazu, pořadí fokusu, stavové zprávy a přidružení chyb formuláře ve finálním motivu. Dezinfikujte výstup API prostřednictvím povolených strukturovaných polí a vykreslovacího systému Drupal. Nikdy neoznačujte vygenerované HTML jako bezpečné pouze proto, že pochází z důvěryhodného serveru.

  • Značky mezipaměti pokrývají zdroj, jazykovou verzi, komponenty, média, glosář a renderer.

  • Zpracování fronty nemůže publikovat obsah nebo předčasně vymazat poslední schválený výsledek.

  • Jazykové cesty a zdrojové odkazy fungují bez JavaScriptu.

  • Textové formáty a vykreslovací pole zabraňují nebezpečnému označení.

  • Vyhledávání indexuje pouze schválenou revizi a odstraňuje vyřazené trasy.

Prokázat oprávnění, revize a vrácení zpět

Testy jádra a funkčnosti by měly zahrnovat ověřování v terénu, řízení přístupu, přechody moderování, vytváření revizí, detekci zastaralého zdroje, opakování fronty, zneplatnění mezipaměti, přístup k trase a vykreslování všech podporovaných komponent. Otestujte Drupal cron a externí fronty, včetně překrývajících se pracovníků a opakovaných úloh. Testy prohlížeče by měly provádět kompletní redakční pracovní postup s každou rolí a použitím frontendu pouze s klávesnicí.

Vydání se správou konfigurace, aktualizačními háky, rotací pověření, řídicími panely front, přehráním neúspěšných úloh, minimalizací protokolů, zálohováním databáze a runbookem pro vrácení zpět. Importujte konfiguraci do produkčního prostředí a potvrďte, že existující balíčky, překlady, oprávnění a pohledy zůstanou nedotčeny. Přijetí zahrnuje obnovení předchozí schválené revize, opětovné sestavení mezipaměti a indexů a potvrzení, že veřejné adresy URL a záznamy auditu zůstávají správné.

Role, důkazy a schválení

Generování uchovávejte odděleně od publikace. Úspěšná odpověď je návrh, nikoli schválení. Uložte identifikátor zdroje a verzi, nastavení transformace, identifikátor výsledku, stav recenze, schvalovatele a čas publikace. Když se zdroj změní, místo tichého nahrazování schváleného obsahu označte jazykovou verzi ke kontrole. To umožňuje rollback a audit napříč platformami.

Provoz a údržba

Publikací práce nekončí. Propojte jazykovou verzi nebo konfiguraci s jejím zdrojem, sledujte měření kvality a služeb a definujte konkrétní spouštěče kontroly. Spouštěče zahrnují změny zdroje, právní změny, nové potřeby publika, opakující se otázky podpory, technické změny a incidenty. Jmenovaný vlastník vyhodnotí spouštěč, v případě potřeby otevře novou revizi a zaznamená obnovené schválení.

Kontrolní seznam pro zveřejnění

  • Integrace využívá trvalé identifikátory zdroje.

  • Pověření se ukládají na straně serveru a střídají se.

  • Je definován časový limit, opakování a chování při omezení rychlosti.

  • Opakované žádosti jsou idempotentní.

  • Vygenerovaný obsah přejde do stavu recenze.

  • Změny zdroje zruší platnost nebo znovu otevřou verzi.

  • Jazyková navigace funguje pomocí klávesnice a asistenční technologie.

  • Monitorování pokrývá selhání, fronty, latenci a zastaralý obsah.

Odborné zdroje

  1. Simple8 Dokumentace API
  2. Vzory dodávek Simple8
  3. Pokyny pro přístupnost webového obsahu (WCAG) 2.2

Uveďte návod do praxe

Otestujte Simple8 s reprezentativním obsahem a použijte kontrolní seznam k plánování řízeného výrobního pracovního postupu.

Otestujte si svůj vlastní text