CMS og API

TYPO3 implementeringsvejledning.

Modellér tilgængelige sprogversioner som styrede poster forbundet med deres kildeindhold og godkendelse af arbejdsområdet.

Afklar opgave og beslutning

Denne vejledning gør typo3 implementeringsvejledning til en arbejdsgang, der kan gennemgås. Det forbinder domænebeslutninger, ejerskab, beviser og accept, så resultatet fortsætter med at fungere i produktionen.

Modellér tilgængelige sprogversioner som styrede poster forbundet med deres kildeindhold og godkendelse af arbejdsområdet.

Praktisk arbejdsgang

  1. 1

    Beholdningskildetyper, identifikatorer, felter, lokaliteter, ejere og udgivelsestilstande.

  2. 2

    Vælg leveringsmønsteret fra volumen, latens, redaktionel kontrol og fejltolerance.

  3. 3

    Tilknyt kildeposten til en separat sprogversionspost med holdbar kobling.

  4. 4

    Tilføj godkendelse, idempotens, forsøg igen, cache-invalidering, logning og adgangskontrol.

  5. 5

    Testpublikation, kildeændringer, utilgængelige resultater, rollback, tastaturbetjening og overvågning før udgivelse.

Eksempel eller værktøj

Et eksempel på et TYPO3-arbejdsområde dækker feltkortlægning, oversættelsesrelationer, implementering og invalidering. I værktøjet skal du også registrere basislinje, ejer, beslutning, bevis, åbent spørgsmål og godkendelsesdato. Brug en rigtig side eller transaktion, så teamet ser afhængigheder, undtagelser og vedligeholdelsesarbejdet, der følger efter udgivelsen.

BeslutningspunktOptagAcceptkriterium
BaselineObserveret nuværende tilstandKilde og dato registreret
BeslutningValgt mulighed og begrundelseRisiko og publikum taget i betragtning
BeviserTest, dokumenter eller målGennemgåbar og versionsspecifik
GodkendelseNavn, rolle og datoAlle obligatoriske kriterier opfyldt

Modelsprogversioner som regulerede optegnelser

Brug en dedikeret indholdspost eller sidetype til en tilgængelig sprogversion, og tilslut den til kilden med en uforanderlig relation. Gem kilde-UID, kildearbejdsområderevision eller indholdshash, mållokalitet, sprogtilstand, transformationsresultat-id, anmeldelsestilstand, ordlisteversion, godkendere og sidste bekræftelsesdato. Hold dette forhold adskilt fra TYPO3s almindelige oversættelsesrelation, når versionen ændrer struktur eller informationstæthed i stedet for kun sprog.

Kortlæg strukturerede kildefelter bevidst. Bevar overskrifter, afsnit, lister, links, tabeller, meddelelser, downloads og kontaktblokke som semantiske elementer. Definer en sikker reserve for hvert ikke-understøttet indholdselement: bevar det med en korrekturadvarsel, erstat det med en godkendt oversigtskomponent, eller blokér generering. Tab aldrig et ukendt element lydløst. Filreferencer og links beholder deres identifikatorer, så validering kan registrere ændrede eller slettede afhængigheder.

Optag feltFormålPåkrævet adfærd
source_uidForbinder version og kildeUforanderlig relation med tilladelseskontrol
source_revisionRegistrerer kildeændringerMarkerer godkendt version til gennemsyn, når den er anderledes
anmeldelse_tilstandStyrer arbejdsgangenOvergang begrænset af backend-rolle
resultat_idUnderstøtter sporbarhedGemt med indstillinger og anmodningstid

Brug arbejdsområder til generering, gennemgang og godkendelse

Opret det genererede resultat i et kontrolleret arbejdsområde, aldrig direkte i det levende arbejdsområde. En generationsrolle kan anmode om og opdatere kladder. En faganmelder bekræfter betingelser, tal, datoer, ansvar og links. En sproganmelder kontrollerer den valgte tilstand og den gengivne rejse. En udgiver verificerer løste resultater og flytter den godkendte revision gennem det etablerede arbejdsområde. Håndhæv disse muligheder i backend-tilladelser og overgangslogik på serversiden.

Konfigurer fasenotifikationer med registrerings-URL, kilderevision, risikoniveau, påkrævet rolle og forfaldsdato. Anmeldere har brug for en meningsfuld forskel, der adskiller indholdsændringer fra TYPO3-metadatastøj. Hvis kilden redigeres, mens gennemgangen er åben, skal du markere versionen forældet og kræve, at teamet vælger mellem at rebasere udkastet eller fuldføre en eksplicit registreret undtagelse. Systemet skal forhindre en forældet godkendelse i at nå live.

  1. 1

    Opret eller identificer kildeposten og indfang dens arbejdsområderevision.

  2. 2

    Generer den strukturerede version i det tildelte arbejdsområde.

  3. 3

    Fuldfør emne-, sprog- og linkvalidering på den gengivede forhåndsvisning.

  4. 4

    Løs resultater og bekræft, at kilderevisionen stadig er aktuel.

  5. 5

    Udgiv den godkendte post, og behold hele arbejdsområdets historik.

