
Blockstudio 7.7 додає віртуальні маршрути для документів без запису WordPress,
покращує цільові збірки попереднього рендерення та робить редагування й рендеринг наявних блоків надійнішими. Також розширено перевірки тегів блоків у PHPStan і покращено доступність компонентів UI, що входять до комплекту.

Робочий процес із файлами на першому місці не змінюється. Блоки рендеряться з шаблонів, а файлові сторінки змінюються лише після явної синхронізації CLI або API.
У цьому випуску не додано автоматичної синхронізації сторінок під час запитів відвідувачів або адміністраторів.

Коротко:

- **Віртуальні маршрути**: відображайте галерею компонентів, каталог чи інший повноцінний документ без створення запису або власного обробника перенаправлень.
- **Цільові збірки попереднього рендерення**: збірки HTTP записують вихідні файли, які використовує кожна сторінка, щоб під час наступної збірки рендерити лише заторкнуті маршрути.
- **Збереження кешу**: залишайте застарілі таблиці стилів доступними для сторінок у кеші та переглядайте або очищайте невикористані записи карти ранньої видачі.
- **Надійніший редактор**: блоки, вибрані разом, зберігають власні значення; скасування й повторення дій працюють для RichText і полів бічної панелі, а успадкований контекст залишається з потрібним блоком.
- **Цілісність файлового вмісту**: вкладені списки, структурні елементи, вбудований HTML, шорткоди й екрановані атрибути зберігаються під час розбору та рендерингу.
- **Покращення PHPStan**: теги з префіксами, псевдоніми, зіставлені елементи сторінок і змінні шаблонів перевіряються за власними визначеннями проєкту.
- **Доступні UI**: елементи керування правильно повідомляють про свій стан, мітки перемикають потрібні поля, а компоненти списків і таблиць мають коректну структуру HTML.
- **Переклади**: встановлені переклади JavaScript завантажуються в редакторі та огляді адміністратора, зокрема раніше неперекладені елементи керування полями.

## Віртуальні маршрути

Деякі сторінки формуються з даних, а не з запису, яким керує редактор. Наприклад, для довідника компонентів може знадобитися власний URL і назва документа, але не запис у `wp_posts`.

Зареєструйте цей документ за допомогою `Blockstudio\Virtual_Routes`:

```php title="functions.php"
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/`. Його зворотний виклик виконується в буфері виводу Blockstudio, тож відрендерені блоки отримують стилі, скрипти, ресурси UI із комплекту й вивід Tailwind через звичайний конвеєр. WordPress не перетворює зіставлений маршрут на 404 і не перенаправляє його до запису.

Для групи URL-адрес установіть для `prefix` значення `true` і передайте зворотний виклик `match`. Він отримує шлях після маршруту й повертає значення, потрібне рендереру. Якщо повернути `null` або `false`, запит буде передано WordPress. Використовуйте `urls`, щоб перелічити шляхи, які має включити статична збірка попереднього рендерення. Окремий маршрут без префікса за замовчуванням містить власний шлях.

`Virtual_Routes::urls()` повертає абсолютні URL-адреси для інтеграцій, які створюють карту сайту. Віртуальні документи не додаються автоматично до карти сайту записів WordPress.

