Přejít k obsahu

Obecné informace

Registr Blockstudio je nástroj CLI pro distribuci a instalaci bloků WordPress z hostovaných registrů.

Funguje podobně jako shadcn/ui, ale pro bloky WordPress. Není potřeba instalovat žádný balíček npm. Spustíte příkaz, zdrojový kód bloku se zkopíruje do vašeho projektu a zůstane plně ve vašich rukou.

Jak to funguje

  1. Autoři bloků zveřejní registry.json na adrese URL se seznamem dostupných bloků.
  2. Do šablony nebo pluginu přidáte blocks.json odkazující na registry, které chcete používat.
  3. Spustíte npx blockstudio add ui/tabs a složka bloku se přidá do vašeho projektu.

A to je vše. CLI stáhne soubory, vyřeší závislosti a zapíše je na disk. Nic nepřevádí. Složka bloku WordPress je všude stejná.

Co podporuje

Registr nezávisí na typu bloku. Kopíruje složky, takže funguje jakýkoli blok uložený v adresáři:

  • Bloky Blockstudio: block.json + šablona PHP/Twig/Blade + volitelné prostředky
  • Bloky @wordpress/create-block: kompletní výstup sestavení JS včetně edit.js, save.js atd.
  • Obyčejné bloky PHP: jakýkoli blok registrovaný pomocí register_block_type()
  • Statické bloky: bloky obsahující pouze block.json bez vykreslování na straně serveru

CLI nezáleží na obsahu složky. Načte manifest souborů z registru a stáhne přesně uvedené soubory.

Správa WordPress

Pokud má aktivní šablona nastavený blocks.json s registry, zobrazí se stejné registry také v části Nástroje > Blockstudio > Registry v administraci wp-admin.

Tento prohlížeč v administraci umožňuje prohlížet dostupné bloky a importovat je bez úprav CLI. Formát konfigurace zůstává stejný. blocks.json je stále jediným zdrojem pravdy.

Rychlý začátek

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Úplný postup nastavení najdete v části Začínáme.