Загальне
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
Повний посібник із налаштування дивіться в розділі Початок роботи.