Á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
- A blokk szerzői közzétesznek egy
registry.jsonfájlt egy URL címen, amely felsorolja az elérhető blokkokat. - Hozzáadsz egy
blocks.jsonfájlt a témádhoz vagy bővítményedhez, megadva benne a használni kívánt nyilvántartásokat. - Futtatod a
npx blockstudio add ui/tabsparancsot, é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-blockblokkok: teljes JS buildkimenetedit.js,save.jsstb. fájlokkal- Egyszerű PHP blokkok: bármely,
register_block_type()segítségével regisztrált blokk - Statikus blokkok: kizárólag
block.jsonfá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
npx blockstudio init
npx blockstudio add ui/tabs
A teljes beállításhoz lásd: Első lépések.