A Composer integrálása a Canvasszal vagy külső témával
A Composer és az aktív téma felelősségi köre elkülönül:
- A Composer kezeli a Config Setet, a Site Contractot, a Blueprinteket, az ellenőrzést, az auditálást és a kizárólag vázlatokon végzett műveleteket.
- A téma kezeli a sablonokat, sablonrészeket, mintákat, stílusokat, a
theme.jsontokenjeit és a végső megjelenítést.
A Composer soha nem szerkeszti a téma fájljait, a téma pedig soha nem aktiválja észrevétlenül a Composer konfigurációját.
Agent Canvas
Az Agent Canvas egy opcionális referencia-megvalósítás és kezdőkörnyezet. A Composer teljes szerződésmodelljének teszteléséhez és bemutatásához egységes alapblokk-sablonokat, mintákat, stílusokat és egy írásvédett megjelenítési leírófájlt biztosít. Nem kötelező, nem része a Composer futásidejű függőségi láncának, és nem helyettesíti az ügynökség témáját, mintáit vagy tervezési folyamatát.
A Composer ügynökségi készítésű vagy egyéni témával is integrálható, ha a webhely mintái, tartalomtípusai és Composer-konfigurációja egyértelmű tartalmi szerződést tesznek közzé. A vizuális rendszert a webhely aktív témája és az ügynökség által jóváhagyott minták határozzák meg. A Canvas megjelenítési leírófájlja csak a Composer által vizsgálható szemantikus megjelenítési leképezéseket erősíti meg; nem tartalmazhat szolgáltatói hitelesítő adatokat, utasításokat, futásidejű callbackeket vagy végrehajtható szabályzatot.
A Canvas beállításakor kövesse ezt a sorrendet:
- Telepítse és aktiválja a Canvast.
- A Composerben vizsgálja át újra a webhelyet, és erősítse meg a Canvas-témát, a sablonokat, a mintákat és az alapblokkokat.
- Hozzon létre új, inaktív Config Setet a Universal Gutenberg, SmartCloud Recommended vagy Detected Theme Starter lehetőségből, vagy készítsen egyet kézzel.
- Vizsgálja át a létrehozott Site Contractot és minden Blueprintet; ne feltételezze, hogy az előbeállítás illeszkedik a webhelyhez.
- Ellenőrizze, hogy a Blueprintek célként megadott sablonjai és mintaslugjai léteznek-e az aktív Canvas-verzióban.
- Ellenőrizze, majd kifejezetten aktiválja a Config Setet.
- Minden oldaltípusnál végezz vázlat- és előnézeti tesztet, mielőtt normál munkafolyamatban használnád.
A webhelyspecifikus WP Suite-szerződéseket tartsa elkülönítve az általános Canvas-előbeállításoktól. Egy speciális belső szerződés ne váljon egy tiszta, nyilvános Canvas-telepítés alapértelmezett konfigurációjává.
Külső blokktémák
A Composer a Canvas nélkül is együttműködik szabványos vagy külső Gutenberg-blokktémákkal. A kompatibilitást a képességek, nem pedig a márkanév határozza meg.
Kezdje szándékosan kis szerződéssel:
- Aktiválja a kiválasztott témát, majd vizsgálja át újra a Theme & providers oldalt.
- Ellenőrizze a regisztrált sablonokat, mintákat, blokkokat és
theme.json-előbeállításokat. - Válassza a Detected Theme Starter lehetőséget, ha a Composer biztonságos témamintát talál, egyébként kezdje a Universal Gutenberg beállítással.
- Határozzon meg egy egyszerű oldaltípust, kizárólag megerősített képességekkel.
- Másolt HTML vagy soron belüli stílusok helyett részesítsd előnyben az alapblokkokat és a stabil témamintákat.
- Ellenőrizze és aktiválja a konfigurációt, majd hozzon létre tesztvázlatot.
- Csak akkor bővítsd a szerződést, amikor az előnézet igazolja, hogy a jelenlegi téma helyesen jeleníti meg az első Blueprintet.
A Detected Theme Starter csak egyetlen gyökérelemmel rendelkező, alapblokkokból álló témamintát fogad el. Kizárja a dinamikus lekérdezési, navigációs, sablon-, HTML-, shortcode- és rejtett segédmintákat, hozzáadja a kötelező H1-szerződést, és eltávolítja a nem előbeállításból származó soron belüli stílusokat a létrehozott munkamintából. A részleges támogatás elfogadott. Egy téma támogathatja a szabványos oldal- és cikk-Blueprintet anélkül, hogy egy különleges termék- vagy architektúraelrendezést is támogatna. Ne gyengítse az ellenőrzést egy hiányzó képesség elfedésére; adjon megfelelő mintát vagy sablont a témához, vagy távolítsa el a követelményt a munkaként használt Config Setből.
Minta- és sablonszabályok
Egy engedélyezett mintának regisztrálva kell lennie az aktuális webhelyen, és a benne egymásba ágyazott minden blokkot szintén engedélyeznie kell a Blueprintnek. A kötelező sorrendek csak azokat a mintákat tartalmazzák, amelyekre minden érvényes vázlatnak valóban szüksége van.
Használjon cím nélküli sablont, ha a tartalmi minta adja a H1 címsort. Ha a témasablon megjeleníti a bejegyzés címét, ne adjon második H1-et a tartalomhoz. A Composer a teljes összeállított fát ellenőrizze, de az adminisztrátornak olyan sablon- és mintakombinációt kell választania, amely a végső megjelenítésben elkerüli a kettős oldalcímet.
Témamódosítások
Téma váltása vagy frissítése után:
- hagyja változatlanul a jelenleg aktív Config Setet;
- vizsgálja át újra a webhelyet;
- klónozza az aktív Config Setet;
- frissítse a sablon-, minta-, blokk- és előbeállítás-hivatkozásokat a klónban;
- ellenőrizzen minden érintett Blueprintet;
- tekintse meg reprezentatív vázlatok előnézetét;
- csak a felülvizsgálat után aktiválja a klónt.
Ha a régi és az új téma eltérő képességeket tesz közzé, összehasonlításhoz és visszaállításhoz őrizze meg mindkét Config Setet. Egy témaváltás önmagában soha nem írhatja át és nem aktiválhatja a konfigurációt.
Szolgáltatói bővítmények
A szolgáltatói bővítmények regisztrálják tartalomtípusaikat, a hozzájuk kapcsolt taxonómiákat, a REST-en látható mezőket, a kapcsolatok tárolási és célpontszerződését, a blokkokat és a szolgáltatóspecifikus üzleti Abilityket. A Composer kezeli az általános mező-, kapcsolat- és szabályozott taxonómiakifejezés-műveleteket. A szolgáltatók ne másolják le a Composer kapcsolat- vagy taxonómiakeresési, -létrehozási és -hozzárendelési Abilityjeit; az aktív Site Contract határozza meg, hogy az általános munkafolyamat mely már regisztrált taxonómiákat használhatja. A Composer csak a valóban szolgáltatóspecifikus összetevő- vagy üzleti műveleteket delegálja. Egy Blueprint csak akkor követelhet meg szolgáltatói blokkot, ha a bővítmény telepítve és regisztrálva van, valamint használatra kész. A szolgáltató által támogatott tartalom engedélyezése előtt olvassa el a szolgáltató külső szolgáltatásokra és adatvédelemre vonatkozó dokumentációját.
