CMS u API

Gwida ta 'implimentazzjoni TYPO3.

Mudell ta' verżjonijiet b'lingwa aċċessibbli bħala rekords regolati konnessi mal-kontenut tas-sors tagħhom u l-approvazzjoni tal-ispazju tax-xogħol.

Iċċara l-kompitu u d-deċiżjoni

Din il-gwida ddawwar il-gwida ta 'implimentazzjoni typo3 fi fluss tax-xogħol operattiv li jista' jiġi rivedut. Tgħaqqad id-deċiżjonijiet tad-dominju, is-sjieda, l-evidenza u l-aċċettazzjoni sabiex ir-riżultat ikompli jaħdem fil-produzzjoni.

Mudell ta' verżjonijiet b'lingwa aċċessibbli bħala rekords regolati konnessi mal-kontenut tas-sors tagħhom u l-approvazzjoni tal-ispazju tax-xogħol.

Proċess prattiku

  1. 1

    Tipi ta 'sors ta' inventarju, identifikaturi, oqsma, lokalitajiet, sidien, u stati ta 'pubblikazzjoni.

  2. 2

    Agħżel il-mudell tal-kunsinna minn volum, latency, kontroll editorjali, u tolleranza ta 'falliment.

  3. 3

    Immappja r-rekord tas-sors għal rekord separat tal-verżjoni tal-lingwa b'rabta durabbli.

  4. 4

    Żid awtentikazzjoni, idempotenza, ipprova mill-ġdid, invalidazzjoni tal-cache, illoggjar, u kontrolli tal-aċċess.

  5. 5

    Pubblikazzjoni tat-test, bidliet fis-sors, riżultati mhux disponibbli, rollback, tħaddim tat-tastiera, u monitoraġġ qabel ir-rilaxx.

Eżempju jew għodda

Eżempju ta' spazju tax-xogħol TYPO3 ikopri l-immappjar tal-kamp, ​​ir-relazzjonijiet tat-traduzzjoni, l-iskjerament, u l-invalidazzjoni. Fl-għodda, irreġistra wkoll il-linja bażi, is-sid, id-deċiżjoni, l-evidenza, il-ħruġ miftuħ u d-data tal-approvazzjoni. Uża paġna jew transazzjoni reali sabiex it-tim jara dipendenzi, eċċezzjonijiet, u x-xogħol ta 'manutenzjoni li jsegwi r-rilaxx.

Punt tad-deċiżjoniRekordKriterju ta' aċċettazzjoni
Linja bażiStat attwali osservatSors u data rreġistrati
DeċiżjoniGħażla magħżula u raġuniRiskju u udjenza kkunsidrati
EvidenzaTest, dokument, jew kejlRivedibbli u speċifiku għall-verżjoni
ApprovazzjoniIsem, rwol, u dataIl-kriterji obbligatorji kollha sodisfatti

Verżjonijiet tal-lingwa mudell bħala rekords regolati

Uża rekord ta' kontenut iddedikat jew tip ta' paġna għal verżjoni b'lingwa aċċessibbli u qabbadha mas-sors b'relazzjoni immutabbli. Aħżen l-UID tas-sors, ir-reviżjoni tal-ispazju tax-xogħol tas-sors jew il-hash tal-kontenut, il-lokal fil-mira, il-mod tal-lingwa, l-ID tar-riżultat tat-trasformazzjoni, l-istat tar-reviżjoni, il-verżjoni tal-glossarju, l-approvaturi, u l-aħħar data verifikata. Żomm din ir-relazzjoni separata mir-relazzjoni ta’ traduzzjoni lokali ordinarja ta’ TYPO3 meta l-verżjoni tbiddel l-istruttura jew id-densità tal-informazzjoni aktar milli l-lingwa biss.

Map oqsma tas-sors strutturati deliberatament. Ippreserva l-intestaturi, il-paragrafi, il-listi, il-links, it-tabelli, l-avviżi, it-tniżżil u l-blokki tal-kuntatt bħala elementi semantiċi. Iddefinixxi riżerva sigura għal kull element ta' kontenut mhux appoġġjat: żommu bi twissija ta' reviżur, ibdelha b'komponent ta' sommarju approvat, jew imblokka l-ġenerazzjoni. Qatt twaqqa' element mhux magħruf fis-skiet. Ir-referenzi u l-links tal-fajls iżommu l-identifikaturi tagħhom sabiex il-validazzjoni tkun tista’ tiskopri dipendenzi mibdula jew imħassra.

