CMS i API

Vodič za implementaciju Drupal.

Koristite Drupal revizije, moderiranje sadržaja i dopuštenja za odvajanje generiranja, stručnog pregleda i objavljivanja.

Pojasnite zadatak i odluku

Ovaj vodič pretvara vodič za implementaciju drupal-a u pregledni radni tijek. Povezuje odluke o domeni, vlasništvo, dokaze i prihvaćanje tako da rezultat nastavlja raditi u proizvodnji.

Koristite Drupal revizije, moderiranje sadržaja i dopuštenja za odvajanje generiranja, stručnog pregleda i objavljivanja.

Praktični postupak

  1. 1

    Vrste izvora inventara, identifikatori, polja, lokalizacije, vlasnici i stanja publikacije.

  2. 2

    Odaberite uzorak isporuke između volumena, latencije, uredničke kontrole i tolerancije kvarova.

  3. 3

    Mapirajte izvorni zapis u zasebni zapis jezične verzije s trajnom vezom.

  4. 4

    Dodajte autentifikaciju, idempotenciju, ponovni pokušaj, poništavanje predmemorije, bilježenje i kontrole pristupa.

  5. 5

    Probno objavljivanje, promjene izvora, nedostupni rezultati, vraćanje, rad tipkovnice i praćenje prije izdavanja.

Primjer ili alat

Moderirana vrsta sadržaja prikazuje polja, uloge, revizije, isporuku i vraćanje. U alat također zabilježite početnu vrijednost, vlasnika, odluku, dokaze, otvoreni problem i datum odobrenja. Koristite pravu stranicu ili transakciju kako bi tim vidio ovisnosti, iznimke i rad na održavanju koji slijedi nakon izdavanja.

Točka odlukeSnimitiKriterij prihvatljivosti
Osnovna linijaPromatrano trenutno stanjeIzvor i datum snimanja
OdlukaOdabrana opcija i obrazloženjeRizik i publika uzeti u obzir
DokazTestirajte, dokumentirajte ili izmjeriteMože se pregledati i ovisi o verziji
OdobrenjeIme, uloga i datumZadovoljeni svi obvezni kriteriji

Stvorite model sadržaja koji čuva porijeklo

Stvorite vrstu sadržaja na pristupačnom jeziku ili strukturirani entitet s referencom entiteta na vjerodostojni izvor. Uključi ID izvorne revizije, lokalizaciju, jezični način, ID rezultata, stanje pregleda, verziju pojmovnika, razinu rizika, odobravatelje i okidač sljedećeg pregleda. Koristite odlomke ili strukturirana polja za naslove, popise, poveznice, obavijesti, preuzimanja i podatke za kontakt. Jedno polje obogaćenog teksta bez ograničenja otežava provjeru valjanosti na razini polja, ponovnu upotrebu i sigurno prikazivanje.

Odaberite namjerno između relacije prijevoda Drupal-a i zasebnog povezanog entiteta. Standardni prijevod funkcionira kada struktura polja i urednički životni ciklus ostaju ekvivalentni. Zasebni entitet je sigurniji kada pristupačna verzija kombinira, mijenja redoslijed ili objašnjava izvorna polja i treba drugačije moderiranje. U svakom slučaju, zadržite izvornu reviziju nepromjenjivom za transformaciju i prikažite zastarjeli status kada mu trenutni izvor više ne odgovara.

Izbor dizajnaKoristite kadaPotrebna zaštita
Prijevod sadržajaStruktura i životni ciklus ostaju jednakiRevizija prijevoda je pogođena i moderiranje je testirano
Povezani entitetStruktura, vlasništvo ili pregled se razlikujuEksplicitna referenca izvora i recipročna navigacija
Preslikavanje odlomakaIzvor sadrži strukturirane blokove koji se mogu ponovno koristitiNepodržani blokovi paketa ili generiranje oznaka

Odvojena izrada, stručni pregled i objava

Konfigurirajte stanja moderiranja sadržaja kao što su traženo, generiranje, nacrt, pregled predmeta, pregled jezika, odobreno, objavljeno, zastarjelo i neuspjelo. Definirajte prijelaze za namjenske uloge i provjerite ih pomoću Drupal dozvola i rukovatelja pristupom. Integracijski račun API može kreirati i ažurirati nacrt, ali ne može odobriti ili objaviti. Predmetni recenzent ne može odobriti vlastitu visokorizičnu generaciju osim ako to ne dopušta dokumentirana politika rizika.

Omogućite revizije i osigurajte da svaka transformacija, razrješenje komentara, prijelaz statusa i ponovna baza izvora stvaraju reviziju s autorom i vremenskom oznakom. Izgradite prikaz pregleda koji prikazuje izvor i nacrt, razlike, upozorenja, veze i prikazani rezultat. Ako se izvor promijeni, označite aktivnu skicu i objavljenu verziju na odgovarajući način i blokirajte objavljivanje dok recenzent ne riješi neslaganje.

  1. 1

    Konfigurirajte polja entiteta, provjeru valjanosti, revizije i odnos izvora.

  2. 2

    Stvorite moderirana stanja i prijelaze specifične za ulogu.

  3. 3

    Generirajte nacrt putem ograničenog radnika čekanja.

  4. 4

    Kompletan pregled predmeta i jezika na jednoj identificiranoj reviziji.

  5. 5

    Objavite, indeksirajte i zadržite revizijski trag od izvora do objave.

