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

Dennis · 23 июля 2026 г.

Blockstudio 7.5

Blockstudio Версия 7.5 завершает настройку рабочего процесса Blockstudio с приоритетом файлов: добавляет типы пользовательских полей, шаблоны редактора сайта на основе файлов, островки блоков, хранение базы данных Storh, логические источники поиска, компонуемые теги блоков, а также ускоряет развертывание и работу среды выполнения.

Повторно используемые пользовательские поля уже позволяют проектам один раз определить группу существующих полей и использовать ее с type: "custom/{name}". Типы пользовательских полей решают другую задачу: тема или плагин могут зарегистрировать новый тип поля с пространством имен, добавить собственный элемент управления редактора и хранить значение как обычные данные Blockstudio.

Кратко:

  • Логические источники обнаружения: среды выполнения могут предоставлять составной логический перечень тем с указанием происхождения и идентификатора кеша, а Blockstudio сохраняет ответственность за обнаружение, поиск соседних файлов, сгенерированные ресурсы, Canvas и поведение Tailwind.
  • Реестр типов полей PHP: темы и плагины могут регистрировать типы полей с пространствами имён, например acme/dimensions с помощью bs_register_field_type() или фильтра blockstudio/field_types.
  • Реестр элементов управления редактора: пользовательские скрипты редактора могут вызывать window.blockstudio.registerFieldType() и отображать соответствующий элемент управления React в обычном поле Blockstudio UI.
  • Структурированные значения: пользовательские поля могут хранить строки, числа, логические значения, массивы или объекты без преобразования значений-объектов при нормализации полей с вариантами.
  • Поддержка хранения: пользовательские поля на основе метаданных записи и параметров могут объявлять тип значения и схему REST, в том числе для значений-объектов и массивов.
  • Нативная интеграция: пользовательские типы полей работают в группах, вкладках, повторителях, переиспользуемых пользовательских полях, шаблонах и путях шаблонов расширений.
  • Шаблоны редактора сайта: темы могут определять источники wp_template и wp_template_part на основе template.json, part.json и файлов шаблонов Blockstudio.
  • Островки блоков: блоки могут сначала отображать безопасную для кеширования оболочку, а после загрузки страницы гидратировать или пакетно получать фрагменты, зависящие от запроса.
  • Хранение в базе данных Storh: bs.db может использовать хранилище с индексами и отдельным файлом для каждой записи в каталоге uploads, сохраняя общедоступные целочисленные идентификаторы и обеспечивая миграцию с JSONC на Storh через WP-CLI.
  • Улучшения парсера и bsui: для сопоставленных абзацев richtext требуется меньше пользовательского кода парсера, InnerBlocks может использовать токенизированный allowedBlocks, вложенный вывод bs_render_block() в предварительном просмотре редактора совпадает с отображением на сайте, а bsui/button получает значки и более удобные хуки для стилизации.
  • Компонуемые теги блоков: теги-префиксы могут разрешаться через другой префикс (<theme-ui-input> в bsui/input), а теги с префиксами и псевдонимами отображаются в выводе шаблонов блоков, а не только в содержимом страниц.
  • Кеши сборки, безопасные для хоста: кеши среды выполнения и редактора теперь по умолчанию находятся вне uploads, поддерживают настраиваемые расположения и удаляют устаревшие записи, поэтому в долгосрочных проектах не накапливаются файлы кеша.
  • Инкрементальная сверка страниц: инструменты развертывания могут сверять полный перечень страниц из файлов, пропускать неизмененные записи, точно сообщать об изменениях и сохранять проверенную идентичность источника после активации.
  • Быстрее отрисовка при прогретом кеше: валидные кеши среды выполнения гидратируются до обнаружения, параллельные запросы при холодном кеше публикуют один атомарный результат, а Tailwind поддерживает кеш размером с сайт и повторно используемое состояние компилятора.
  • Безопасная пакетная отрисовка: экспортеры могут сбрасывать состояние отрисовки, связанное с запросом, между документами без повторного обнаружения, а также собирать зависимости источников во время отрисовки блоков.

Новые возможности

