Общие сведения
Blockstudio Registry — это инструмент CLI для распространения и установки блоков WordPress из размещенных реестров.
Он работает как shadcn/ui, но с блоками WordPress. Устанавливать пакет npm не нужно. Достаточно выполнить команду: исходный код блока будет скопирован в ваш проект и полностью перейдет под ваш контроль.
Как это работает
- Авторы блоков публикуют
registry.jsonна URL со списком доступных блоков. - Вы добавляете
blocks.jsonв свою тему или плагин, указав реестры для использования. - Вы запускаете
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
Полное руководство по настройке см. в разделе Начало работы.