Перейти до вмісту

Загальне

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

Повний посібник із налаштування дивіться в розділі Початок роботи.