CMS u API

Gwida tal-widget tal-websajt.

Uża l-widget meta skjerament rapidu jkun importanti u s-sit jista' jipprovdi identifikaturi tas-sors durabbli u navigazzjoni lingwistika aċċessibbli.

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

Din il-gwida ddawwar il-gwida tal-widget tal-websajt 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.

Uża l-widget meta skjerament rapidu jkun importanti u s-sit jista' jipprovdi identifikaturi tas-sors durabbli u navigazzjoni lingwistika aċċessibbli.

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

Mudell ta' skjerament ikopri t-tagħbija, il-verżjonijiet mhux disponibbli, il-ġestjoni tal-fokus, l-analiżi, u l-imġieba mingħajr skript. 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

Ikkonferma li widget huwa l-mudell tal-kunsinna t-tajjeb

Widget huwa adattat meta s-sit ospitanti jista 'jipprovdi identifikaturi tas-sors stabbli, paġni jaqsmu struttura ta' kontenut prevedibbli, kwistjonijiet ta 'skjerament rapidu, u titjib min-naħa tal-klijent huwa aċċettabbli. Huwa inqas adattat meta verżjonijiet alternattivi għandhom ikunu indiċjati bis-sħiħ, għandhom jaħdmu taħt restrizzjonijiet stretti tal-iskript, jew jappartjenu għal vjaġġ awtentikat kumpless. F'dawk il-każijiet, paġni mogħtija mis-server jew integrazzjoni CMS jipprovdu kontroll aktar b'saħħtu.

Imla rekord qasir ta' deċiżjoni dwar l-arkitettura li jkopri s-sjieda tal-kontenut, id-dejta mibgħuta lis-servizz, l-hosting tal-iskripts, l-implikazzjonijiet tal-kunsens, il-Politika tas-Sigurtà tal-Kontenut, il-baġit tal-prestazzjoni, l-appoġġ tal-browser, l-aċċessibbiltà, l-imġieba tat-tfittxija, l-analiżi, l-istat tal-falliment, u r-responsabbiltà tal-manutenzjoni. Il-widget għandu jtejjeb il-paġna aktar milli jsir l-unika rotta għal informazzjoni essenzjali. Is-servizz oriġinali jibqa' użabbli meta l-iskript ikun imblukkat, bil-mod jew mhux disponibbli.

KriterjuWidget tajjeb tajjebJippreferi l-kunsinna fuq in-naħa tas-server
TnedijaIs-sit ikkontrollat ​​jeħtieġ żieda rapidaMeħtieġa fluss tax-xogħol CMS profond u kontroll tar-rilaxx
SkopertaIs-sors jgħaqqad b'mod ċar mal-verżjoni mtejbaIl-paġna alternattiva teħtieġ indiċjar ta' tfittxija indipendenti
ReżiljenzaIs-sors jibqa' riżerva sħiħaVerżjoni alternattiva hija essenzjali biex jitlesta l-kompitu
SigurtàPolitika ta' skript u fluss tad-dejta approvati fuq is-sitLimitazzjonijiet stretti b'kitba jew kuntest awtentikat

Tagħbija progressivament u tipproteġi l-prestazzjoni tal-paġna

Iservi loader b'verżjoni żgħira minn oriġini approvata b'Integrità tas-Subriżorsi fejn il-mudell ta' skjerament jappoġġjaha. Tgħabbiha b'differita, inizjalizza biss wara li jeżisti l-kontenitur rilevanti, u evita li timblokka l-kontenut primarju. L-ospitant jipprovdi ID tal-paġna stabbli, reviżjoni tas-sors, lokali, u modi ta’ lingwa permessi permezz ta’ konfigurazzjoni validata. Qatt tpoġġi kredenzjali API, dejta personali, jew HTML mhux ristrett fl-attributi tad-dejta.

