Към съдържанието

Общи сведения

Blockstudio Registry е инструмент CLI за разпространение и инсталиране на блокове WordPress от хоствани регистри.

Работи като shadcn/ui, но за блокове WordPress. Не е необходимо да инсталирате пакет npm. Изпълнявате команда, изходният код на блока се копира в проекта ви и става изцяло ваш.

Как работи

  1. Авторите на блокове публикуват registry.json на URL, в който са изброени наличните блокове.
  2. Добавяте blocks.json към темата или разширението си, като посочвате регистрите, които искате да използвате.
  3. Изпълнявате npx blockstudio add ui/tabs и папката на блока се появява в проекта ви.

Това е всичко. CLI изтегля файловете, разрешава зависимостите и ги записва на диска. Не преобразува нищо. Папката на блок WordPress е еднаква навсякъде.

Какво поддържа

Регистърът не зависи от типа на блока. Той копира папки. Работи с всеки блок, който се намира в директория:

  • Блокове Blockstudio: block.json + шаблон PHP/Twig/Blade + незадължителни ресурси
  • Блокове @wordpress/create-block: пълен изход от компилация JS с edit.js, save.js и т.н.
  • Обикновени блокове PHP: всеки блок, регистриран с register_block_type()
  • Статични блокове: блокове само с block.json и без визуализиране от страна на сървъра

На CLI не му пука какво има в папката. Той чете манифеста на файловете от регистъра и изтегля точно тези файлове.

Администрация в WordPress

Ако активната тема има blocks.json с конфигурирани регистри, същите регистри се показват и в Инструменти > Blockstudio > Registry в wp-admin.

Браузърът за администратори ви позволява да разглеждате наличните блокове и да ги импортирате, без да променяте CLI. Форматът на конфигурацията остава същият. blocks.json продължава да бъде единственият достоверен източник.

Бърз старт

Обвивка
npx blockstudio init
npx blockstudio add ui/tabs

Вижте Първи стъпки за пълните инструкции за настройка.