В версии 7.5 появился широкий набор новых возможностей для обнаружения, шаблонов и хранения данных.

Логические источники обнаружения

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

Интеграция может предоставить итоговое логическое дерево файлов, а Blockstudio сохраняет ответственность за блоки, поля, страницы, паттерны, редактор сайта, Canvas, ресурсы и поведение Tailwind:

PHP
use Blockstudio\Inventory_Discovery_Source;

add_filter(
    'blockstudio/discovery/sources',
    function (array $sources, string $context): array {
        if ('blocks' !== $context) {
            return $sources;
        }

        return [
            new Inventory_Discovery_Source(
                'preview:feature-card',
                '/runtime-preview/feature-card/blockstudio',
                [
                    'card/block.json' => [
                        'path' => '/theme/blockstudio/card/block.json',
                        'provenance' => ['layer' => 'parent'],
                    ],
                    'card/index.php' => [
                        'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
                        'provenance' => ['layer' => 'preview'],
                    ],
                ],
                'preview-fingerprint'
            ),
        ];
    },
    10,
    2
);

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

Шаблоны редактора сайта из файлов

Команды уже могут хранить структуры содержимого страниц и паттернов в файлах. В версии 7.5 эта модель распространена и на сам редактор сайта.

Text
theme/
  templates/
    front-page/
      template.json
      index.php
  parts/
    header/
      part.json
      index.php
JSON
{
  "slug": "front-page",
  "title": "Front Page"
}
PHP
<div class="site-shell">
  <block name="core/template-part" slug="header" />

  <main>
    <h1>Welcome</h1>
    <block name="core/post-content" />
  </main>
</div>

Blockstudio компилирует источник тем же парсером, что используется для страниц и паттернов, а затем передаёт результат в WordPress как обычный шаблон редактора сайта или часть шаблона. Шаблон отображается в редакторе сайта, доступен для отображения на сайте, а WordPress по-прежнему управляет пользовательскими настройками.

Последняя часть важна. Шаблоны из файлов служат резервным источником. Если пользователь сохраняет шаблон в редакторе сайта, WordPress создаёт обычную пользовательскую настройку wp_template или wp_template_part в базе данных, и она получает приоритет. Сбросьте настройку — и снова станет виден последний источник из файла.

Инкрементальное развертывание страниц

В версии 7.5 для страниц из файлов появился механизм сверки при развертывании API. С версии 7.6.2 явные API и wp bs pages sync стали единственными точками входа для синхронизации; обычные запросы никогда не применяют изменения источников:

PHP
$report = Blockstudio\Pages::reconcile([
  'authoritative' => true,
  'plan_valid' => true,
  'source' => [
    'commit' => $commit,
    'dirtyHash' => $dirtyHash,
  ],
]);

Этот процесс обнаруживает полный перечень целевых страниц, сравнивает содержимое и контрольные суммы движка синхронизации, а также сообщает о созданных, обновленных, неизмененных, удаленных и не обработанных из-за ошибок страницах. Для страниц с одинаковыми контрольными суммами записи в post и postmeta не выполняются. Отсутствующие управляемые страницы удаляются только после завершения обнаружения без ошибок.

Сверка возвращает детерминированную идентичность источника, но не отмечает развертывание как успешное. Инструменты развертывания сохраняют эту идентичность только после активации и проверки соответствующих файлов и маршрутов. При обычной загрузке WP-CLI регистрирует кешированные типы записей для коллекций и правила перезаписи, не обнаруживая и не синхронизируя все страницы.

Островки блоков

Большинство блоков Blockstudio отображаются на сервере. Это хорошо подходит для WordPress, но создаёт знакомую проблему с кешированием: из-за одного персонализированного блока кешировать всю страницу становится сложно.

Островки блоков позволяют разделить эту границу на уровне блоков.

JSON
{
  "name": "acme/cart-count",
  "blockstudio": {
    "island": "dynamic"
  }
}

При первом ответе динамический островок отображает только безопасную для кеширования заглушку. Затем браузер отправляет один пакетный запрос для всех готовых динамических островков на странице, а Blockstudio отображает эти фрагменты в контексте реального запроса посетителя.