Докладніше про повний [Віртуальні маршрути](https://blockstudio.dev/uk/docs/pages-and-patterns/pages/#virtual-routes) та параметри див. в API.

## Точніші збірки попереднього рендерення

Збірки в режимі графа, створені через HTTP, тепер записують файли, використані кожним маршрутом: шаблон WordPress, шаблони й ресурси відрендерених блоків, визначення та макети файлових сторінок, а також залежності, додані через `blockstudio/render/dependencies`.

Під час наступної збірки `build_plan()` порівнює ці залежності. Зміна шаблону блоку позначає залежні від нього маршрути для рендерення, тож не потрібно перебудовувати всі не пов’язані сторінки. Зміни спільної конфігурації, як і раніше, впливають на всю збірку, а нові маршрути й маршрути, термін дії яких минув, рендеряться як і раніше.

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

У випуску також виправлено зміну ідентифікаторів збірки під час першого рендерення, застарілі карти ранньої видачі в кеші opcode, а також виключення коректних URL-адрес лише через наявність у шляху `search` або `preview`. Запити Markdown із `Accept: text/markdown` оминають кешований HTML, а у відповідних відповідях надсилається `Vary: Accept`.

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

Див. [Статичне попереднє рендерення](https://blockstudio.dev/uk/docs/production/static-prerendering/).

## Збереження та обслуговування кешу

Кешована сторінка HTML може існувати довше, ніж ідентифікатор середовища виконання, у якому було скомпільовано її таблицю стилів. За `cache.namespaceGrace` визначається, як довго застарілі простори імен залишатимуться доступними після того, як під час очищення вперше виявлено, що вони більше не використовуються:

```json title="blockstudio.json"
{
  "cache": {
    "namespaceGrace": 777600
  }
}
```

У цьому прикладі застарілі файли зберігаються дев’ять днів. Типове значення — один день. Простори імен, які використовуються зараз або надають розгорнуті артефакти попереднього рендерення, захищені від очищення.

Для карти ранньої видачі також є команди перегляду й очищення:

```bash
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
```

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

Рекомендації щодо зберігання див. в [Кешування](https://blockstudio.dev/uk/docs/production/caching/), а команди — в розділі [обслуговування карти](https://blockstudio.dev/uk/docs/production/static-prerendering/#warming-maintenance-and-observability).

## Надійніший редактор

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

Значення RichText зберігаються безпосередньо в атрибутах блоку, тому Gutenberg може включати їх у скасування й повторення дій. Поля бічної панелі входять до тієї самої історії. `InnerBlocks templateLock="false"` передається як логічне значення й відкриває доступ до вмісту, навіть якщо зовнішню область заблоковано.

Початкове попереднє завантаження отримує ID і тип редагованого запису, тож під час першого рендерення шаблони можуть читати правильні метадані. Однакові дочірні блоки під різними батьківськими блоками зберігають окремий успадкований контекст у попередньому завантаженні й кеші рендерення. Зміни атрибутів або контексту під час початкового запиту більше не призводять до застарілого попереднього перегляду.

Blockstudio також більше не вставляє приховані елементи-маркери рендерення між кореневими елементами блоків. Селектори сусідніх елементів, як-от `.card + .card`, тепер бачать в редакторі ті самі зв’язки між елементами, що й на фронтенді, а попередні перегляди рендерення редактора та засобу вставлення залишаються окремими.

## Безпечніше зберігання параметрів для всього сайту

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

- Під час збереження чернетки, запису на модерації, приватного або запланованого запису активні параметри сайту не змінюються.
- Під час збереження опублікованого запису передані поля, які змінилися під час редагування, зберігаються.
- Збереження лише назви застарілої копії не відновлює давніше значення параметра для всього сайту.
- Відсутні поля й видалені блоки не видаляють наявні параметри.
- Явний `null` видаляє параметр. Порожні рядки, `false`, нуль і порожні масиви залишаються допустимими значеннями.

Це головна зміна поведінки, яку слід перевірити під час оновлення. Якщо інтеграція використовувала приватний запис або чернетку для оновлення активного параметра, запишіть цей параметр явно або використайте опублікований запис конфігурації. Обмеження лише опублікованими записами не впливає на зберігання метаданих записів.

Повні правила збереження див. в [Зберігання](https://blockstudio.dev/uk/docs/blocks/storage/).

## Цілісність файлового вмісту

Конвеєр перетворення 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 або новіша:

```bash
composer require --dev blockstudio/phpstan:^0.1.9
```

Налаштування й пресети аналізу див. в [PHPStan](https://blockstudio.dev/uk/docs/dev/phpstan/).

## Доступність і переклади

Елементи керування розгорнутими блоками UI із комплекту повідомляють про свій стан на самій кнопці. Мітки прапорців, перемикачів і радіокнопок називають відповідні елементи керування та перемикають їх. У ланцюжках навігації, пагінації, меню навігації й таблицях більше не вставляються недопустимі обгорткові елементи між списками чи таблицями та їхніми дочірніми елементами.

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

Редактор і огляд адміністратора завантажують установлені переклади JavaScript для текстового домену `blockstudio`. Меню атрибутів і заповнювачі, дії у спливному вікні коду, а також значки зображень і файлів тепер можна перекладати. Рядки без перекладу залишаються англійською.

Див. бібліотеку [UI](https://blockstudio.dev/uk/ui/) та [налаштування перекладів](https://blockstudio.dev/uk/docs/general/getting-started/#translations).

## Документація та оновлення

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