Irriżerva spazju għat-tqassim għall-kontrolli jew daħħalhom mingħajr ma tbiddel l-intestatura prinċipali u l-kontenut tal-kompitu. Issettja baġits tal-prestazzjoni għad-daqs tal-iskript, l-għadd tat-talbiet, u d-dewmien tal-interazzjoni. Aborta wara timeout definit u neħħi l-indikaturi tat-tagħbija. Il-cache approva biss ir-riżultati pubbliċi, billi ddaħħalhom skont ir-reviżjoni tas-sors u l-mod. Widget tard jew fallut ma jaħbi, duplikat, jew jissostitwixxi l-paġna tas-sors.

  1. 1

    Żid link semantika mogħtija minn server jew placeholder tal-kontroll ħdejn l-intestatura tal-paġna.

  2. 2

    Tgħabbi l-iskript verżjoni mingħajr ma timblokka l-kontenut tas-sors.

  3. 3

    Ivvalida l-konfigurazzjoni tal-host u titlob biss verżjoni pubblika approvata.

  4. 4

    Agħti kontrolli u kontenut b'semantika nattiva u fokus prevedibbli.

  5. 5

    Irrapporta l-istatus operattiv mingħajr ma tibgħat kontenut tal-paġna jew dejta tal-utent mhux meħtieġa.

Disinn tan-navigazzjoni u kull stat ta 'falliment

Uża link ordinarju meta l-verżjoni tal-lingwa jkollha l-indirizz tagħha stess. Jekk il-kontenut jinbidel fil-post, uża buttuna li ssemmi l-modalità fil-mira, taġġorna t-titlu tad-dokument u l-intestatura prinċipali kif meħtieġ, iċċaqlaq il-fokus biss meta l-utent beda l-bidla, u jħabbar it-tlestija permezz ta 'messaġġ ta' status konċiż. Ippreserva l-istorja tal-browser u ipprovdi rotta ċara lura għall-oriġinal. Ittestja zoom, reflow, tastiera, screen reader, kuntrast għoli, mozzjoni mnaqqsa, u tikketti tradotti.

Iddefinixxi stati għal verżjoni mhux disponibbli, talba timeout, konfigurazzjoni invalida, skript imblukkat, browser mhux appoġġjat, u manutenzjoni tas-servizz. Kull stat jippreserva s-sors u joffri azzjoni li jmiss bla periklu. Uriex spinner permanenti, panel vojt, kodiċi ta 'żball mhux maħdum, jew kontroll li jidher li jaħdem iżda jħalli l-kontenut mhux mibdul. B'JavaScript diżattivat, is-sors ipprovdut mis-server u kwalunkwe link magħrufa ta' paġna alternattiva jibqgħu disponibbli.

  • Il-vjaġġ tas-sors jibqa' komplut meta l-widget qatt ma jgħabbi.

  • Il-kontrolli jużaw links jew buttuni indiġeni b'ismijiet approvati fil-modalità tal-lingwa.

  • Messaġġi ta 'fokus u status huma prevedibbli u mhux intrużivi.

  • Kull timeout u stat mhux disponibbli għandu azzjoni sikura li jmiss.

  • L-ebda avveniment analitiku jew dijanjostiku ma fih test tal-paġna jew informazzjoni personali bla bżonn.

Ittestja l-ambjent ospitanti u timmonitorja l-kunsinna reali

Test fuq mudelli rappreżentattivi, breakpoints, browsers, stati ta 'kunsens, veloċitajiet tan-netwerk, politiki ta' sigurtà tal-kontenut, maniġers ta 'tag, u teknoloġiji ta' assistenza. Inkludi inizjalizzazzjoni ripetuta, navigazzjoni min-naħa tal-klijent, kontenut imdaħħal b'mod dinamiku, stampar, tikketti tat-traduzzjoni, skadenza tal-cache, riżultat mhux disponibbli, timeout, u talba ta' parti terza mblukkata. Ikkonferma li l-widget ma joħloqx IDs duplikati, ordni ta' intestatura invalida, nases tal-fokus, bidla fit-tqassim, jew stili globali konfliġġenti.

Immonitorja s-suċċess tat-tagħbija, id-disponibbiltà tal-verżjoni, il-ħin tar-rispons, l-eċċezzjonijiet tar-rendi, ir-reviżjonijiet tas-sors skaduti, u l-għażla tal-modalità mibdija mill-utent. Kampjun skont il-mudell ospitanti u l-verżjoni tal-kitba, mhux skont l-identità personali. Iddefinixxi sid, limitu ta' twissija, verżjoni ta' rollback, u proċess ta' komunikazzjoni ospitanti. Rilaxx huwa aċċettat meta s-sors jibqa' użabbli taħt kull falliment simulat, il-kompiti kritiċi jaħdmu permezz tat-tastiera u l-screen reader, u l-verżjoni tal-iskript preċedenti tista 'tiġi rrestawrata mingħajr bidliet fil-paġna ospitanti.

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