Перейти до вмісту

Dennis · 23 липня 2026 р.

Blockstudio 7.5

Blockstudio Версія 7.5 завершує налаштування робочого процесу Blockstudio з пріоритетом файлів: користувацькі типи полів, шаблони Site Editor на основі файлів, ізольовані блоки, зберігання бази даних 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, зокрема для об’єктів і масивів.
  • Нативна інтеграція: власні типи полів працюють у групах, вкладках, повторювачах, багаторазово використовуваних власних полях, шаблонах і шляхах шаблонів розширень.
  • Шаблони Site Editor: теми можуть визначати джерела wp_template і wp_template_part з template.json, part.json і файлів шаблонів Blockstudio.
  • Острови блоків: блоки можуть спершу відображати оболонку, безпечну для кешування, а після завантаження сторінки гідратувати або пакетно отримувати фрагменти, специфічні для запиту.
  • Зберігання бази даних Storh: bs.db може використовувати індексоване сховище «файл на запис» у завантаженнях, зберігаючи публічні цілочисельні ідентифікатори та підтримуючи міграцію з JSONC на Storh через WP-CLI.
  • Удосконалення парсера та bsui: для зіставлених абзаців richtext потрібно менше власного коду парсера, InnerBlocks може використовувати токенізований allowedBlocks, вкладений вивід bs_render_block() у попередньому перегляді редактора відповідає відображенню на фронтенді, а bsui/button отримує іконки та зручніші засоби стилізації.
  • Компоновані теги блоків: теги з префіксами можуть визначатися через інший префікс (<theme-ui-input> через bsui/input), а теги з префіксами й псевдонімами відображаються у виводі шаблону блока, а не лише у вмісті сторінки.
  • Кеші збірки, безпечні для хоста: кеші середовища виконання та редактора тепер за замовчуванням розміщуються поза завантаженнями, підтримують налаштовувані шляхи та очищають застарілі записи, щоб у довготривалих проєктах не накопичувалися файли кешу.
  • Інкрементальна звірка сторінок: засоби розгортання можуть звіряти повний перелік сторінок-файлів, пропускати незмінені записи, точно повідомляти про зміни та зберігати перевірений ідентифікатор джерела після активації.
  • Швидше відображення з прогрітим кешем: коректні кеші середовища виконання гідратуються до виявлення, паралельні холодні запити публікують один атомарний результат, а Tailwind зберігає кеш розміру сайту з повторно використовуваним станом компілятора.
  • Безпечне пакетне відображення: експортери можуть скидати стан відображення, пов’язаний із запитом, між документами без повторного виявлення та збирати залежності джерел під час відображення блоків.

Нові функції

У версії 7.5 з’явився широкий набір нових можливостей для виявлення, шаблонів і зберігання даних.

Логічні джерела виявлення

Зазвичай Blockstudio виявляє файли у фізичних каталогах тем. У версії 7.5 додано джерело нижчого рівня API для середовищ виконання, які формують тему з накладень, попередніх переглядів, згенерованих файлів, віддалених монтувань або інших об’єднаних переліків.

Інтеграція може надати остаточне логічне дерево файлів, а Blockstudio і далі відповідає за блоки, поля, сторінки, патерни, Site Editor, 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, зміни вхідних даних для відстеження інвалідують кеші, а дані про походження визначають, куди можна записувати згенеровані файли. Для звичайних тем типове файлове джерело не змінилося.

Шаблони Site Editor із файлів

Команди вже можуть зберігати структури вмісту у файлах сторінок і патернів. У версії 7.5 цю модель поширено й на сам Site Editor.

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 як звичайний шаблон або частину шаблону Site Editor. Site Editor бачить шаблон, фронтенд може його відобразити, а WordPress і далі відповідає за власні налаштування.

Останнє особливо важливо. Шаблони з файлів є резервним джерелом. Якщо користувач зберігає шаблон у Site Editor, 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,
  ],
]);

Процес виявляє повний бажаний перелік сторінок, порівнює відбитки вмісту та рушія синхронізації й повідомляє про створені, оновлені, незмінені, видалені сторінки та сторінки з помилками. Для сторінок з однаковими відбитками не виконується записів у записи чи postmeta. Відсутні керовані сторінки видаляються лише після завершення виявлення без помилок.

Звірка повертає детермінований ідентифікатор джерела, але не позначає розгортання як успішне. Засоби розгортання зберігають цей ідентифікатор лише після того, як відповідні файли й маршрути активовано та перевірено. Звичайне завантаження WP-CLI реєструє кешовані типи записів колекцій і правила перезапису URL без виявлення та синхронізації кожної сторінки.

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

Більшість блоків 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 зберігаються в завантаженнях:

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 bsui/button тепер підтримує атрибут icon і 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, а не в завантаженнях. Шлях можна змінити за допомогою cache.path або blockstudio/cache/dir, тож постійне кешування доступне на хостах, які блокують дані PHP у завантаженнях. Кеші середовища виконання, ресурсів редактора та 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.