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

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

## Компоненты

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

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

```json title="block.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 title="index.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 с помощью тех же средств рендеринга, что и для [Страниц и паттернов](https://blockstudio.dev/ru/docs/pages-and-patterns/).

Для рендеринга на уровне страниц (содержимое записи, области виджетов) включите эту возможность в `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 для [страниц и шаблонов](https://blockstudio.dev/ru/docs/pages-and-patterns/), заменяя парсер на основе DOMDocument, который раньше обрабатывал `<p>`, `<div>` и другие элементы HTML.

## Новые типы полей

### Блок

Новый тип поля `block` позволяет ссылаться на другой блок Blockstudio как на атрибут. Поля блока, на который ведет ссылка, раскрываются внутри с помощью `idStructure` и `overrides`, как и пользовательские поля. Отличие в том, что при обращении к значению в шаблоне возвращается результат рендеринга блока.

```json title="block.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 title="db.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:

```js
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](https://trpc.io): процедуры определяются на сервере и вызываются клиентом по имени.

```php title="rpc.php"
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
```

```js
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 title="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, пользовательские поля и управление ресурсами.

```bash
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 title="functions.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](https://blockstudio.dev/ru/docs/dev/composer/).

## Профилировщик производительности

Добавьте `?blockstudio-perf` на страницу URL, и внизу появится панель отладки с временем рендеринга каждого блока, разбивкой по этапам и долей попаданий в кэш. Данные времени также передаются в заголовках Server-Timing и отображаются на вкладке Network в инструментах разработчика браузера.

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

---

В руководстве [Руководство по полнофункциональным блокам](https://blockstudio.dev/ru/guides/full-stack-blocks/) показано, как с нуля создать приложение со списком дел для отдельных пользователей и публичную форму подписки на рассылку.
