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

Dennis · 14 марта 2026 г.

Blockstudio 7.1

Blockstudio 7.1 — первый выпуск с новыми функциями после переписывания v7. Если v7 заново заложил основу, то версия 7.1 добавляет возможности, которые превращают блоки в нечто большее: слой базы данных, серверные функции, запланированные задачи и CLI. Теперь папка блока может содержать полноценное приложение.

Вот все новинки.

Компоненты

Всегда существовало противоречие между блоками, которые редакторы используют во вставщике, и блоками, из которых разработчики создают другие элементы. Карточка, значок, виджет статистики, поле формы. Им нужен полноценный конвейер Blockstudio (атрибуты, шаблоны, ресурсы, Tailwind), но им незачем появляться во вставщике.

В версии 7.1 появились компоненты, решающие эту проблему. Укажите "component": true в файле block.json — блок пройдет весь конвейер сборки, но не будет зарегистрирован в реестре типов блоков WordPress. Он не появится во вставщике и не попадет в данные редактора, отправляемые в JavaScript, но будет полностью доступен для программного рендеринга.

JSON
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      { "id": "title", "type": "text" },
      { "id": "description", "type": "textarea" }
    ]
  }
}

Выводите их из PHP:

PHP
bs_render_block([
  'name' => 'my-theme/card',
  'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);

Или используйте новый синтаксис тегов HTML:

HTML
<bs:my-theme-card title="My Card" description="Card content." />

Теги блоков

Теперь блоки можно встраивать как теги HTML, используя два взаимозаменяемых синтаксиса:

HTML
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />

Оба варианта дают одинаковый результат. Оба работают с блоками Blockstudio и основными блоками WordPress. В шаблонах блоков они выводятся автоматически, без дополнительных настроек. Это позволяет собирать целые макеты из других блоков прямо в шаблоне:

Twig
<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:

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, как и пользовательские поля. Отличие в том, что при обращении к значению в шаблоне возвращается результат рендеринга блока.

JSON
{
  "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 со встроенными наборами вариантов.

JSON
{
  "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 исключает отдельные теги из любого набора.

Twig
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>

База данных

Это центральная возможность выпуска. Добавьте файл db.php в папку любого блока, и Blockstudio создаст пять конечных точек REST для операций CRUD, проверит каждую запись по схеме, автоматически настроит хранилище и предоставит клиент JavaScript (bs.db()) и PHP API (Db::get()). Файлы миграций, классы контроллеров и регистрация маршрутов не нужны.

PHP
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:

JavaScript
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 предоставляет те же операции:

PHP
use Blockstudio\Db;

$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);

Проверка данных

Ошибки проверки возвращаются в виде массивов ошибок для каждого поля — по образцу формата fieldErrors в Zod. Для одного поля могут не пройти несколько правил, а структура упрощает привязку ошибок к полям формы во внешнем интерфейсе:

JSON
{
  "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, а не отдельному столбцу.

PHP
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: процедуры определяются на сервере и вызываются клиентом по имени.

PHP
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
JavaScript
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 при инициализации. При деактивации плагина все задачи корректно снимаются с расписания.

PHP
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, чтобы считывать любое нужное свойство.

JSON
{
  "type": "repeater",
  "textMinimized": { "id": "href", "fallback": "Add a link" },
  "attributes": [{ "id": "href", "type": "link" }]
}

RichText и MediaPlaceholder

Теперь оба компонента шаблонов работают внутри полей повторителя. Используйте квадратные скобки, чтобы указать нужную строку. В каждой строке повторителя можно редактировать заголовки и абзацы прямо на месте, а также загружать медиафайлы.

Twig
{% 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.*}. При изменении атрибута, на который ведет ссылка, варианты в поле выбора автоматически загружаются заново. Можно связать несколько полей выбора: одно выбирает тип записи, другое загружает записи этого типа.

JSON
{
  "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(), поэтому установка в составе темы работает сразу:

PHP
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 в инструментах разработчика браузера.

JSON
{ "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. Они регистрируются автоматически, без отдельного кода плагина.

В руководстве Руководство по полнофункциональным блокам показано, как с нуля создать приложение со списком дел для отдельных пользователей и публичную форму подписки на рассылку.