Dennis · 14 октября 2026 г.
Blockstudio 7.7
Blockstudio 7.7 добавляет виртуальные маршруты для документов без записи WordPress, улучшает целевые сборки пререндеринга и повышает надёжность редактирования и отображения существующих блоков. Кроме того, расширены проверки тегов блоков в PHPStan и улучшена доступность встроенных компонентов UI.
Рабочий процесс с приоритетом файлов остаётся прежним. Блоки отображаются на основе шаблонов, а страницы на основе файлов меняются только после явной синхронизации CLI или API. В этом выпуске автоматическая синхронизация страниц по запросам посетителей или администраторов не добавлена.
Кратко:
- Виртуальные маршруты: отдавайте галерею компонентов, каталог или другой полноценный документ без создания записи и написания собственного обработчика перенаправлений.
- Целевые сборки пререндеринга: сборки HTTP в режиме графа записывают исходные файлы, используемые каждой страницей, чтобы при следующей сборке отображать только затронутые маршруты.
- Хранение кеша: сохраняйте устаревшие таблицы стилей доступными для страниц в кеше и проверяйте или удаляйте неиспользуемые записи карты ранней отдачи.
- Надёжность редактора: значения блоков, выбранных одновременно, сохраняются независимо; отмена и повтор изменений работают для RichText и полей боковой панели; унаследованный контекст остаётся у нужного блока.
- Точность содержимого файлов: вложенные списки, элементы структурирования разделов, встроенный HTML, шорткоды и экранированные атрибуты сохраняются при разборе и отображении.
- Улучшения PHPStan: теги с префиксами, псевдонимы, сопоставленные элементы страниц и переменные шаблонов проверяются по определениям самого проекта.
- Доступные UI: элементы управления правильно сообщают своё состояние, подписи переключают нужные поля, а компоненты списков и таблиц используют корректную структуру HTML.
- Переводы: установленные переводы JavaScript загружаются в редакторе и панели администратора, в том числе переводы элементов управления полями, которые прежде оставались без перевода.
Виртуальные маршруты
Некоторые страницы формируются из данных, а не из записи под управлением редактора. Например, справочной странице компонента может понадобиться собственный URL и заголовок документа, но запись в wp_posts ей не нужна.
Зарегистрируйте этот документ с помощью Blockstudio\Virtual_Routes:
add_action('init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function () {
get_header();
echo bs_block([
'name' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
]);
get_footer();
},
['title' => 'Component gallery']
);
});
Маршрут отдаёт /components/. Его callback выполняется в буфере вывода Blockstudio, поэтому отображаемые блоки получают стили, скрипты, ресурсы из комплекта UI и вывод Tailwind через обычный конвейер. WordPress не превращает маршрут в запись 404 и не перенаправляет его на запись.
Для семейства URL задайте для prefix значение true и укажите callback match. Callback получает путь после маршрута и возвращает значение, необходимое вашему рендереру. Если вернуть null или false, обработка запроса останется за WordPress. Используйте urls, чтобы перечислить пути, которые нужно включить в сборку статического пререндеринга. Для одиночного маршрута без префикса его собственный путь включается по умолчанию.
Virtual_Routes::urls() возвращает абсолютные URL для интеграций, которые собирают карту сайта. Виртуальные документы автоматически не добавляются в карту сайта записей WordPress.
Полное описание Виртуальных маршрутов и параметров смотрите в API.
Более точные сборки пререндеринга
Сборки в режиме графа, выполняемые для HTTP, теперь записывают файлы, использованные каждым маршрутом: шаблон WordPress, шаблоны и ресурсы отображаемых блоков, определения страниц на основе файлов и макеты, а также зависимости, добавленные через blockstudio/render/dependencies.
При следующей сборке build_plan() сравнивает эти зависимости. Изменение шаблона блока помечает зависящие от него маршруты для повторного отображения, не перестраивая остальные страницы. Изменения общей конфигурации по-прежнему влияют на всю сборку, а новые и просроченные маршруты отображаются как прежде.
Изменения только в базе данных не считаются файловыми зависимостями. Чтобы при развёртывании учесть настройку, запись или другое значение из базы, нужно принудительно запустить сборку или явно отобразить затронутые URL.
В выпуске также исправлены изменения идентификаторов сборки во время первого отображения, устаревшие карты ранней отдачи в кеше opcode и исключение корректных URL лишь потому, что в пути содержится search или preview. Запросы Markdown с использованием Accept: text/markdown обходят кешированный HTML, а соответствующие ответы отправляют Vary: Accept.
Теперь при решении о подключении хуков статический пререндеринг учитывает фильтры, зарегистрированные активной темой. Тема может отключить эту функцию, и предварительное чтение настроек не оставит её включённой.
Хранение и обслуживание кеша
Кешированная страница HTML может пережить идентификатор среды выполнения, в которой была скомпилирована её таблица стилей. cache.namespaceGrace задаёт срок хранения устаревших пространств имён после того, как очистка впервые обнаружит, что они устарели:
{
"cache": {
"namespaceGrace": 777600
}
}
Этот пример сохраняет устаревшие файлы в течение девяти дней. Значение по умолчанию — один день. Активные пространства имён и пространства имён, обслуживающие развёрнутые артефакты пререндеринга, защищены от очистки устаревших данных.
Для карты ранней отдачи также предусмотрены команды проверки и очистки:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
Они сообщают о записях удалённых сайтов или отсутствующих каталогов и удаляют их. При удалении сайта из мультисайтовой сети его записи также удаляются. Об отсутствующих документах маршрутов сообщается отдельно, поэтому корректная запись сайта не удаляется целиком.
Рекомендации по хранению данных см. в разделе Кеширование, а команды обслуживания карты — в разделе обслуживание карты.
Более надёжный редактор
Теперь редактирование одного из нескольких выбранных блоков обновляет только этот блок. При сохранении каждый блок сохраняет собственное содержимое, ключи, метаданные и блокировки; атрибуты выбранных блоков не копируются друг в друга.
Значения RichText хранятся непосредственно в атрибутах блока, поэтому Gutenberg может включать их в историю отмены и повтора действий. Поля боковой панели участвуют в той же истории. InnerBlocks templateLock="false" передаётся как логическое значение и позволяет изменять содержимое, даже если внешняя область заблокирована.
При первоначальной предварительной загрузке передаются идентификатор и тип редактируемой записи, поэтому шаблоны сразу могут прочитать нужные метаданные. Одинаковые дочерние блоки у разных родительских блоков сохраняют отдельный унаследованный контекст при предварительной загрузке и в кеше рендеринга. Изменения атрибутов или контекста во время первоначального запроса больше не оставляют предварительный просмотр устаревшим.
Blockstudio также перестал вставлять скрытые элементы-маркеры рендеринга между корневыми элементами блоков. Селекторы соседних элементов, например .card + .card, теперь видят в редакторе те же связи между элементами, что и на фронтенде; при этом предварительные просмотры в редакторе и вставщике остаются раздельными.
Более безопасное хранение общесайтовых параметров
Поля, связанные с настройками, по-прежнему предоставляют общесайтовые значения, но при сохранении записи копии этих полей больше не записываются без разбора:
- При сохранении черновиков, записей на проверке, личных и запланированных записей действующие настройки сайта не изменяются.
- При сохранении опубликованных записей записываются переданные поля, изменённые в ходе этого редактирования.
- Сохранение только заголовка старой копии не возвращает более новое общесайтовое значение.
- Отсутствующие поля и удалённые блоки не удаляют существующие настройки.
- Явный
nullудаляет настройку. Пустые строки,false, ноль и пустые массивы остаются допустимыми значениями.
Это главное изменение поведения, которое нужно проверить при обновлении. Если интеграция использовала личную или черновую запись для изменения действующей настройки, укажите эту настройку явно или вместо этого используйте опубликованную запись конфигурации. Ограничение для опубликованных записей не влияет на хранение метаданных записей.
Полные правила сохранения см. в разделе Хранение.
Содержимое файлов сохраняется без изменений
Конвейер преобразования HTML в блоки теперь сохраняет больше структуры, которую вы создали:
- Вложенные списки становятся внутренними блоками списка внутри родительского элемента. Классы списка и его элементов сохраняются; обычные плоские списки по-прежнему выводятся как раньше.
main,header,footer,articleиasideстановятся блоками группы, которые сохраняют исходный элемент, вместо необработанного HTML, обходящего рендеринг блоков.- Сопоставленные абзацы форматированного текста сохраняют встроенную разметку; абзацы только с изображением преобразуются в сопоставленный блок изображения, а теги шорткодов сохраняют своё содержимое.
- Экранированные атрибуты декодируются и экранируются один раз, в том числе атрибуты в
InnerBlocks,RichTextи элементеuseBlockProps. - Знаки «больше» внутри атрибутов тегов без закрытия в кавычках теперь обрабатываются корректно.
- Глобальные атрибуты HTML передаются корневому элементу блока Blockstudio, если блок не объявляет их своими полями.
wp bs pages syncсообщает о сохранённых атрибутах, которые не отображаются.
Страницы на основе Blade, паттерны и шаблоны редактора сайта теперь отображаются через Blockstudio\Blade_Renderer, с поддержкой illuminate/view 8–12. Регистрируются все файлы расширений, относящиеся к одному блоку; их приоритет, поля группы и списки целевых объектов соответствуют задокументированной схеме.
Отслеживаются также вложенные зависимости SCSS. Изменение частичного шаблона, импортированного другим частичным шаблоном, меняет версию зависимой таблицы стилей и запускает её повторную компиляцию.
Улучшения PHPStan
Отдельно устанавливаемый пакет blockstudio/phpstan расширяет проверку тегов блоков: она охватывает теги с префиксами и псевдонимами, сопоставленные элементы страниц, макеты, входящие в комплект блоки UI и, при необходимости, другие источники PHP проекта. Разрешение пространств имён соответствует среде выполнения, в том числе для пространств имён с дефисами; пересылаемые глобальные атрибуты HTML считаются допустимыми.
Переменные шаблонов блоков, такие как $a, $block и $context, считаются определёнными в Blockstudio. Типы полей сохраняются при объединении с null и использовании isset() в PHPStan 2.3, а шаблон, который присваивает собственный $a, сохраняет назначенный им тип.
Эти изменения включены в blockstudio/phpstan 0.1.9. Обновите пакет отдельно от плагина; требуется PHPStan 2.1.47 или новее:
composer require --dev blockstudio/phpstan:^0.1.9
Конфигурацию и пресеты анализа см. в PHPStan.
Доступность и переводы
Переключатели встроенных компонентов UI показывают своё раскрытое состояние непосредственно на кнопке. Подписи флажков, переключателей и радиокнопок называют соответствующие элементы управления и переключают их. Между списками или таблицами и их дочерними элементами больше не вставляются недопустимые обёрточные элементы в хлебных крошках, пагинации, меню навигации и таблицах.
Кнопки показа пароля сообщают о состоянии нажатия и имеют большую область нажатия. Поля ввода принимают autocomplete; для полей пароля можно явно задать идентификатор и доступную подпись. Области просмотра карусели доступны для перехода с клавиатуры, а анимация индикаторов загрузки и скелетонов учитывает предпочтение уменьшения движения.
Редактор и обзорная панель администратора загружают установленные переводы JavaScript для текстового домена blockstudio. Меню атрибутов и текст-заполнитель, действия всплывающего окна с кодом, а также значки изображений и файлов теперь можно переводить. Строки без перевода остаются на английском.
См. библиотеку UI и настройку переводов.
Документация и обновление
В документацию добавлены руководства по сайтам документации, Content Sync, шаблонам редактора сайта, тегам блоков, островам, пользовательским типам полей, развертыванию, предварительному рендерингу, настройке реестра, инструментам анализа и экранам приложения UI. Руководство по миграции ACF отражает актуальную регистрацию ACF и привязки блоков.
В примерах пользовательского заполнения теперь используется поддерживаемый фильтр с одним аргументом и именованным набором данных. В документации по ресурсам объясняется порядок загрузки таблиц стилей интерфейса и способ загрузки переопределений темы после CSS блока. Для установки участниками проекта используется общедоступный пакет Font Awesome без учетных данных реестра.
PHP 8.2 и WordPress 6.7 по-прежнему являются минимальными требованиями. Виртуальные маршруты и новые команды обслуживания доступны без изменения существующих коллекций страниц. Проверьте приведенные выше правила сохранения параметров, обновите отдельный пакет PHPStan, если используете его, и, как и раньше, запускайте синхронизацию страниц явно.
7.7.1 Последующие действия
Патч 7.7.1 делает результаты синхронизации более понятными и безопасными. Слияние по ключам, которое не изменяет запись, больше не создает новую ревизию и не обновляет дату изменения. Существующие статусы публикации сохраняются, о заменах заголовка и ярлыка, управляемых файлом, сообщается, а заблокированные или удаленные страницы указываются в отчете CLI. Content Sync помечает тела, которыми управляет Page Sync, и сохраняет существующие копии для проверки. Патч также защищает атрибуты, управляемые WordPress, от конфликтующих ID полей и сохраняет классы редактора, добавленные другими фильтрами.