Dennis · 14 марта 2026 г.
Blockstudio 7.1
Blockstudio 7.1 — первый выпуск с новыми функциями после переписывания v7. Если v7 заново заложил основу, то версия 7.1 добавляет возможности, которые превращают блоки в нечто большее: слой базы данных, серверные функции, запланированные задачи и CLI. Теперь папка блока может содержать полноценное приложение.
Вот все новинки.
Компоненты
Всегда существовало противоречие между блоками, которые редакторы используют во вставщике, и блоками, из которых разработчики создают другие элементы. Карточка, значок, виджет статистики, поле формы. Им нужен полноценный конвейер Blockstudio (атрибуты, шаблоны, ресурсы, Tailwind), но им незачем появляться во вставщике.
В версии 7.1 появились компоненты, решающие эту проблему. Укажите "component": true в файле block.json — блок пройдет весь конвейер сборки, но не будет зарегистрирован в реестре типов блоков WordPress. Он не появится во вставщике и не попадет в данные редактора, отправляемые в JavaScript, но будет полностью доступен для программного рендеринга.
{
"name": "my-theme/card",
"title": "Card",
"blockstudio": {
"component": true,
"attributes": [
{ "id": "title", "type": "text" },
{ "id": "description", "type": "textarea" }
]
}
}
Выводите их из PHP:
bs_render_block([
'name' => 'my-theme/card',
'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);
Или используйте новый синтаксис тегов HTML:
<bs:my-theme-card title="My Card" description="Card content." />
Теги блоков
Теперь блоки можно встраивать как теги HTML, используя два взаимозаменяемых синтаксиса:
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />
Оба варианта дают одинаковый результат. Оба работают с блоками Blockstudio и основными блоками WordPress. В шаблонах блоков они выводятся автоматически, без дополнительных настроек. Это позволяет собирать целые макеты из других блоков прямо в шаблоне:
<div class="my-page">
<bs:mytheme-card title="Featured" />
<block name="core/separator" />
<bs:core-heading level="2">Section Title</bs:core-heading>
<block name="core/group">
<block name="core/paragraph">Inside a core group block.</block>
<bs:mytheme-cta variant="primary" />
</block>
</div>
Эти два синтаксиса можно свободно вкладывать друг в друга. Блоки Blockstudio проходят полный конвейер (шаблоны, Tailwind, ресурсы). Основные блоки выводятся через WordPress с помощью тех же средств рендеринга, что и для Страниц и паттернов.
Для рендеринга на уровне страниц (содержимое записи, области виджетов) включите эту возможность в blockstudio.json:
{ "blockTags": { "enabled": true } }
Списки разрешений и запретов управляют тем, какие блоки можно выводить через теги, используя шаблоны с подстановочными знаками. Атрибуты data-* и html-* передаются корневому элементу HTML отрендеренного блока. Пользовательские средства рендеринга можно зарегистрировать через фильтр blockstudio/block_tags/renderers.
Под капотом парсер тегов представляет собой новый легковесный строковый сканер, полностью заменяющий DOMDocument. Он обрабатывает вложенные теги с отслеживанием глубины, рекурсивные контейнерные блоки и смешанный синтаксис за один проход. В тестах производительности он разбирает 1,000 плоских тегов за 2.4ms и 100 уровней вложенности за 3.7ms, стабильно работая быстрее DOMDocument и WordPress с помощью WP_HTML_Tag_Processor. Этот же парсер также обрабатывает разбор необработанных элементов HTML для страниц и шаблонов, заменяя парсер на основе DOMDocument, который раньше обрабатывал <p>, <div> и другие элементы HTML.
Новые типы полей
Блок
Новый тип поля block позволяет ссылаться на другой блок Blockstudio как на атрибут. Поля блока, на который ведет ссылка, раскрываются внутри с помощью idStructure и overrides, как и пользовательские поля. Отличие в том, что при обращении к значению в шаблоне возвращается результат рендеринга блока.
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Если у mytheme/card есть поля heading и content, в боковой панели родительского блока появятся card_heading и card_content. В шаблоне {{ a.card }} выводит отрендеренную карточку. Работает и с обычными блоками, и с компонентами.
тег HTML
В каждой теме есть блоки, уровень заголовка которых должен меняться в зависимости от контекста: H1 на главной странице, H2 на внутренних. Вместо того чтобы каждый раз создавать для этого поле выбора с жестко заданными вариантами, теперь доступен специальный тип поля html-tag со встроенными наборами вариантов.
{
"id": "tag",
"type": "html-tag",
"default": "h2",
"tags": "heading",
"exclude": ["h5", "h6"]
}
Наборы: heading (h1-h6), text (заголовки + p, span, div), structural (div, section, article, aside, main, header, footer, nav), all. Можно также передать собственный массив. exclude исключает отдельные теги из любого набора.
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>
База данных
Это центральная возможность выпуска. Добавьте файл db.php в папку любого блока, и Blockstudio создаст пять конечных точек REST для операций CRUD, проверит каждую запись по схеме, автоматически настроит хранилище и предоставит клиент JavaScript (bs.db()) и PHP API (Db::get()). Файлы миграций, классы контроллеров и регистрация маршрутов не нужны.
return [
'subscribers' => [
'storage' => 'table',
'capability' => [
'create' => true,
'read' => true,
'update' => 'edit_posts',
'delete' => 'manage_options',
],
'fields' => [
'email' => [
'type' => 'string',
'format' => 'email',
'required' => true,
'validate' => function ($value) {
if (str_ends_with($value, '@spam.com')) {
return 'This domain is blocked.';
}
return true;
},
],
'name' => ['type' => 'string', 'maxLength' => 100],
'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
],
],
];
Одна эта схема создает полностью рабочий API с конечными точками создания, получения списка, получения записи, обновления и удаления — все с проверкой входных данных.
Хранилище
Пять типов хранилища для разных задач:
table: Пользовательская таблица MySQL, управляемая черезdbDelta(). При добавлении полей в схему столбцы создаются при следующей загрузке страницы. Вариант по умолчанию для рабочей среды.sqlite: Один файл SQLite в папкеdb/блока. Настоящие запросы SQL, режим WAL для одновременного чтения и полная переносимость. Скопируйте папку — и база данных переместится вместе с ней.jsonc: Один объект JSON на строку в обычном файле. Удобен для чтения, контроля версий и git.meta: Массив JSON в метаданных записи WordPress, связанный с конкретной записью.post_type: Каждая запись становится записью WordPress в пользовательском типе записей. Поля хранятся в отдельных записях метаданных и доступны для запросов черезWP_Query.
Клиенты
Для JavaScript bs.db() предоставляет полноценный клиент CRUD:
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);
В комплект также входят три вспомогательных инструмента:
bs.cache: Кэш запросов в памяти сget,set,invalidateиclear. Общий для всех вызовов запросов и мутаций.bs.query(key, fn, options): Оборачивает асинхронную функцию, добавляя кэширование, дедупликацию запросов и настраиваемыйstaleTime. Несколько вызовов с одним ключом во время выполнения запроса возвращают один и тот же промис.bs.mutate(options): Выполняет оптимистичные мутации с автоматическим откатом. Передайте реактивный объект состояния, действие (create,update,delete) и оптимистичные данные. Объект UI обновляется сразу. Если вызов сервера завершается ошибкой, состояние возвращается к снимку до мутации.
Вместе они охватывают весь цикл чтения и записи: bs.query для чтения из кэша, bs.mutate для оптимистичной записи, bs.cache для ручного управления.
На стороне PHP класс Db предоставляет те же операции:
use Blockstudio\Db;
$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);
Проверка данных
Ошибки проверки возвращаются в виде массивов ошибок для каждого поля — по образцу формата fieldErrors в Zod. Для одного поля могут не пройти несколько правил, а структура упрощает привязку ошибок к полям формы во внешнем интерфейсе:
{
"data": {
"status": 400,
"errors": {
"email": ["Must be a valid email address.", "This domain is blocked."],
"plan": ["Must be one of: free, pro."]
}
}
}
Пользовательские функции обратного вызова validate выполняются на сервере для проверки всего, что не охватывают встроенные правила: блокировки доменов, проверки нескольких полей, внешние запросы.
Данные пользователя
Для данных отдельных пользователей, например списка дел, избранного или черновиков, укажите userScoped равным true — остальное обработает Blockstudio. Он добавит столбец user_id, будет автоматически заполнять его при создании и отфильтрует каждый запрос по текущему пользователю. При обновлении и удалении проверяется владелец. Не нужны поле user_id вручную, хук before_create и фильтрация в RPC. Всего одна строка настроек. При использовании хранилища post_type значение userScoped соответствует post_author, а не отдельному столбцу.
return [
'storage' => 'sqlite',
'userScoped' => true,
'fields' => [ /* ... */ ],
];
Опрос изменений в реальном времени
Укажите 'realtime' => true в схеме, и клиент будет автоматически опрашивать сервер на предмет изменений. При изменении данных на сервере обновляется хранилище Interactivity API, а UI перерисовывается без изменений JavaScript с вашей стороны. Настройте опрос с помощью 'realtime' => ['key' => 'todos', 'interval' => 5000], указав пользовательские ключи состояния и интервалы. Для уменьшения объема запросов используется сравнение хешей; опрос приостанавливается, когда вкладка браузера скрыта.
Безопасность, хуки и переносимость
Публичные конечные точки защищены автоматически добавляемым заголовком CSRF X-BS-Token. Если нужен полностью неаутентифицированный доступ, например для входящих вебхуков, используйте 'open'.
Хуки жизненного цикла срабатывают до и после каждой операции записи. Определяйте их прямо в db.php или глобально с помощью действий WordPress.
Для отрисовки форм на основе схемы поля могут задавать ключ component через bs_db_form().
При использовании хранилища SQLite или JSONC все приложение находится в одной папке: код, логика, контроль доступа и данные. Скопируйте папку, чтобы развернуть приложение.
RPC
Иногда CRUD недостаточно. Нужна собственная серверная логика: переключение задачи, отправка уведомления, сбор статистики. Для этого предназначен rpc.php. Определите функцию PHP, вызовите ее из внешнего интерфейса с помощью bs.fn(), а Blockstudio обработает конечную точку REST, аутентификацию, защиту CSRF и сериализацию JSON. Подход вдохновлен tRPC: процедуры определяются на сервере и вызываются клиентом по имени.
return [
'subscribe' => function (array $params): array {
$email = sanitize_email($params['email']);
return ['success' => true];
},
];
const result = await bs.fn('subscribe', { email: 'user@example.com' });
Встроенные скрипты (script-inline.js) автоматически определяют имя блока по атрибуту data-block своего тега script, поэтому передавать его вручную не нужно. В качестве третьего аргумента имя передается модульным скриптам.
Варианты управления доступом: public (с CSRF), 'open' (без защиты), строки разрешений или массивы. Поддерживаются управление методом HTTP для каждой функции, хуки жизненного цикла и вызовы из JS и PHP между блоками.
Cron
Фоновые задачи определяются в файле cron.php. Укажите расписание и функцию обратного вызова, и Blockstudio зарегистрирует их в WordPress Cron при инициализации. При деактивации плагина все задачи корректно снимаются с расписания.
return [
'cleanup' => [
'schedule' => 'daily',
'callback' => function () {
$db = Db::get('my-theme/app', 'logs');
// delete old entries
},
],
'sync' => [
'schedule' => 'hourly',
'callback' => function () {
// pull from external API
},
],
];
Поддерживаются все встроенные расписания WordPress, а пользовательские интервалы можно задать через фильтр cron_schedules.
CLI
Новая команда wp bs охватывает весь набор возможностей Blockstudio: блоки, база данных, RPC, cron, настройки, компиляция Tailwind, компиляция SCSS, пользовательские поля и управление ресурсами.
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled
Все команды поддерживают --format=json для использования в скриптах.
Улучшения повторителей
textMinimized для объектных полей
Теперь свернутые строки повторителя правильно обрабатывают значения объектных полей. Раньше при указании textMinimized для поля ссылки отображалось [object Object]. Теперь Blockstudio автоматически считывает нужное свойство в зависимости от типа поля: title для ссылок, value для цветов и градиентов, icon для значков. Также можно явно указать свойство key, чтобы считывать любое нужное свойство.
{
"type": "repeater",
"textMinimized": { "id": "href", "fallback": "Add a link" },
"attributes": [{ "id": "href", "type": "link" }]
}
RichText и MediaPlaceholder
Теперь оба компонента шаблонов работают внутри полей повторителя. Используйте квадратные скобки, чтобы указать нужную строку. В каждой строке повторителя можно редактировать заголовки и абзацы прямо на месте, а также загружать медиафайлы.
{% for item in a.items %}
<div class="card">
<MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
<RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
<RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
</div>
{% endfor %}
Условия пользовательских полей с idStructure
При использовании пользовательского поля с idStructure идентификаторы условий в его определении теперь автоматически меняются в соответствии с развернутыми именами. Если для группы полей размера шрифта задано условие на enable и вы развернули ее с помощью idStructure: "title_font_{id}", условие теперь правильно ссылается на title_font_enable вместо исходного enable.
Поддерживаются и условия на уровне ссылки. Добавьте conditions к ссылке на пользовательское поле, чтобы применить их сразу ко всем развернутым полям.
Динамические аргументы populate
Теперь аргументы populate могут ссылаться на атрибуты других блоков с помощью синтаксиса {attributes.*}. При изменении атрибута, на который ведет ссылка, варианты в поле выбора автоматически загружаются заново. Можно связать несколько полей выбора: одно выбирает тип записи, другое загружает записи этого типа.
{
"id": "selected_post",
"type": "select",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "{attributes.post_type}"
}
}
}
Измените post_type на “page”, и во втором поле выбора загрузятся страницы. Измените его на “post” — загрузятся записи. Работает с любым типом populate и любым атрибутом.
Composer
Теперь Blockstudio работает при загрузке из любого места внутри wp-content/, а не только из папки плагинов. URL ресурсов определяется через константу BLOCKSTUDIO_URL, а не через plugins_url(), поэтому установка в составе темы работает сразу:
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';
Зависимости composer.json для выполнения очищены. Пакеты с пространством имен (TailwindPHP, ScssPhp, Minify), уже включенные в lib/, больше не перечисляются как зависимости для выполнения. Остались только php >= 8.2 и plugin-update-checker.
Все три способа установки (архив плагина, плагин через Composer, тема с включенным плагином через Composer) дают одинаковый результат: полная активация WordPress, регистрация блоков и рендеринг внешней части.
Инструкции по настройке см. в документации Composer.
Профилировщик производительности
Добавьте ?blockstudio-perf на страницу URL, и внизу появится панель отладки с временем рендеринга каждого блока, разбивкой по этапам и долей попаданий в кэш. Данные времени также передаются в заголовках Server-Timing и отображаются на вкладке Network в инструментах разработчика браузера.
{ "dev": { "perf": true } }
Включите эту возможность постоянно в настройках, чтобы профилировать каждую загрузку страницы. Она видна только пользователям с выполненным входом и разрешением edit_posts.
Теперь в памяти кэшируются и самозакрывающиеся теги блоков. Если один и тот же блок с одинаковыми атрибутами встречается на странице несколько раз, при последующих выводах полный конвейер шаблонов пропускается.
Исправления ошибок
- Предупреждения об устаревании PHP 8.4: Исправлены предупреждения об устаревании
strpos()иstr_replace(), возникавшие при передачеnullвadd_submenu_page().
Дополнительно
- Поля кода SCSS: Поля кода поддерживают
language: "scss". Значения компилируются через ScssPhp и в редакторе, и во внешней части. - Стандартные блоки WordPress: В папках Blockstudio наряду с блоками Blockstudio может находиться вывод
@wordpress/create-block. Они регистрируются автоматически, без отдельного кода плагина.
В руководстве Руководство по полнофункциональным блокам показано, как с нуля создать приложение со списком дел для отдельных пользователей и публичную форму подписки на рассылку.