CMS ja API

Drupal rakendamise juhend.

Kasutage Drupal versioone, sisu modereerimist ja lubasid genereerimise, spetsialistide ülevaatuse ja avaldamise eraldamiseks.

Selgitage ülesanne ja otsus

See juhend muudab drupal juurutamise juhendi ülevaatavaks töövooks. See ühendab domeeniotsused, omandiõiguse, tõendid ja aktsepteerimise, nii et tulemus töötab tootmises edasi.

Kasutage Drupal versioone, sisu modereerimist ja lubasid genereerimise, spetsialistide ülevaatuse ja avaldamise eraldamiseks.

Praktiline töövoog

  1. 1

    Varude allika tüübid, identifikaatorid, väljad, lokaadid, omanikud ja avaldamise olekud.

  2. 2

    Valige tarnemuster helitugevuse, latentsuse, toimetuse juhtimise ja tõrketaluvuse hulgast.

  3. 3

    Vastandage lähtekirje püsiva sidemega eraldi keeleversiooni kirjega.

  4. 4

    Lisage autentimine, idempotentsus, uuesti proovimine, vahemälu kehtetuks tunnistamine, logimine ja juurdepääsu juhtelemendid.

  5. 5

    Testi avaldamine, allika muudatused, kättesaamatud tulemused, tagasipööramine, klaviatuuri kasutamine ja jälgimine enne avaldamist.

Näide või tööriist

Modereeritud sisutüüp näitab välju, rolle, versioone, edastamist ja tagasipööramist. Tööriistas registreerige ka lähteseisund, omanik, otsus, tõendid, avatud probleem ja kinnitamise kuupäev. Kasutage päris lehte või tehingut, et meeskond näeks sõltuvusi, erandeid ja väljalaskmisele järgnevat hooldustööd.

OtsustuspunktSalvestusVastuvõtmise kriteerium
LähtejoonTäheldatud hetkeseisuAllikas ja salvestamise kuupäev
OtsusValitud variant ja põhjendusArvestatud on riski ja publikuga
TõendidTestige, dokumenteerige või mõõtkeÜlevaatav ja versioonipõhine
HeakskiitNimi, roll ja kuupäevKõik kohustuslikud kriteeriumid on täidetud

Looge sisumudel, mis säilitab päritolu

Looge juurdepääsetava keele sisutüüp või struktureeritud olem koos olemi viitega autoriteetsele allikale. Kaasake allika versiooni ID, lokaat, keelerežiim, tulemuse ID, ülevaatuse olek, sõnastiku versioon, riskitase, kinnitajad ja järgmise ülevaatuse käivitaja. Kasutage rubriike või struktureeritud välju pealkirjade, loendite, linkide, teadete, allalaadimiste ja kontaktteabe jaoks. Üks piiranguteta rikastekstiväli muudab väljataseme valideerimise, taaskasutamise ja turvalise renderdamise keerulisemaks.

Valige teadlikult Drupal tõlkesuhte ja eraldi seotud olemi vahel. Standardtõlge töötab siis, kui välja struktuur ja toimetuse elutsükkel on samaväärsed. Eraldi olem on turvalisem, kui juurdepääsetav versioon kombineerib, järjestab ümber või selgitab lähtevälju ja vajab erinevat modereerimist. Mõlemal juhul jätke allika redaktsioon teisenduse jaoks muutumatuks ja kuvage aegunud olek, kui praegune allikas sellele enam ei ühti.

Disaini valikKasutage millalNõutav kaitse
Sisu tõlgeStruktuur ja elutsükkel jäävad samaväärseksRedaktsiooni tõlge on mõjutatud ja modereerimist testitud
Seotud üksusStruktuur, omandiõigus või ülevaade on erinevadSelge allikaviide ja vastastikune navigeerimine
Lõigu kaardistamineAllikas sisaldab korduvkasutatavaid struktureeritud plokkeToetamata pakettplokkide või lippude loomine

Eraldi looming, spetsialistide ülevaade ja avaldamine

Sisu modereerimise olekute konfigureerimine, nagu taotletud, loomine, mustand, teema ülevaade, keeleülevaade, heaks kiidetud, avaldatud, aegunud ja ebaõnnestunud. Määrake üleminekud pühendatud rollide jaoks ja kontrollige neid Drupal lubade ja juurdepääsu töötlejatega. Integratsioonikonto API saab luua ja värskendada mustandit, kuid ei saa seda kinnitada ega avaldada. Teema ülevaataja ei saa oma kõrge riskiga genereerimist heaks kiita, välja arvatud juhul, kui dokumenteeritud riskipoliitika seda lubab.

Lubage versioonid ja tagage, et iga teisendus, kommentaaride lahendamine, oleku üleminek ja allika ümberandmine loob autori ja ajatempliga redaktsiooni. Looge ülevaatevaade, mis näitab allikat ja mustandit, erinevusi, hoiatusi, linke ja renderdatud tulemust. Kui allikas muutub, märkige aktiivne mustand ja avaldatud versioon asjakohaselt ning blokeerige avaldamine, kuni ülevaataja lahendab mittevastavuse.

  1. 1

    Olemiväljade, valideerimise, versioonide ja allika seose konfigureerimine.

  2. 2

    Loo modereerimisolekud ja rollipõhised üleminekud.

  3. 3

    Looge mustand piiratud järjekorra töötaja kaudu.

  4. 4

    Täitke ühe tuvastatud redaktsiooni teema- ja keeleülevaateid.

  5. 5

    Avaldage, indekseerige ja säilitage kontrolljälg allikast väljalaskeni.

