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.json tokenjeit é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:

  1. Telepítse és aktiválja a Canvast.
  2. 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.
  3. 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.
  4. Vizsgálja át a létrehozott Site Contractot és minden Blueprintet; ne feltételezze, hogy az előbeállítás illeszkedik a webhelyhez.
  5. Ellenőrizze, hogy a Blueprintek célként megadott sablonjai és mintaslugjai léteznek-e az aktív Canvas-verzióban.
  6. Ellenőrizze, majd kifejezetten aktiválja a Config Setet.
  7. 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:

  1. Aktiválja a kiválasztott témát, majd vizsgálja át újra a Theme & providers oldalt.
  2. Ellenőrizze a regisztrált sablonokat, mintákat, blokkokat és theme.json-előbeállításokat.
  3. 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.
  4. Határozzon meg egy egyszerű oldaltípust, kizárólag megerősített képességekkel.
  5. Másolt HTML vagy soron belüli stílusok helyett részesítsd előnyben az alapblokkokat és a stabil témamintákat.
  6. Ellenőrizze és aktiválja a konfigurációt, majd hozzon létre tesztvázlatot.
  7. 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:

  1. hagyja változatlanul a jelenleg aktív Config Setet;
  2. vizsgálja át újra a webhelyet;
  3. klónozza az aktív Config Setet;
  4. frissítse a sablon-, minta-, blokk- és előbeállítás-hivatkozásokat a klónban;
  5. ellenőrizzen minden érintett Blueprintet;
  6. tekintse meg reprezentatív vázlatok előnézetét;
  7. 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.