WordPress-elrendezések szabályozása Structure Contractokkal

A Structure Contract a Blueprint tervezett Gutenberg-elrendezését szerveroldalon kikényszerített dokumentummodellé alakítja. Az ügynök így tartós szemantikus mezőket, például hero.title vagy body.additional értéket címezhet, törékeny blokkútvonal és az oldal újraépítésére szóló engedély nélkül.

A szerkesztői zárolás a felhasználói élményt javítja, de nem biztonsági határ. A Composer a Structure Contractot REST-, natív szerkesztői és MCP-írásnál is ellenőrzi; nyers blokkjelöléssel nem lehet megkerülni.

Tulajdonosi modell

Minden deklarált csomópontnak egy tulajdonosa van:

  • A Blueprint tulajdonában álló struktúra rögzíti a kötelező konténereket, sorrendet, blokktípust és védett megjelenést.
  • A példány tulajdonában álló tartalom bejegyzésenként változhat, és stabil szemantikus azonosítón keresztül szerkeszthető.
  • A felhasználó tulajdonában álló slot-tartalom ellenőrzött szerkesztői szabadságot biztosít. A slot engedélyezett blokktípusokat és minimum/maximum elemszámot határoz meg.

Ez a felosztás megőrzi a dizájnt anélkül, hogy minden szót befagyasztana.

Stabil szemantikus azonosítók

A szemantikus ID tartós szabályzat, nem generált tömbindex. A tartalom szerepét leíró neveket használjon:

hero
hero.title
body
body.text
body.additional

Egy ID átnevezése szerződésmigráció. Ne kerüljön bele témaverzió, adatbázis-azonosító, környezetnév vagy aktuális blokkpozíció.

Bővítési slotok

Egy slot meghatározza a szemantikus azonosítót és szülőt, a közvetlenül engedélyezett blokkokat, a minimum/maximum elemszámot, a kötelezőséget, valamint a zárolás és az appender működését.

A Composer szemantikus beszúrási, módosítási, mozgatási és eltávolítási műveleteket biztosít. Minden beszúrt fához stabil felhasználói identitást rendel, majd minden változtatás után a teljes dokumentumot validálja. A hibás elemszám vagy tiltott blokktípus atomi hibát okoz: a vázlat nem részlegesen mentődik.

Szinkronizált strukturális minták

Az újrafelhasználható struktúrát közzétett WordPress wp_block szinkronizált mintában tárolja. A bejegyzés másolat helyett natív, zárolt core/block hivatkozást tartalmaz.

A deklarált példánymezőkhöz natív Pattern Overrides értékeket használjon. A Composer a slotok gyermekeit a bejegyzés mintapéldányán tárolja, nem a közös wp_block rekordban, ezért egy oldal szerkesztése nem módosít minden példányt.

A Site Contract minden szabályozott mintánál azonosítja a helyi wp_block rekordot, verziót, override-kötéseket és kompatibilis Structure Contractot. A Theme & providers csak akkor jelez hiányzó forrást, ha az adott forrástípus releváns és ténylegesen nem érhető el.

Natív WordPress-létrehozás

A Site Contract bejegyzéstípusonként szabályozhatja az Add New működését:

  • off: a natív létrehozás nem szabályozott;
  • optional: az adminisztrátor kompatibilis Blueprintet választhat;
  • required: az új dokumentumot a beállított alapértelmezett Blueprintből kell inicializálni.

A natív dokumentum ugyanazt a Blueprintet, szinkronizált mintákat, Structure Contractot, baseline-t, nyelvet és szerveroldali mentésvédelmet kapja, de ettől nem válik az ügynök tulajdonává.

Mintaevolúció és egyeztetés

Egy kompatibilis mintarevízió módosíthatja a védett megjelenést, ha megtartja a kötelező szemantikus mezőket és slotokat. A meglévő Pattern Overrides értékek és felhasználói slot-gyermekek a példányhoz kötve maradnak.

Ha egy revízió kötelező kötést töröl vagy megváltoztat, a Composer explicit érvénytelen vagy egyeztetést igénylő állapotot jelez. Nem írja át csendben a bejegyzéseket és nem dob el tartalmat.

Verziózott szerződésmódosításnál:

  1. klónozza az aktív Config Setet;
  2. regisztrálja az utód Structure Contractot és Blueprintet;
  3. adjon meg pontos forrás-cél migrációt;
  4. írás nélkül tekintse meg az eredményt;
  5. válassza külön az automatikus és felülvizsgálandó elemeket;
  6. hozzon létre revízióhoz kötött módosítási javaslatokat;
  7. az elfogadott javaslatokat ember egyesítse.

A tömeges tervezés korlátozott, a javaslatkészítés explicit. A migráció sosem jelent automatikus tömeges publikálást.

A téma és a providerek felelőssége

A téma tulajdona a sablon, szinkronizált minta, markup, stílus és theme.json token. A provider a saját komponenseinek sémáját és materializerét birtokolja. A Composer felel a szemantikus szerződésért, validációért, szabályozott módosításért, egyeztetési állapotért, javaslatokért és auditnyomért.

Az AI Kit Knowledge Base Section szabályozott natív Gutenberg- vagy Agent Canvas-leszármazottak szemantikus konténere lehet. A Feature és Doc Search komponensek szigorúbb gyermekvalidációja változatlan marad.

Átvételi ellenőrzőlista

  • Minden szemantikus ID stabil és egyedi.
  • Minden kötelező mező vagy slot pontosan egyszer oldódik fel a minta kibontása után.
  • Minden engedélyezett blokk regisztrált és validált.
  • A slot-határok megfelelnek a kívánt szerkesztői szabadságnak.
  • A Pattern Overrides lefedi az összes példánymezőt.
  • A példányslot tartalma nem módosítja a közös wp_block rekordot.
  • A natív Add New, MCP-szerkesztés, előnézet, javaslat és egyeztetés útvonala az aktív témával tesztelt.
  • A publikált tartalom módosítása javaslatalapú és ember által jóváhagyott marad.

Folytatás: Konfiguráció és életciklus, Témaintegráció és MCP Access és OAuth.