Dennis · 10 апреля 2026 г.
Blockstudio 7.2
Blockstudio 7.2 одновременно развивает платформу в двух направлениях.
Первое — видимость и рабочий процесс в рамках одного проекта: новый обзор панели администратора, обозреватель базы данных, обозреватель реестра администратора и прелюдии SCSS для общей настройки Sass.
Второе — экосистема вокруг Blockstudio: реестр CLI для распространения блоков (как shadcn для WordPress) и расширение PHPStan, которое добавляет проверку типов в стиле TypeScript для шаблонов, тегов блоков, db.php, rpc.php, cron.php и связанных файлов схем.
Оба направления преследуют одну цель: упростить понимание, развитие и совместное использование крупных проектов Blockstudio.
Работа в панели администратора
Два новых элемента упрощают навигацию по крупному проекту в wp-admin.
Обзор панели администратора
Теперь Blockstudio включает экран панели администратора в разделе Инструменты > Blockstudio. Здесь можно посмотреть, что система зарегистрировала в файловой системе.
В обзоре есть отдельные вкладки для:
- Блоков
- Расширений
- Полей
- Страниц
- Схем
В дополнение к обзору в панели администратора появился отдельный раздел Базы данных. В нем перечислены все зарегистрированные схемы Blockstudio\Db, а реальные записи можно просматривать прямо в wp-admin.
Вместо пользовательской сетки панелей экран использует таблицы DataViews WordPress. Благодаря этому интерфейс UI соответствует панели администратора и остается удобным даже в проектах с десятками или сотнями регистраций.
В небольшом проекте можно держать состояние среды выполнения в голове. В крупной кодовой базе это уже не работает. Возникают вопросы:
- Какие блоки зарегистрированы сейчас?
- Какие расширения предназначены для
core/*, а какие — для отдельных блоков? - Какие страницы синхронизированы и к каким типам записей они относятся?
- Какие повторно используемые поля есть в проекте?
- Какие схемы зарегистрированы и какой тип хранилища они используют?
Раньше ответы приходилось искать, изучая папки, открывая файлы JSON и просматривая PHP. Теперь для этого есть отдельный экран панели администратора.
Каждая вкладка помогает найти ответы на определенные вопросы:
- Блоки: зарегистрированные типы блоков, режим рендеринга, версия API и число атрибутов
- Расширения: целевые блоки, приоритет и сведения о рендеринге
- Поля: краткий список повторно используемых определений пользовательских полей
- Страницы: синхронизированные страницы из файлов с типом записи, статусом, движком шаблонов и состоянием синхронизации
- Схемы: зарегистрированные схемы хранилища с указанием типа хранилища, числа полей и области разрешений
Просмотрщик базы данных намеренно отделён от первоначальной сводной нагрузки. Вместо сериализации каждой строки при загрузке страницы он заранее загружает только доступные схемы, а записи запрашивает по мере необходимости при открытии вкладки базы данных. Благодаря этому панель администратора остаётся удобной даже в проектах с большими наборами данных за db.php.
Первая версия намеренно сосредоточена на регистрациях, основанных на схемах. Это не страница настроек, а страница просмотра.
Если эта функция вам совсем не нужна, отключите её полностью:
add_filter('blockstudio/admin/enabled', '__return_false');
Просмотрщик реестра в панели администратора
Рядом со сводкой находится вторая вкладка — Реестр. Это просмотрщик удалённых реестров блоков, настроенных в blocks.json вашей темы. Он позволяет импортировать блоки прямо из панели администратора WordPress, не открывая CLI.
{
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json",
"private": {
"url": "https://api.example.com/registry.json",
"headers": {
"Authorization": "Bearer ${REGISTRY_TOKEN}"
}
}
}
}
Просмотрщик загружает каждый настроенный реестр, перечисляет все доступные блоки и показывает, установлен ли каждый из них локально или доступен для импорта. В каждой строке есть кнопка «Импорт», которая загружает файлы блока в настроенную директорию темы. Для уже установленных блоков вместо неё показывается кнопка «Импортировать повторно».
Поддерживаются реестры с аутентификацией в формате объекта с headers, включая подстановку ${ENV_VAR}, поэтому токены никогда не попадают в систему контроля версий.
Так работа с реестрами становится полноценной частью интерфейса панели администратора, а не просто процессом CLI.
Реестр CLI
Вторая часть работы с реестрами — отдельный CLI: blockstudio/registry.
Это инструмент в духе shadcn для блоков WordPress. Без пакета npm и этапа сборки. Вы запускаете команду, исходный код блока копируется в проект, и он полностью принадлежит вам.
npx blockstudio init
npx blockstudio add ui/tabs
CLI работает с блоками любого типа: блоками Blockstudio, выводом @wordpress/create-block, обычными блоками PHP. Реестру не важно, что находится в папке. Он читает манифест файлов из registry.json и копирует именно перечисленные в нём файлы.
Авторы блоков публикуют registry.json по любому URL (GitHub с исходным содержимым, S3 или собственный сервер), где перечислены доступные блоки, их метаданные, зависимости и списки файлов. Пользователи добавляют URL в свой blocks.json и загружают блоки по имени.
CLI поддерживает:
- Разрешение зависимостей: блоки могут объявлять зависимости от других блоков; они разрешаются автоматически с обнаружением циклов
- Обработка конфликтов между реестрами: если блок с одним именем есть в нескольких реестрах, CLI предложит выбрать нужный
- Реестры с аутентификацией: токены носителя, базовая аутентификация и пользовательские заголовки с подстановкой переменных окружения
- Интерактивный TUI: создан на Ink; включает индикаторы загрузки, запросы выбора и индикаторы выполнения
- Неинтерактивный режим: флаг
--yesи автоматический переход в режим CI или конвейерной обработки - Поиск и список: просмотр реестров из командной строки
В пакет входит 130 тестов схем, разрешения зависимостей, загрузки HTTP, записи файлов, всех сценариев команд и интерактивного UI Ink.
Полная документация: blockstudio.dev/registry.
Расширение PHPStan
Ещё одно крупное нововведение — blockstudio/phpstan: расширение PHPStan, которое даёт пользователям Blockstudio такую же безопасность типов, какую ожидают разработчики TypeScript.
composer require --dev blockstudio/phpstan
Во время анализа расширение считывает реальные схемы проекта и передаёт полученные типы обратно в PHPStan. Теперь поддерживаются шаблоны PHP, Twig, Blade, теги блоков, типизированные записи базы данных, пути настроек, имена хуков и проверка схем в block.json, field.json, расширении JSON, page.json, db.php, rpc.php, cron.php и blockstudio.json.
Типобезопасные шаблоны блоков
Обращения к полям в $a проверяются по соседнему block.json:
<?php
/** @var array<string, mixed> $a */
echo $a['title']; // OK
echo $a['cta']['href']; // OK
echo $a['typo']; // ERROR: Field "typo" does not exist in block.json (block: hero). Did you mean "title"?
Типобезопасные записи базы данных
Db::get() возвращает типизированный экземпляр на основе схемы db.php. Структура записи формируется по фактическим полям:
return [
'storage' => 'table',
'fields' => [
'email' => ['type' => 'string', 'required' => true],
'name' => ['type' => 'string'],
],
];
$db = Db::get('mytheme/subscribers');
$record = $db->create(['email' => 'a@b.com']);
echo $record['email']; // PHPStan: string
echo $record['name']; // PHPStan: string|null
echo $record['typo']; // ERROR: Offset 'typo' does not exist on array{id: int, email: string, name: string|null}
Проверка схем
Недопустимые файлы схем выявляются во время анализа: block.json, field.json, расширение JSON, page.json, db.php, rpc.php, cron.php и blockstudio.json. Отсутствующие имена, неправильные типы полей, некорректные определения и устаревшие логические значения в сокращённой форме ("tailwind": true вместо вложенного объекта) — обо всех ошибках сообщается с указанием точной строки в исходном файле.
Проверка путей настроек
Вызовы Settings::get() проверяются по известной схеме настроек:
Settings::get('tailwind/enabled'); // OK, returns bool
Settings::get('tailwind/enabld'); // ERROR: Settings path "tailwind/enabld" is not a known Blockstudio setting. Did you mean "tailwind/enabled"?
Проверка имён хуков
То же самое выполняется для имён хуков фильтров и действий:
add_filter('blockstudio/render', $cb); // OK
add_filter('blockstudio/rendrr', $cb); // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?
Расширение также включает заглушки для всего публичного API Blockstudio: Db, Settings, Field_Registry, Build и глобальных вспомогательных функций. Вы получаете автодополнение и проверку типов для всех API Blockstudio без исходного кода плагина на машине разработчика.
Удобства для разработки
Релиз дополняют два небольших удобства для разработки.
Глобальные прелюдии SCSS
Blockstudio уже поддерживал компиляцию SCSS, но оставалось одно неудобство: настройка общих Sass.
Если вам нужен общий набор переменных, функций или примесей, приходилось импортировать их в каждый файл SCSS. Это быстро надоедает, особенно при работе с большими дизайн-системами или наборами инструментов Sass, такими как Bootstrap.
В версии 7.2 для этого добавлен хук прелюдии:
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
В сочетании с существующим фильтром blockstudio/assets/process/scss/import_paths вы один раз определяете общую среду Sass, доступную каждому скомпилированному файлу.
Таблица стилей блока может содержать только нужные ему стили:
.hero {
@include media-breakpoint-up(lg) {
padding: 4rem;
}
}
Больше не нужно повторять импорты в ресурсах каждого блока. Это не особый режим «поддержки Bootstrap», а универсальный хук для общего Sass проекта, будь то Bootstrap или ваш собственный внутренний набор инструментов.
Определения блоков в нативном синтаксисе PHP для API
В версии 7.2 также появился необязательный синтаксис PHP для полнофункциональных API блоков. Массивы остаются форматом по умолчанию и полностью поддерживаются. Ничего не заменено. Но если вы предпочитаете именованные аргументы, перечисления и атрибуты вложенным массивам конфигурации, теперь можно выбрать этот стиль.
Для rpc.php верните объект с методами, помеченными атрибутами:
<?php
use Blockstudio\Attributes\Rpc;
use Blockstudio\Rpc\Access;
use Blockstudio\Rpc\Method;
return new class {
#[Rpc(access: Access::Session)]
public function subscribe(array $params): array {
return ['success' => true];
}
#[Rpc(name: 'status', methods: [Method::Get, Method::Post])]
public function getStatus(array $params): array {
return ['status' => 'ok'];
}
};
Для cron.php тот же подход работает с #[Cron]:
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;
return new class {
#[Cron(schedule: Schedule::Hourly)]
public function heartbeat(): void {
}
};
А для db.php теперь есть небольшой уровень построителя:
<?php
use Blockstudio\Db\Field;
use Blockstudio\Db\Schema;
use Blockstudio\Db\Storage;
return Schema::make(
storage: Storage::Table,
fields: [
'email' => Field::string(required: true, format: 'email'),
'active' => Field::boolean(default: false),
],
);
Такой подход лучше подходит для крупных кодовых баз. Когда нужно, вы сохраняете простоту формата массивов, а по мере роста блока и увеличения числа полей или конечных точек можете перейти к более понятной среде PHP.
Почему эти возможности выпущены вместе
Сводка панели администратора, просмотрщик реестра, реестр CLI и расширение PHPStan отвечают на один и тот же вопрос: как сохранить понятность проекта Blockstudio по мере его роста?
Инструменты панели администратора помогают на уровне проекта: дают представление о зарегистрированных компонентах, позволяют добавлять блоки из реестров и уменьшают необходимость в догадках.
CLI помогает на уровне экосистемы: позволяет обмениваться блоками между проектами и командами, не упаковывая их в пакеты npm и не борясь с системами сборки.
Расширение PHPStan помогает на уровне кода: выявляет неправильное обращение к полям, опечатки в схемах и ошибочные колбэки хуков до их выполнения.
В этом и состоит общее направление версии 7.2: меньше догадок и повторений, больше наглядности и теперь ещё настоящая безопасность типов.
Исправления ошибок
- Поле классов: введённые пользователем имена пользовательских классов незаметно удалялись при потере фокуса, потому что валидатор принимал только классы из предопределённого списка Tailwind/настроек. Теперь принимается любая непустая строка.
- Поле атрибутов: после удаления пары атрибутов в сохранённых данных оставались элементы
null. Вместо lodashunset()(который обнуляет элементы массива) теперь используетсяsplice()(который их удаляет). - Минификатор CSS: минификатор TailwindPHP удалял пробелы вокруг
+внутриcalc()иclamp(), из-за чего получались недопустимые CSS, напримерcalc(1rem+0.5vw). Исправлено в вышестоящем TailwindPHP v1.3.1: теперь символы обходятся с учётом глубины, и пробелы удаляются только вокруг комбинаторов селекторов на глубине скобок 0. - Предпросмотр вставщика блоков: в предпросмотре вставщика блоков
$isPreviewвсегда имел значениеfalse, потому что хеш-ключ кэша рендеринга не учитывал режим рендеринга. Теперь для рендеринга в редакторе и предпросмотре создаются отдельные записи кэша. - Вложенный шаблон InnerBlocks: компонент
<InnerBlocks template="..."/>отбрасывал третий элемент (дочерние элементы) из кортежей шаблона, например['core/group', {}, [['core/paragraph']]], из-за чего блоки-контейнеры оказывались пустыми. Теперь вложенные дочерние элементы сохраняются.