Это позволяет кешу полных страниц хранить оболочку страницы, пока счётчик корзины, элементы управления учетной записью, UI с ограниченным доступом и другие элементы для конкретного пользователя остаются актуальными.

PHP
<div class="cart-count-placeholder">Loading cart...</div>
PHP
<div class="cart-count">
  <?php echo esc_html(acme_cart_count()); ?>
</div>

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

JSON
{
  "name": "acme/tabs",
  "blockstudio": {
    "island": "hydrate"
  }
}

Гидратированные островки не отправляют запрос REST. Они отображаются как обычно и получают событие blockstudio:island:hydrate на стороне сайта.

Динамические островки также работают при программных вызовах отрисовки:

PHP
bs_render_block([
  'name' => 'acme/cart-count',
  'data' => ['productId' => 42],
]);

А также через теги блоков:

HTML
<bs:acme-cart-count product-id="42" />

Конечная точка намеренно имеет узкую область действия. Она отображает только зарегистрированные блоки Blockstudio, которые являются динамическими и явно помечены как динамические островки. Атрибуты фильтруются по схеме блока и списку разрешённых атрибутов островка, а каждый маркер содержит подпись, созданную обслуживающим сайтом WordPress.

Хранение в базе данных Storh

Уровень работы с базой данных Blockstudio уже поддерживает таблицы, SQLite, JSONC, метаданные записей и пользовательские типы записей. В версии 7.5 добавлено storage: "storh" для проектов, которым нужно файловое хранилище с более безопасной конкурентной записью и индексами на основе схемы, но без фиксации текущих записей рядом с файлами исходного кода блоков.

PHP
return [
    'storage' => 'storh',
    'fields'  => [
        'title'  => ['type' => 'string', 'required' => true],
        'status' => ['type' => 'string'],
        'count'  => ['type' => 'integer'],
    ],
];

Записи Storh хранятся в каталоге uploads:

Text
wp-content/uploads/blockstudio/db/my-theme-my-block/default/

Общедоступный API остаётся неизменным. bs.db(), REST и Db::get() по-прежнему возвращают целочисленные значения id. Внутри Blockstudio связывает эти идентификаторы с идентификаторами документов UUIDv7 в Storh, поэтому существующий клиентский код менять не нужно.

Каждое поле объявленной схемы индексируется для фильтров равенства, числовые поля и поля, похожие на даты, получают индексы диапазонов, а явно заданные подсказки уникальности передаются дальше. Для проектов, начавших с файлов исходных данных JSONC, новая миграция CLI сохраняет исходный файл на месте и записывает эквивалентное хранилище Storh:

Командная оболочка
wp bs db migrate my-theme/app subscribers --to=storh

Так у JSONC появляется более ясная роль простого формата исходных данных и конфигурации, пригодного для фиксации в системе контроля версий, а Storh становится предпочтительным файловым хранилищем по умолчанию для изменяемых рабочих данных.

Улучшения парсера и bsui

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

Сопоставление элементов теперь может обрабатывать распространённый случай с абзацем richtext без пользовательского построителя. Если <p> сопоставляется с зарегистрированным блоком Blockstudio, не входящим в ядро, и у него есть атрибут richtext content, простой внутренний текст копируется в этот атрибут. Вложенные теги и сопоставленные дочерние элементы по-прежнему разбираются как внутренние блоки.

InnerBlocks принимает токенизированный allowedBlocks в шаблонах:

PHP
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
  'core/paragraph',
  'category:content',
  'bsui/field',
])); ?>" />