Tarnige Drupal vahemällu ja juurdepääsetavuse korral

Lisage vahemälusildid lähteolemi, allika redaktsiooniseoste, keeleolemi, viidatud lõikude ja meediumide, sõnastiku konfiguratsiooni ja renderdaja jaoks. Kasutage lokaadi ja mis tahes legitiimse juurdepääsuvariatsiooni jaoks vahemälu kontekste, kuid ärge muutke heakskiidetud avalikke lehti sõltuvaks kasutajapõhisest genereerimise olekust. Mõjutatud lehtede kehtetuks tunnistamine olemi muutmise või järjekorra lõpetamise kaudu ja viimane kinnitatud redaktsioon asenduslehe ülevaatamise ajal nähtavana.

Renderdage keeleline navigeerimine tavaliste linkidena Drupal marsruutimise ja keeleteadliku URL-i genereerimise kaudu. Lisage vastastikused allikalingid, alternatiivse keele metaandmed, teerad ja saidiplaani kirjed. Kontrollige päise hierarhiat, lingi eesmärki, fookuse järjekorda, olekuteateid ja vormivea seost lõplikus teemas. Desinfitseerige API väljund lubatud struktureeritud väljade ja Drupal renderdussüsteemi kaudu. Ärge kunagi märkige loodud HTML-i turvaliseks ainult seetõttu, et see pärineb usaldusväärsest serverist.

  • Vahemälusildid hõlmavad allikat, keeleversiooni, komponente, meediat, sõnastikku ja renderdajat.

  • Järjekorratöötlus ei saa sisu avaldada ega viimast kinnitatud tulemust enneaegselt kustutada.

  • Keelemarsruudid ja allikalingid töötavad ilma JavaScriptita.

  • Tekstivormingud ja renderdusmassiivid takistavad ebaturvalist märgistamist.

  • Otsing indekseerib ainult kinnitatud versiooni ja eemaldab kasutusest kõrvaldatud marsruudid.

Tõesta õigusi, versioone ja tagasipööramist

Kerneli ja funktsionaalsuse testid peaksid hõlmama välja valideerimist, juurdepääsu kontrolli, modereerimise üleminekuid, versioonide loomist, aegunud allika tuvastamist, järjekorra korduskatseid, vahemälu kehtetuks tunnistamist, juurdepääsu marsruudile ja iga toetatud komponendi renderdamist. Testige Drupal croni ja väliseid järjekorra jooksjaid, sealhulgas kattuvaid töötajaid ja korduvaid töid. Brauseri testid peaksid rakendama täielikku toimetustöövoogu iga rolli ja ainult klaviatuuri kasutajaliidesega.

Väljalase koos konfiguratsioonihalduse, värskenduskonksude, mandaatide pööramise, järjekorra armatuurlaudade, ebaõnnestunud töö kordusesituse, logi minimeerimise, andmebaasi varundamise ja tagasipööramise käsiraamatuga. Importige konfiguratsioon tootmiskeskkonda ja veenduge, et olemasolevad paketid, tõlked, load ja vaated jäävad puutumata. Nõustumine hõlmab eelmise heakskiidetud versiooni taastamist, vahemälu ja indeksite taastamist ning kinnitamist, et avalikud URL-id ja auditikirjed jäävad õigeks.

Rollid, tõendid ja heakskiit

Hoidke genereerimine avaldamisest eraldi. Edukas vastus on mustand, mitte heakskiit. Salvestage allika identifikaator ja versioon, teisendusseaded, tulemuse identifikaator, ülevaatuse olek, kinnitaja ja avaldamise aeg. Kui allikas muutub, märkige heakskiidetud sisu vaikselt asendamise asemel ülevaatamiseks keeleversioon. See muudab tagasipööramise ja auditi võimalikuks platvormide lõikes.

Toimingud ja hooldus

Töö avaldamisega ei lõpe. Linkige keeleversioon või konfiguratsioon selle allikaga, jälgige kvaliteedi- ja teenindusmeetmeid ning määrake konkreetsed ülevaatuse käivitajad. Käivitajad hõlmavad allikamuudatusi, juriidilisi muudatusi, uusi vaatajaskonna vajadusi, korduvaid tugiküsimusi, tehnilisi muudatusi ja vahejuhtumeid. Nimega omanik hindab päästikut, avab vajaduse korral uue versiooni ja registreerib uuendatud kinnituse.

Avaldamise kontrollnimekiri

  • Integreerimine kasutab püsivaid allikaidentifikaatoreid.

  • Mandaadid salvestatakse serveri poole ja neid pööratakse.

  • Määratud on ajalõpp, uuesti proovimine ja kiiruspiirangu käitumine.

  • Korduvad taotlused on idempotentsed.

  • Loodud sisu läheb ülevaatuse olekusse.

  • Allika muudatused muudavad versiooni kehtetuks või avavad selle uuesti.

  • Keeles navigeerimine töötab klaviatuuri ja abitehnoloogia abil.

  • Järelevalve hõlmab tõrkeid, järjekordi, latentsust ja aegunud sisu.

Usaldusväärsed allikad

  1. Simple8 API dokumentatsioon
  2. Simple8 tarnemustrid
  3. Veebisisu juurdepääsetavuse juhised (WCAG) 2.2

Rakendage juhend praktikas

Testige esindusliku sisuga Simple8-i ja kasutage kontrollitud tootmise töövoo kavandamiseks kontrollnimekirja.

Testige oma teksti