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:
- klónozza az aktív Config Setet;
- regisztrálja az utód Structure Contractot és Blueprintet;
- adjon meg pontos forrás-cél migrációt;
- írás nélkül tekintse meg az eredményt;
- válassza külön az automatikus és felülvizsgálandó elemeket;
- hozzon létre revízióhoz kötött módosítási javaslatokat;
- 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_blockrekordot. - 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.