Rekord fieldGħanImġieba meħtieġa
source_uidTgħaqqad il-verżjoni u s-sorsRelazzjoni immutabbli mal-kontroll tal-permess
reviżjoni_sorsJiskopri bidliet fis-sorsImmarka verżjoni approvata għal reviżjoni meta differenti
review_stateJikkontrolla l-fluss tax-xogħolTranżizzjoni ristretta mir-rwol backend
result_idJappoġġja t-traċċabilitàMaħżuna b'settings u ħin tat-talba

Uża l-ispazji tax-xogħol għall-ġenerazzjoni, reviżjoni, u approvazzjoni

Oħloq ir-riżultat iġġenerat fi spazju tax-xogħol ikkontrollat, qatt direttament fl-ispazju tax-xogħol ħaj. Rwol ta' ġenerazzjoni jista' jitlob u jaġġorna abbozzi. Reviżur tas-suġġett jikkonferma kundizzjonijiet, figuri, dati, responsabbiltajiet, u links. Reviżur tal-lingwa jiċċekkja l-mod magħżul u l-vjaġġ mogħti. Pubblikatur jivverifika s-sejbiet solvuti u jmexxi r-reviżjoni approvata mill-istadju tal-ispazju tax-xogħol stabbilit. Inforza dawn il-kapaċitajiet fil-permessi backend u l-loġika tat-tranżizzjoni min-naħa tas-server.

Ikkonfigura notifiki tal-istadju bl-URL tar-rekord, ir-reviżjoni tas-sors, il-livell tar-riskju, ir-rwol meħtieġ u d-data dovuta. Ir-reviżuri jeħtieġu diff sinifikanti li jiddistingwi l-bidliet fil-kontenut mill-istorbju tal-metadata TYPO3. Jekk is-sors jiġi editjat waqt li r-reviżjoni tkun miftuħa, immarka l-verżjoni mhux użata u rrikjedi li t-tim jagħżel bejn jibbaża mill-ġdid l-abbozz jew jimla eċċezzjoni rreġistrata b’mod espliċitu. Is-sistema għandha tipprevjeni approvazzjoni qadima milli tasal ħaj.

  1. 1

    Oħloq jew identifika r-rekord tas-sors u aqbad ir-reviżjoni tal-ispazju tax-xogħol tiegħu.

  2. 2

    Iġġenera l-verżjoni strutturata fl-ispazju tax-xogħol assenjat.

  3. 3

    Imla l-validazzjoni tas-suġġett, il-lingwa u l-link fuq il-preview mogħtija.

  4. 4

    Issolvi s-sejbiet u kkonferma li r-reviżjoni tas-sors għadha attwali.

  5. 5

    Ippubblika r-rekord approvat u żomm l-istorja sħiħa tal-ispazju tax-xogħol.

Uża u invalida mingħajr ma titlef il-kontenut approvat

Oħloq titjib tar-rotta u metadejta tal-paġna li jagħtu lil kull verżjoni URL stabbli u li jinqara. Ippubblika links tal-lingwa reċiproka u relazzjonijiet kanoniċi f'markup mogħti mis-server. Inkludi l-verżjoni fit-tfittxija tas-sit u l-mapep tas-sit XML biss wara l-approvazzjoni. Ikkonfigura r-restrizzjonijiet tal-aċċess b'mod espliċitu u ivverifika li paġna tal-lingwa pubblika ma tirretx restrizzjoni mhux intenzjonata tal-paġna tas-sors jew tesponix kontenut tas-sors protett.

Invalida l-caches tal-frontend korretti meta l-verżjoni approvata, is-sors, il-fajl referenzjat, l-element tal-kontenut kondiviż, il-mudell tar-rendi, jew il-glossarju jinbidel. Uża tikketti tal-cache li jinkludu identifikaturi kemm tas-sors kif ukoll tal-verżjoni. Matul il-ġenerazzjoni jew ir-reviżjoni, kompli jaqdi l-aħħar rekord approvat. Talba falluta toħloq kompitu backend viżibbli u avveniment operattiv, iżda ma tnaddafx paġna pubblika valida jew tissostitwiha b'abbozz.

  • Kull verżjoni pubblika għandha rotta stabbli u rabta ta' sors reċiproku.

  • It-tfittxija u l-mappa tas-sit jinkludu rekords approvati biss.

  • Tikketti tal-cache ikopru sors, verżjoni, elementi kondiviżi, fajls u renderer.

  • Sorsi protetti ma jistgħux joħorġu minn rekords pubbliċi ġġenerati.

  • L-aħħar rekord approvat jibqa’ disponibbli waqt il-fallimenti u r-reviżjoni.