Isporučite s netaknutom mogućnošću predmemoriranja Drupal i dostupnošću

Priložite oznake predmemorije za izvorni entitet, odnos revizija izvora, jezični entitet, referencirane odlomke i medije, konfiguraciju pojmovnika i renderer. Koristite kontekste predmemorije za lokalizaciju i bilo koju legitimnu varijaciju pristupa, ali ne ovisite odobrene javne stranice o statusu generacije korisnika. Poništite zahvaćene stranice kroz izmjene entiteta ili dovršetak čekanja i zadržite posljednju odobrenu reviziju vidljivom dok se pregledava zamjena.

Prikazujte jezičnu navigaciju kao obične veze putem Drupal usmjeravanja i generiranja URL-a s obzirom na jezik. Dodajte uzajamne izvorne veze, metapodatke na alternativnom jeziku, putove kroz web stranicu i unose karte web-lokacije. Provjerite hijerarhiju naslova, svrhu poveznice, redoslijed fokusa, poruke o statusu i povezanost pogreške obrasca u konačnoj temi. Očistite API izlaz kroz dopuštena strukturirana polja i Drupal-ov sustav renderiranja. Nikada ne označavajte generirani HTML sigurnim samo zato što je došao s pouzdanog poslužitelja.

  • Oznake predmemorije pokrivaju izvor, jezičnu verziju, komponente, medije, glosar i renderer.

  • Obrada čekanja ne može objaviti sadržaj ili izbrisati posljednji odobreni rezultat prije vremena.

  • Jezične rute i izvorne veze rade bez JavaScripta.

  • Formati teksta i nizovi generiranja sprječavaju nesigurno označavanje.

  • Pretraživanje indeksira samo odobrenu reviziju i uklanja povučene rute.

Dokažite dopuštenja, revizije i vraćanje

Kernel i funkcionalni testovi trebali bi pokriti provjeru valjanosti polja, kontrolu pristupa, moderiranje prijelaza, stvaranje revizije, otkrivanje ustajalog izvora, ponovne pokušaje čekanja, poništavanje predmemorije, pristup ruti i renderiranje svake podržane komponente. Testirajte Drupal cron i vanjske pokretače čekanja, uključujući radnike koji se preklapaju i ponovljene poslove. Testovi preglednika trebali bi provoditi kompletan tijek uredničkog rada sa svakom ulogom i korištenjem samo sučelja na tipkovnici.

Izdanje s upravljanjem konfiguracijom, ažuriranjem spojnica, rotacijom vjerodajnica, nadzornim pločama čekanja, ponavljanjem neuspjelih zadataka, minimizacijom dnevnika, sigurnosnom kopijom baze podataka i knjigom za vraćanje na staro stanje. Uvezite konfiguraciju u okruženje slično proizvodnom i potvrdite da postojeći paketi, prijevodi, dopuštenja i pogledi ostaju netaknuti. Prihvaćanje uključuje vraćanje prethodne odobrene revizije, ponovnu izgradnju predmemorija i indeksa te potvrdu da javni URL-ovi i revizijski zapisi ostaju ispravni.

Uloge, dokazi i odobrenje

Generiranje odvojite od objavljivanja. Uspješan odgovor je nacrt, a ne odobrenje. Pohranite izvorni identifikator i verziju, postavke transformacije, identifikator rezultata, stanje pregleda, odobravatelja i vrijeme objave. Kada se izvor promijeni, označite jezičnu verziju za pregled umjesto tihe zamjene odobrenog sadržaja. To omogućuje vraćanje i reviziju na više platformi.

Operacije i održavanje

Rad ne završava objavljivanjem. Povežite jezičnu verziju ili konfiguraciju s izvorom, nadzirite mjere kvalitete i usluge i definirajte konkretne okidače pregleda. Okidači uključuju promjene izvora, pravne promjene, nove potrebe publike, pitanja podrške koja se ponavljaju, tehničke promjene i incidente. Imenovani vlasnik procjenjuje okidač, otvara novu reviziju po potrebi i bilježi obnovljeno odobrenje.

Kontrolni popis za objavu

  • Integracija koristi trajne identifikatore izvora.

  • Vjerodajnice se pohranjuju na strani poslužitelja i rotiraju.

  • Definirano je vremensko ograničenje, ponovni pokušaj i ponašanje ograničenja brzine.

  • Ponovljeni zahtjevi su idempotentni.

  • Generirani sadržaj ulazi u stanje pregleda.

  • Promjene izvora poništavaju ili ponovno otvaraju verziju.

  • Jezična navigacija radi pomoću tipkovnice i pomoćne tehnologije.

  • Praćenje pokriva kvarove, redove čekanja, latenciju i zastarjeli sadržaj.

Mjerodavni izvori

  1. Simple8 API dokumentacija
  2. Simple8 uzorci isporuke
  3. Smjernice za pristupačnost web sadržaja (WCAG) 2.2

Provedite vodič u praksi

Testirajte Simple8 s reprezentativnim sadržajem i koristite kontrolni popis za planiranje kontroliranog proizvodnog tijeka rada.

Testirajte vlastiti tekst