Dennis · 21 июня 2026 г.
Blockstudio 7.4
Blockstudio Версия 7.4 призвана сделать проекты на основе файлов более переносимыми. В версии 7.2 стало проще проверять и распространять крупные проекты, а в 7.3 появился слой UI. Версия 7.4 переносит больше составляющих проекта — его страницы и подобранный контент — из базы данных в файлы под контролем версий.
Главное новшество — коллекции страниц: они позволяют указать Blockstudio папку с исходниками страниц и создать на их основе полную вложенную структуру страниц WordPress. Источником могут быть PHP, Twig, Blade, HTML, Markdown или доверенный загрузчик, возвращающий страницы из другого локального источника.
Кратко:
- Коллекции страниц:
pages.jsonможет задавать полный набор вложенных страниц, значения по умолчанию, поведение типа записи, макеты, загрузчики и метаданные коллекции. - Страницы Markdown:
index.mdподходит для содержимого страниц — как вместе сpage.json, так и отдельно, с frontmatter. - Макеты страниц интерфейса:
layout.phpможет оборачивать синхронизированное содержимое страницы и использовать такие помощники, какblockstudio_page_tree()иblockstudio_page_content(). - Внешние источники документации: загрузчики коллекций могут создавать страницы из локальных файлов или возвращенных значений Markdown/HTML.
- Необработанный вывод Markdown: источники страниц Markdown можно отдавать как
.mdили черезAccept: text/markdown. - Пользовательские типы записей для коллекций: коллекции могут иметь понятные URL, автоматически обновлять правила перезаписи, предоставлять маршруты необработанного Markdown и переносить страницы в пользовательские типы записей без обходных решений на стороне темы.
- Синхронизация контента:
wp bs content pull,wp bs content pushиwp bs content statusпереносят разрешенные списком записи, термины, связи и объявленные ссылки на метаданные в переносимые файлы проекта. - Префиксы тегов блоков: префиксы проекта, такие как
<theme-card>, могут разрешаться в упорядоченных пространствах имен без псевдонимов для каждого блока. - Надежная синхронизация: изменения страниц обнаруживаются в манифестах, загрузчиках, макетах, метаданных и исходных файлах.
- Исправления среды выполнения и редактора: динамические параметры остаются актуальными, классы блоков запросов сохраняются при программном рендеринге,
bsui/selectлучше работает в насыщенных формах, свойства RichText передаются в редактор, а удаление строк повторителя с RichText сохраняется после сохранения.
Страницы на основе файлов
Большая часть версии 7.4 построена на страницах на основе файлов.
Коллекции страниц
До версии 7.4 страницы на основе файлов были в основном функцией уровня папки: создайте page.json, добавьте index.php или index.twig, и Blockstudio синхронизирует эту единственную страницу с WordPress.
Это по-прежнему работает. В версии 7.4 появился второй режим для более крупных структур.
Добавьте в папку манифест pages.json, и она станет коллекцией:
pages/
docs/
pages.json
layout.php
index.md
guide/
install/
index.md
reference/
page.json
index.md
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"postTypeArgs": {
"label": "Docs",
"rewrite": {
"slug": "docs"
},
"supports": ["title", "editor", "page-attributes"]
},
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}
Все источники страниц в коллекции обнаруживаются, нормализуются, синхронизируются и связываются по пути. Страница в guide/install становится дочерней для guide; если страницы guide нет, Blockstudio создает страницу-контейнер, чтобы иерархия WordPress соответствовала структуре файловой системы.
Коллекции могут использовать встроенный тип записей page или собственный тип записей. Если коллекция объявляет еще не существующий тип записей, Blockstudio регистрирует его из postTypeArgs. Манифест postType также задает значения по умолчанию для всех страниц коллекции, поэтому проектам не нужно повторять его в defaults.
Типы записей коллекций используют слаг коллекции как общую основу URL. У коллекции docs корневая страница находится по адресу /docs/, страница с path: "getting-started" — по адресу /docs/getting-started/, а вложенные пути размещаются под той же основой. URL с дублированием, например /docs/docs/, перенаправляются на канонический адрес. Правила перезаписи автоматически сбрасываются при изменении маршрутизации типов записей коллекций, поэтому для новой коллекции не нужно вручную сохранять постоянные ссылки.
Это позволяет естественно создавать внешнюю документацию, руководства по продуктам, базы знаний и библиотеки страниц в WordPress: исходники остаются в файлах, а результат по-прежнему представляет собой полноценный редактируемый контент WordPress.
Markdown как содержимое страницы
Markdown теперь является полноценным источником страниц.
Для отдельных страниц Markdown используется frontmatter:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
Также можно объединить page.json с index.md, если конфигурацию и содержимое нужно хранить в разных файлах. Frontmatter в index.md может переопределять соответствующие поля page.json, а неизвестные ключи frontmatter сохраняются в метаданных.
Markdown преобразуется в HTML, а затем проходит через тот же парсер страниц, что и шаблоны PHP, Twig и Blade, поэтому итоговое содержимое представляет собой нативную разметку блоков.
Макеты и помощники страниц
В коллекции можно добавить файл layout.php. На внешней стороне сайта Blockstudio оборачивает синхронизированное содержимое страницы этим макетом.
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>
Новые помощники предоставляют данные коллекции в структурированном виде:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
Это дает все необходимое для создания полноценной оболочки документации: навигацию по дереву страниц, метаданные страниц из frontmatter и синхронизированное содержимое блоков WordPress в качестве основного содержимого.
Загрузчики и необработанный Markdown
В коллекции можно добавить доверенный локальный файл loader.php. Он может напрямую возвращать страницы или указать Blockstudio дополнительные локальные каталоги для поиска.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
Это удобно, когда источник уже сгенерирован где-то еще: например, папка документации пакета, экспорт Markdown или этап сборки, возвращающий список страниц.
Источники страниц Markdown также могут отдавать необработанный исходник Markdown. Запросите страницу с суффиксом .md или отправьте Accept: text/markdown. Frontmatter удаляется из ответа, поэтому инструменты получают читаемое тело документа. Это работает и для пользовательских типов записей коллекций, в том числе для URL /docs.md и /docs/getting-started.md.
Читать документацию по страницам
Синхронизация контента
В версии 7.4 также появилась синхронизация контента — рабочий процесс WP-CLI для команд, которые хотят хранить больше частей проекта WordPress в файлах.
wp bs content pull
wp bs content push --dry-run
wp bs content status
Blockstudio уже хранит блоки, поля, шаблоны, паттерны и страницы на основе файлов в проекте. Синхронизация контента добавляет в этот ориентированный на файлы процесс выбранные данные из базы: разрешенные списком записи, термины, связи и объявленные метаданные можно выгружать в файлы, проверять в git и загружать в другую среду.
Настройка намеренно требует явных действий. Включите ее в blockstudio.json, добавьте в список разрешенных нужные типы записей и таксономии, а также объявите ссылки на метаданные, которые нужно переписывать при переносе между средами.
При извлечении Blockstudio записывает переносимые записи, термины, связи и метаданные из списка разрешённых в файлы темы. При отправке он проверяет план перед записью и преобразует объявленные ссылки post, term и attachment обратно в локальные идентификаторы базы данных. Произвольные целые числа не считаются идентификаторами без проверки.
Объем версии 7.4 намеренно ограничен: записи, термины, связи между терминами, разрешенные списком метаданные, переносимые UID, манифесты вложений, пробные запуски, обработка удаления и блокируемые сущности, а также отчеты о состоянии. Сохранение определений таксономий, копирование файлов медиа и переписывание ID в разметке блоков намеренно оставлены за рамками первой версии.
Так команды могут удобно хранить в системе контроля версий курируемый контент: сведения о сотрудниках, тематические исследования, местоположения, статьи документации и другие структурированные записи, не превращая всю производственную базу данных в миграцию. Этот подход рассчитан на наборы данных, которые можно проверять в виде файлов: десятки или сотни строк, а в некоторых проектах — несколько тысяч, если контент структурирован и редко меняется. Он не заменяет резервное копирование баз данных, синхронизацию электронной торговли и заказов, аналитику, журналы, отправленные формы и другие большие массивы данных.
Читать документацию по синхронизации контента
Более надежная синхронизация
Blockstudio теперь обнаруживает изменения в источниках страниц, манифестах коллекций, файлах загрузчиков и макетов, метаданных и связанных путях. При изменении любого из них синхронизированная страница WordPress обновляется.
Конвейер обработки страниц также учитывает детали, необходимые для практического использования документации на основе файлов в реальных проектах:
- Источники страниц Markdown синхронизируются как нативное содержимое блоков, включая атрибуты блоков
- метаданные frontmatter доступны помощникам интерфейса и макетам
- идентификаторы страниц коллекции остаются неизменными при синхронизации
- вложенные страницы вне коллекций связываются с родительской страницей
- вложенные страницы вне коллекций могут наследовать ближайший родительский
layout.php - удаленные источники коллекций удаляют созданные ими страницы WordPress
- при смене типа записей коллекции с
pageна пользовательский тип существующие синхронизированные записи переносятся вместо создания дубликатов - порядок страниц сохраняется через
menu_order
Префиксы тегов блоков
Теперь в тегах блоков поддерживаются настраиваемые префиксы пространства имен. Проект может зарегистрировать короткий префикс, чтобы Blockstudio находил блок в одном или нескольких пространствах имен:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
После настройки <theme-card> может разрешаться как theme-components/card, <theme-button> может использовать запасной вариант bsui/button, а <theme-ui-feature-matrix> может разрешаться как theme-components/ui-feature-matrix.
Явные tag_aliases по-прежнему имеют приоритет, если проекту нужно разовое переопределение. Теги с неизвестными префиксами остаются без изменений, а существующие фильтры разрешения и запрета тегов блоков по-прежнему применяются к блокам, найденным по префиксу.
Читать документацию по тегам блоков
Исправления среды выполнения и редактора
В версию 7.4 также вошли исправления, необходимость которых выявилась при работе над реальными проектами.
- Параметры, динамически заполняемые запросами, остаются актуальными при изменении записей, терминов, пользователей и связанных метаданных, а запросные списки
populate.fetch: trueзагружают актуальные параметры при пустом поиске в редакторе. - Теги блоков
core/queryиcore/comments, создаваемые программно, сохраняютclassNameв сгенерированной разметке оболочки. - Псевдокомпоненты шаблонов сохраняют свойства в camelCase, поэтому такие свойства, как
allowedFormatsиwithoutInteractiveFormatting, передаются компоненту редактора, а не отбрасываются заранее. bsui/selectнадежнее обрабатывает данные параметров и выходящие за границы меню, особенно в более сложных элементах управления редактора.blockstudio/phpstanраспознает поля, объявленные внутри контейнеровtabs, поэтому проверки шаблонов, Twig/Blade и тегов блоков понимают ту же структуру полей, которую использует Blockstudio в проектах.- Удаление строки повторителя с RichText сохраняется после сохранения. Устаревшие значения RichText больше не могут восстановить удаленную строку.
Почему этот релиз важен
Главная тема версии 7.4 — переносимость.
Коллекции страниц превращают целые сайты документации в папки с исходными файлами. Страницы Markdown упрощают создание и чтение такого контента. Синхронизация контента расширяет ту же модель с приоритетом файлов на курируемый контент базы данных, поэтому записи, термины и связи можно хранить в git и переносить между средами. Префиксы тегов блоков делают библиотеки блоков удобнее для чтения в шаблонах.
Blockstudio по-прежнему основан на файлах. Блоки по-прежнему представлены папками. Страницы по-прежнему являются файлами. В версии 7.4 просто больше частей проекта — его структур страниц и курируемого контента — можно хранить в этих файлах и переносить вместе с ними.