Opera l-estensjoni permezz ta 'titjib TYPO3

Ittestja l-estensjoni mal-verżjonijiet ta' appoġġ fit-tul TYPO3 appoġġjati, verżjonijiet PHP, database, konfigurazzjoni multilingwi, spazji tax-xogħol, scheduler, estensjoni tat-tiftix, u saff ta' caching. Testijiet ta' integrazzjoni awtomatizzati għandhom ikopru verifiki tal-permessi ta' backend, ganċijiet tad-DataHandler, persistenza tar-relazzjoni, tranżizzjonijiet tal-ispazju tax-xogħol, invalidazzjoni tal-cache, falliment ta' API, u skoperta ta' sors skadut. It-testijiet tal-browser ikopru l-operat tat-tastiera backend u n-navigazzjoni tal-frontend f'wisgħat rappreżentattivi.

Qabel ir-rilaxx, xogħlijiet ta 'skedar tad-dokumenti, monitoraġġ tal-kju, rotazzjoni tal-kredenzjali, żamma ta' log, backup u restawr, migrazzjoni ta 'skema, u diżattivazzjoni ta' estensjoni sigura. Agħmel titjib l-ewwel fuq kopja ta' stadji bħal produzzjoni u vverifika rekords approvati qodma qabel ma toħloq oħrajn ġodda. L-aċċettazzjoni tinkludi rollback b'suċċess kemm tal-kodiċi tal-estensjoni kif ukoll tal-migrazzjoni tad-database, b'kontenut ippubblikat għadu disponibbli u l-istorja tal-awditjar tiegħu intatta.

Rwoli, evidenza, u approvazzjoni

Żomm il-ġenerazzjoni separata mill-pubblikazzjoni. Reazzjoni b'suċċess hija abbozz, mhux approvazzjoni. Aħżen l-identifikatur tas-sors u l-verżjoni, is-settings tat-trasformazzjoni, l-identifikatur tar-riżultat, l-istat tar-reviżjoni, l-approvazzjoni, u l-ħin tal-pubblikazzjoni. Meta s-sors jinbidel, immarka l-verżjoni tal-lingwa għal reviżjoni minflok ma tissostitwixxi bil-kwiet il-kontenut approvat. Dan jagħmel ir-rollback u l-awditjar possibbli fuq il-pjattaformi kollha.

Operazzjonijiet u manutenzjoni

Ix-xogħol ma jispiċċax mal-pubblikazzjoni. Qabbad il-verżjoni tal-lingwa jew il-konfigurazzjoni mas-sors tagħha, timmonitorja l-kwalità u l-miżuri tas-servizz, u ddefinixxi l-kawżi konkreti tar-reviżjoni. It-tqanqil jinkludu bidliet fis-sors, bidliet legali, ħtiġijiet ġodda ta 'udjenza, mistoqsijiet ta' appoġġ rikorrenti, bidliet tekniċi, u inċidenti. Sid imsemmi jevalwa l-grillu, jiftaħ reviżjoni ġdida meta jkun meħtieġ, u jirreġistra approvazzjoni mġedda.

Lista ta' kontroll għall-pubblikazzjoni

  • L-integrazzjoni tuża identifikaturi tas-sors durabbli.

  • Il-kredenzjali huma maħżuna fuq in-naħa tas-server u mdawra.

  • Il-timeout, il-prova mill-ġdid, u l-imġieba tal-limitu tar-rata huma definiti.

  • Talbiet ripetuti huma idempotenti.

  • Il-kontenut iġġenerat jidħol fi stat ta' reviżjoni.

  • Il-bidliet fis-sors jinvalidaw jew jerġgħu jiftħu l-verżjoni.

  • In-navigazzjoni lingwistika taħdem bit-tastiera u t-teknoloġija assistiva.

  • Il-monitoraġġ ikopri fallimenti, kjuwijiet, latency, u kontenut mhux użat.

Sorsi awtorevoli

  1. Simple8 API dokumentazzjoni
  2. Mudelli ta 'kunsinna Simple8
  3. Linji Gwida għall-Aċċessibilità tal-Kontenut tal-Web (WCAG) 2.2

Poġġi l-gwida fil-prattika

Ittestja Simple8 b'kontenut rappreżentattiv u uża l-lista ta 'kontroll biex tippjana fluss tax-xogħol ta' produzzjoni kkontrollat.

Ittestja t-test tiegħek