Preskoči na vsebino

Splošno

Register Blockstudio je orodje CLI za distribucijo in namestitev blokov WordPress iz gostujočih registrov.

Deluje podobno kot shadcn/ui, vendar za bloke WordPress. Ni paketa npm, ki bi ga bilo treba namestiti. Zaženete ukaz, izvorna koda bloka se kopira v vaš projekt in je v celoti vaša.

Kako deluje

  1. Avtorji blokov objavijo registry.json na URL, kjer navedejo razpoložljive bloke.
  2. V temo ali vtičnik dodate blocks.json, ki kaže na registre, ki jih želite uporabljati.
  3. Zaženete npx blockstudio add ui/tabs in mapa bloka se prenese v vaš projekt.

To je vse. CLI prenese datoteke, razreši odvisnosti in jih zapiše na disk. Ničesar ne preoblikuje. Mapa bloka WordPress je povsod enaka.

Kaj podpira

Register ni vezan na vrsto bloka. Kopira mape, zato deluje vsak blok v svojem imeniku:

  • Bloki Blockstudio: block.json + predloga PHP/Twig/Blade + izbirna sredstva
  • Bloki @wordpress/create-block: celoten rezultat gradnje JS z edit.js, save.js itd.
  • Navadni bloki PHP: kateri koli blok, registriran z register_block_type()
  • Statični bloki: bloki samo z block.json in brez upodabljanja na strežniški strani

CLI ne zanima, kaj je v mapi. Iz registra prebere manifest datotek in prenese natanko navedene datoteke.

Skrbništvo WordPress

Če je v aktivni temi nastavljen blocks.json z registri, se ti registri prikažejo tudi v Orodja > Blockstudio > Register v wp-admin.

Ta skrbniški brskalnik omogoča pregled razpoložljivih blokov in njihov uvoz brez poseganja v CLI. Oblika konfiguracije ostane enaka. blocks.json je še vedno glavni vir resnice.

Hiter začetek

Lupina
npx blockstudio init
npx blockstudio add ui/tabs

Za celotno nastavitev glejte Začetek.