Ugrás a tartalomhoz

Általános tudnivalók

A Blockstudio Registry egy CLI eszköz WordPress blokkok hosztolt nyilvántartásokból történő terjesztéséhez és telepítéséhez.

Úgy működik, mint a shadcn/ui, de WordPress blokkokhoz. Nincs telepítendő npm csomag. Futtatsz egy parancsot, a blokk forráskódja bekerül a projektedbe, és teljes egészében a tiéd lesz.

Működés

  1. A blokk szerzői közzétesznek egy registry.json fájlt egy URL címen, amely felsorolja az elérhető blokkokat.
  2. Hozzáadsz egy blocks.json fájlt a témádhoz vagy bővítményedhez, megadva benne a használni kívánt nyilvántartásokat.
  3. Futtatod a npx blockstudio add ui/tabs parancsot, és a blokk mappája bekerül a projektedbe.

Ennyi. A CLI letölti a fájlokat, feloldja a függőségeket, és lemezre írja őket. Semmit sem alakít át. Egy WordPress blokk mappája mindenhol ugyanaz.

Mit támogat

A nyilvántartás blokkfajta-független: mappákat másol. Bármilyen könyvtárban tárolt blokk működik:

  • Blockstudio blokkok: block.json + PHP/Twig/Blade sablon + opcionális erőforrások
  • @wordpress/create-block blokkok: teljes JS buildkimenet edit.js, save.js stb. fájlokkal
  • Egyszerű PHP blokkok: bármely, register_block_type() segítségével regisztrált blokk
  • Statikus blokkok: kizárólag block.json fájlt tartalmazó, szerveroldali renderelés nélküli blokkok

A CLI számára közömbös, mi található a mappában. Kiolvassa a fájljegyzéket a nyilvántartásból, és pontosan az abban felsorolt fájlokat tölti le.

WordPress adminfelület

Ha az aktív témában van blocks.json nyilvántartásokkal konfigurálva, ugyanezek a nyilvántartások megjelennek a wp-admin Eszközök > Blockstudio > Registry menüjében is.

Az adminfelületi böngészőben megtekintheted az elérhető blokkokat, és importálhatod őket a CLI érintése nélkül. A konfiguráció formátuma változatlan marad. Továbbra is az blocks.json az irányadó forrás.

Gyors kezdés

Shell
npx blockstudio init
npx blockstudio add ui/tabs

A teljes beállításhoz lásd: Első lépések.