Поддерживаются токены namespace/*, category:<slug> и @theme. Они раскрываются на сервере до передачи шаблона редактору, поэтому путь отображения на сайте остаётся неизменным.

Встраивание через программный интерфейс стало предсказуемее. Теперь bs_render_block() и bs_block() отображают встроенные блоки как компоненты HTML, разрешаемые на стороне сайта, даже если их вызывают из предварительного просмотра другого блока в редакторе. Это не позволяет вложенным блокам передавать необработанные псевдокомпоненты <RichText /> или <InnerBlocks /> в разметку предварительного просмотра.

Для пакетов UI атрибут icon теперь поддерживает bsui/button и iconPosition. Встроенные строчные стили bsui/* выводятся в слое каскада @layer bsui, а варианты кнопок можно расширять с помощью blockstudio/ui/button/variants-style и уже существующего фильтра blockstudio/blocks/attributes.

Теги блоков тоже стали лучше компоноваться. Префикс может разрешаться через другой префикс, поэтому <theme-ui-input /> с префиксом проекта theme поверх пространства имён ui разрешается как bsui/input. Зарегистрированные теги с префиксами и псевдонимами теперь также отображаются в выводе шаблонов блоков, а не только в содержимом страниц, поэтому шаблон может вывести их напрямую, без вызова bs_render_block().

Пользовательские построители блоков, зарегистрированные через blockstudio/block_tags/builders, также единообразно участвуют в разборе тегов и сопоставленных элементов. После этого по-прежнему выполняются явные фильтры визуализатора, которые могут переопределить построитель.

Быстрее запросы с прогретым кешем и экспорт

Теперь кеши среды выполнения и редактора по умолчанию находятся в каталоге wp-content/blockstudio/cache вместо uploads. Расположение можно изменить через cache.path или blockstudio/cache/dir. Благодаря этому постоянное кеширование доступно и на хостах, которые блокируют данные PHP в uploads. Кеши среды выполнения, ресурсов редактора и Tailwind также автоматически удаляют устаревшие записи, поэтому на диске долгосрочных проектов больше не накапливается неограниченное число файлов кеша.

При запросах к сайту с прогретым кешем валидный реестр среды выполнения теперь загружается до создания источников обнаружения. Это позволяет пропустить рекурсивное обнаружение источников, создание блоков, разбор полей и повторные обходы дерева для ключей кеша. В рабочих и тестовых средах запросы доверяют проверенному снимку отслеживаемых данных в течение 20 секунд по умолчанию, а в локальной среде и при разработке проверка выполняется при каждом запросе.

Создание кеша при его отсутствии выполняется в одном потоке: один запрос собирает и атомарно публикует данные, а параллельные запросы ожидают готового результата. Теперь Tailwind по умолчанию хранит до 1,000 скомпилированных записей в течение 30 дней и повторно использует состояние компилятора после прогрева, поэтому набор маршрутов размером с сайт больше не перегружает небольшой кеш.

Экспортеры с длительным временем работы могут вызывать Blockstudio\Batch_Render::reset() между документами. Это сбрасывает счётчики, ресурсы, островки, макеты и состояние генерации Tailwind, связанное с запросом, без повторного обнаружения. Фильтр blockstudio/render/dependencies предоставляет пути к шаблонам и ресурсам, использованным каждым отображённым блоком, для построения графов зависимостей.

Надёжность и совместимость

Релиз завершает несколько исправлений:

  • Изменения определений полей через blockstudio/blocks/attributes теперь влияют и на проверку вариантов во время отображения, и на схему редактора. Типизированные числовые значения и логические значения вариантов также обрабатываются единообразно.
  • Обёртки блоков в редакторе используют те же сгенерированные классы, что и при отображении на сайте, а Canvas может копировать настроенные классы тела страницы с помощью нового фильтра blockstudio/editor/canvas/body_class.
  • Content Sync проверяет полный план источника до деструктивной записи, ограничивает операции удаления настроенным набором содержимого и сообщает об ошибках записи файлов, не продвигая состояние синхронизации соответствующей сущности.
  • Пакеты Composer, включённые в активные темы или родительские темы через символические ссылки, находят ресурсы редактора в общедоступном каталоге темы URL.
  • Страницы из файлов с ключами сохраняют значения полей Blockstudio, принадлежащие редактору, переносят прежнюю вложенную структуру ключей при синхронизации и принимают числовой ноль как допустимый ключ.
  • Динамические островки проверяют подписи до фильтров атрибутов запроса, игнорируют неподписанный контекст запроса, восстанавливают состояние вошедших пользователей с того же источника и предотвращают конфликты анонимного кеша для разных пользователей.
  • Конечные точки страниц в необработанном виде Markdown теперь учитывают видимость записей и защиту паролем.
  • Элементы управления редактора надёжнее обрабатывают пустые условия, значения переключателя «выбрать всё» для флажков, асинхронное обновление вариантов, порядок динамического отображения и состояние RichText или WYSIWYG в повторителях.

Пользовательские типы полей

Подробнее о пользовательских типах полей, представленных выше.

Зачем нужны пользовательские типы полей?

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

До версии 7.5 такие проекты могли либо компоновать несколько встроенных полей, либо создавать ответвление редактора. В версии 7.5 появился поддерживаемый компромисс: Blockstudio управляет жизненным циклом поля, а проект — элементом управления.

PHP
add_action('init', function () {
    wp_register_script(
        'acme-field-dimensions',
        get_stylesheet_directory_uri() . '/fields/dimensions.js',
        ['blockstudio-blocks', 'wp-components', 'wp-element'],
        '1.0.0',
        true
    );

    bs_register_field_type('acme/dimensions', [
        'attribute'     => 'object',
        'default'       => [],
        'editor_script' => 'acme-field-dimensions',
        'storage'       => [
            'type'        => 'object',
            'rest_schema' => [
                'type'                 => 'object',
                'additionalProperties' => ['type' => 'string'],
            ],
        ],
    ]);
});
JavaScript
const { createElement: el } = wp.element;
const { TextControl } = wp.components;

window.blockstudio.registerFieldType('acme/dimensions', {
  component(props) {
    const value =
      props.value &&
      typeof props.value === 'object' &&
      !Array.isArray(props.value)
        ? props.value
        : {};
    const sides = props.sides || ['top', 'right', 'bottom', 'left'];

    return el(
      'div',
      {},
      sides.map((side) =>
        el(TextControl, {
          key: side,
          label: side,
          value: value[side] || '',
          onChange(nextValue) {
            props.onChange({
              ...value,
              [side]: nextValue,
            });
          },
        }),
      ),
    );
  },
});

Затем поле можно использовать в block.json как нативное поле:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "margin",
        "type": "acme/dimensions",
        "label": "Margin",
        "sides": ["top", "bottom"],
        "default": {
          "top": "md",
          "bottom": "md"
        }
      }
    ]
  }
}

Обычные значения шаблона

Сохранённое значение доступно в PHP, Twig и Blade, как и любой другой атрибут Blockstudio.

PHP
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
  <?php echo esc_html($a['title'] ?? ''); ?>
</div>

Те же пути к объектам работают и в шаблонах расширений:

JSON
{
  "blockstudio": {
    "extend": "core/group",
    "attributes": [
      {
        "id": "margin",
        "type": "acme/dimensions",
        "set": [
          {
            "attribute": "class",
            "value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
          }
        ]
      }
    ]
  }
}

Примечания о совместимости

Существующие встроенные типы полей не изменились. Существующие группы переиспользуемых полей custom/{name} тоже не изменились. Имена пользовательских типов полей должны быть в нижнем регистре и содержать пространство имён, например acme/dimensions; пространства имён custom/ и blockstudio/ зарезервированы.

Если PHP регистрирует тип поля, но его скрипт редактора не регистрирует соответствующий элемент управления, Blockstudio сохраняет значение и показывает в редакторе уведомление без возможности редактирования. Если тип поля не зарегистрирован в PHP, Blockstudio не включает его в сгенерированные атрибуты WordPress.

Обновление обслуживания 7.5.1

В 7.5.1 устранено предупреждение о преобразовании массива в строку, возникавшее при подготовке значений множественного выбора к отображению. Сохранённые и отображаемые значения уже были правильными, но в журналах отладки могло появляться по одному предупреждению при каждом отображении поля.

Сопутствующее обновление blockstudio/phpstan v0.1.7 также распознаёт поля, вложенные в анонимные группы, в PHP, Twig, Blade и предполагаемых структурах атрибутов шаблонов. Существующие проекты могут получить это исправление пакета с помощью composer update blockstudio/phpstan.