Implementer og ugyldig uden at miste godkendt indhold

Opret ruteforstærkere og sidemetadata, der giver hver version en stabil, læsbar URL. Udgiv gensidige sproglinks og kanoniske relationer i server-renderet markup. Medtag kun versionen i webstedssøgning og XML-sitemaps efter godkendelse. Konfigurer adgangsbegrænsninger eksplicit, og bekræft, at en offentlig sprogside ikke arver en utilsigtet kildesidebegrænsning eller afslører beskyttet kildeindhold.

Ugyldiggør de korrekte frontend-caches, når den godkendte version, kilde, refererede fil, delt indholdselement, gengivelsesskabelon eller ordliste ændres. Brug cache-tags, der inkluderer både kilde- og versionsidentifikatorer. Under generering eller gennemgang skal du fortsætte med at vise den sidst godkendte post. En mislykket anmodning opretter en synlig backend-opgave og operationel hændelse, men den sletter ikke en gyldig offentlig side eller erstatter den med et udkast.

  • Hver offentlig version har en stabil rute og gensidig kildelink.

  • Søgning og sitemap inkluderer kun godkendte poster.

  • Cache-tags dækker kilde, version, delte elementer, filer og renderer.

  • Beskyttede kilder kan ikke lække gennem genererede offentlige registre.

  • Den sidst godkendte registrering forbliver tilgængelig under fejl og gennemgang.

Betjen udvidelsen gennem TYPO3-opgraderinger

Test udvidelsen mod de understøttede TYPO3 langsigtede supportversioner, PHP-versioner, database, flersproget konfiguration, arbejdsområder, skemalægger, søgeudvidelse og cachelag. Automatiserede integrationstests bør dække backend-tilladelsestjek, DataHandler-hooks, relationsvedholdenhed, workspace-overgange, cache-invalidering, API-fejl og stale-source-detektion. Browsertests dækker backend-tastaturbetjening og frontend-navigation i repræsentative bredder.

Før frigivelse, dokumentplanlægningsjob, køovervågning, legitimationsrotation, logopbevaring, backup og gendannelse, skemamigrering og sikker udvidelsesdeaktivering. Udfør først opgraderinger på en produktionslignende iscenesættelse, og bekræft gamle godkendte poster, før du opretter nye. Accept inkluderer en vellykket tilbagerulning af både udvidelseskode og databasemigrering, med offentliggjort indhold stadig tilgængeligt og dets revisionshistorik intakt.

Roller, beviser og godkendelse

Hold generation adskilt fra udgivelse. Et vellykket svar er et udkast, ikke en godkendelse. Gem kilde-id'et og -versionen, transformationsindstillinger, resultat-id'er, gennemgangstilstand, godkender og udgivelsestid. Når kilden ændres, skal du markere sprogversionen til gennemgang i stedet for lydløst at erstatte godkendt indhold. Dette gør rollback og revision mulig på tværs af platforme.

Drift og vedligeholdelse

Værket slutter ikke ved udgivelsen. Knyt sprogversionen eller konfigurationen til dens kilde, overvåg kvalitets- og servicemål, og definer konkrete gennemgangsudløsere. Triggere omfatter kildeændringer, juridiske ændringer, nye publikumsbehov, tilbagevendende supportspørgsmål, tekniske ændringer og hændelser. En navngivet ejer evaluerer udløseren, åbner en ny revision, når det er nødvendigt, og registrerer fornyet godkendelse.

Tjekliste før udgivelse

  • Integrationen bruger holdbare kildeidentifikatorer.

  • Legitimationsoplysninger gemmes på serversiden og roteres.

  • Timeout, genforsøg og hastighedsbegrænsningsadfærd er defineret.

  • Gentagne anmodninger er idempotente.

  • Genereret indhold går ind i en anmeldelsestilstand.

  • Kildeændringer ugyldiggør eller genåbner versionen.

  • Sprognavigation fungerer ved hjælp af tastatur og hjælpeteknologi.

  • Overvågning dækker fejl, køer, latens og forældet indhold.

Autoritative kilder

  1. Simple8 API dokumentation
  2. Simple8 leveringsmønstre
  3. Retningslinjer for tilgængelighed til webindhold (WCAG) 2.2

Udfør guiden i praksis

Test Simple8 med repræsentativt indhold, og brug tjeklisten til at planlægge en kontrolleret produktionsarbejdsgang.

Test din egen tekst