Preskočiť na obsah

Všeobecné

Register Blockstudio je nástroj CLI na distribúciu a inštaláciu blokov WordPress z hostovaných registrov.

Funguje podobne ako shadcn/ui, ale pre bloky WordPress. Nemusíte inštalovať žiadny balík npm. Spustíte príkaz, zdrojový kód bloku sa skopíruje do vášho projektu a máte nad ním úplnú kontrolu.

Ako to funguje

  1. Autori blokov zverejnia registry.json na adrese URL so zoznamom dostupných blokov.
  2. Do svojej témy alebo doplnku pridáte blocks.json odkazujúci na registre, ktoré chcete používať.
  3. Spustíte npx blockstudio add ui/tabs a priečinok bloku sa pridá do vášho projektu.

To je všetko. CLI stiahne súbory, vyrieši závislosti a zapíše ich na disk. Nič neupravuje. Priečinok bloku WordPress vyzerá všade rovnako.

Čo podporuje

Register nezávisí od typu bloku. Kopíruje priečinky. Funguje s každým blokom uloženým v adresári:

  • Bloky Blockstudio: block.json + šablóna PHP/Twig/Blade + voliteľné súčasti
  • Bloky @wordpress/create-block: úplný výstup zostavenia JS s edit.js, save.js atď.
  • Obyčajné bloky PHP: ľubovoľný blok zaregistrovaný pomocou register_block_type()
  • Statické bloky: bloky obsahujúce iba block.json bez vykresľovania na strane servera

CLI nezáleží na obsahu priečinka. Načíta zoznam súborov z registra a stiahne presne tie súbory, ktoré sú v ňom uvedené.

Správca WordPress

Ak má aktívna téma súbor blocks.json s nakonfigurovanými registrami, rovnaké registre sa zobrazia aj v Nástroje > Blockstudio > Register v administrácii wp-admin.

Tento prehliadač v administrácii vám umožňuje prezerať dostupné bloky a importovať ich bez úpravy súboru CLI. Konfiguračný formát zostáva rovnaký. blocks.json je naďalej jediným spoľahlivým zdrojom údajov.

Rýchly začiatok

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Úplný postup nastavenia nájdete v časti Začíname.