Перейти к содержимому

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

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

Полное руководство по настройке см. в разделе Начало работы.