
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.

Пълното API и наличните опции са описани в [Виртуални маршрути](https://blockstudio.dev/bg/docs/pages-and-patterns/pages/#virtual-routes).

## По-прецизни компилации за предварително рендиране

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

При следващата компилация `build_plan()` сравнява тези зависимости. Промяната на шаблон за блок маркира зависимите от него маршрути за рендиране, без да се налага да се компилира отново всяка несвързана страница. Промените в общата конфигурация продължават да засягат цялата компилация, а новите и изтеклите маршрути се рендират както преди.

Промените само в базата данни не са файлови зависимости. При внедряване, което трябва да включи опция, публикация или друга стойност от базата данни, трябва принудително да се стартира компилация или изрично да се рендират засегнатите URL адреси.

Версията коригира и промените в идентификаторите на компилациите по време на първото рендиране, остарелите карти за ранно обслужване, кеширани от opcode кеша, както и изключването на валидни URL адреси само защото пътят им съдържа `search` или `preview`. Заявките Markdown, използващи `Accept: text/markdown`, заобикалят кеширания HTML, а съответните отговори изпращат `Vary: Accept`.

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

Вижте [Статично предварително рендиране](https://blockstudio.dev/bg/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/bg/docs/production/caching/) за указания относно запазването и [поддръжка на картата](https://blockstudio.dev/bg/docs/production/static-prerendering/#warming-maintenance-and-observability) за командите.

## По-надежден редактор

Редактирането на блок, избран заедно с други, вече променя само него. При запис всеки блок запазва собственото си съдържание, ключове, метаданни и заключвания, вместо атрибутите да се копират между избраните блокове.

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

При първоначалното предварително зареждане вече се получават идентификаторът и типът на редактираната публикация, така че шаблоните да могат да прочетат правилните метаданни още при първото рендиране. Еднаквите дъщерни блокове в различни родителски блокове запазват отделен наследен контекст в предварителното зареждане и кешовете за рендиране. Промените в атрибутите или контекста по време на първоначална заявка вече не водят до остарял преглед.

Blockstudio вече не вмъква и скрити маркери за рендиране между основните елементи на блоковете. Селектори за съседни елементи като `.card + .card` вече виждат същите връзки между елементите в редактора и на предния край, като прегледите при рендиране в редактора и в инструмента за вмъкване остават отделни.

## По-безопасно съхранение на опции за целия сайт

Полетата, съхранявани като опции, продължават да предоставят стойности за целия сайт, но при запис на публикация вече не се записва сляпо всяко запазено копие на тези полета:

- Черновите, чакащите одобрение, личните и планираните записи не променят активните опции на сайта.
- Публикуваните записи променят подадените полета, които са били редактирани.
- Запис само на заглавието в старо копие не връща по-нова стойност за целия сайт.
- Липсващите полета и премахнатите блокове не изтриват съществуващи опции.
- Изрично действие `null` премахва опция. Празните низове, `false`, нулата и празните масиви остават валидни стойности.

Това е основната промяна в поведението, която трябва да проверите при надграждане. Ако интеграция е използвала лична или чернова публикация, за да обнови активна опция, запишете опцията изрично или използвайте публикувана конфигурационна публикация. Ограничението, според което се записват само публикувани записи, не засяга съхранението в метаданните на публикации.

Вижте [Съхранение](https://blockstudio.dev/bg/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/bg/docs/dev/phpstan/).

## Достъпност и преводи

Бутоните, които разгъват включените компоненти на UI, показват състоянието си на самия бутон. Етикетите за квадратчета за отметка, превключватели и радио бутони назовават и превключват съответните контроли. Навигационните пътеки, странирането, навигационните менюта и таблиците вече не вмъкват невалидни обвиващи елементи между списъците или таблиците и дъщерните им елементи.

Превключвателите за показване на парола отчитат състоянието си на натискане и имат по-голяма активна зона. Полетата приемат `autocomplete`, а полетата за парола — изричен идентификатор и достъпен етикет. Изгледите на въртележките могат да получават фокус от клавиатурата, а анимациите на индикаторите за зареждане и скелетните екрани се съобразяват с предпочитанията за намалено движение.

Редакторът и административният преглед зареждат инсталираните преводи на JavaScript за текстовия домейн `blockstudio`. Менютата за атрибути и текстът в полетата за въвеждане, действията в изскачащите прозорци с код, както и значките за изображения и файлове вече могат да бъдат превеждани. Низовете без превод остават на английски.

Вижте библиотеката [UI](https://blockstudio.dev/bg/ui/) и [настройването на преводите](https://blockstudio.dev/bg/docs/general/getting-started/#translations).

## Документация и надграждане

Документацията добавя ръководства за сайтове с документация, Content Sync, шаблони на Site Editor, block tags, islands, типове персонализирани полета, внедряване, предварително генериране, настройка на регистъра, инструменти за анализ и екрани на UI. Ръководството за миграция на ACF отразява актуалната регистрация на ACF и Block Bindings.

Примерите за персонализирано попълване вече използват поддържания филтър с именуван набор от данни и един аргумент. Документацията за ресурсите обяснява реда на стиловите файлове във фронтенда и как да зареждате замени на темата след CSS на блоковете. Инсталациите за сътрудници използват публичния пакет Font Awesome без идентификационни данни за регистър.

PHP 8.2 и WordPress 6.7 остават минималните изисквания. Виртуалните маршрути и новите команди за поддръжка са налични без промяна на съществуващите колекции от страници. Прегледайте правилата за записване на настройките по-горе, актуализирайте отделния пакет PHPStan, ако го използвате, и продължете изрично да стартирате синхронизацията на страниците както досега.

### 7.7.1 Последващи действия

Пачът 7.7.1 прави резултатите от синхронизацията по-ясни и по-безопасни. Обединяване по ключ, което не променя публикация, вече не създава редакция и не обновява времевия ѝ печат за промяна. Съществуващите статуси на публикуване се запазват, заместванията на заглавие и кратко име, управлявани от файл, се отчитат, а заключените или премахнатите страници се посочват в отчета CLI. Content Sync отбелязва телата, управлявани от Page Sync, и запазва съществуващите копия за преглед. Пачът също така защитава управляваните от WordPress атрибути от конфликтни идентификатори на полета и запазва класовете на редактора, добавени от други филтри.
