
Blockstudio 7.7 přidává virtuální trasy pro dokumenty bez příspěvku WordPress, zlepšuje cílená sestavení pro předběžné vykreslování a zvyšuje spolehlivost úprav a vykreslování existujících bloků. Rozšiřuje také kontroly značek bloků v PHPStan a zlepšuje přístupnost dodávaných komponent UI.

Pracovní postup založený na souborech zůstává stejný. Bloky se vykreslují ze svých šablon a stránky založené na souborech se mění prostřednictvím výslovné synchronizace CLI nebo API. Tato verze nezavádí automatickou synchronizaci stránek při požadavcích návštěvníků ani administrátorů.

Stručně řečeno:

- **Virtuální trasy**: zobrazte galerii komponent, katalog nebo jiný úplný dokument bez vytvoření příspěvku či napsání vlastního obslužného kódu pro přesměrování.
- **Cílená sestavení pro předběžné vykreslování**: sestavení HTTP zaznamenávají zdrojové soubory, které jednotlivé stránky používají, takže pozdější sestavení může vykreslit pouze dotčené trasy.
- **Uchovávání v mezipaměti**: zachovejte starší šablony stylů pro stránky uložené v mezipaměti a prohlížejte či odstraňujte nepoužívané položky mapy pro předčasné obsloužení.
- **Spolehlivější editor**: bloky vybrané současně si uchovají vlastní hodnoty, vrácení a opakování změn funguje pro pole RichText i postranního panelu a zděděný kontext zůstává u správného bloku.
- **Věrnost obsahu v souborech**: vnořené seznamy, prvky členící obsah, vložené HTML, shortcode a escapované atributy se při parsování a vykreslování zachovají.
- **Vylepšení PHPStan**: značky s prefixy, aliasy, mapované prvky stránek a proměnné šablon se kontrolují podle vlastních definic projektu.
- **Přístupné UI**: ovládací prvky správně zpřístupňují svůj stav, popisky přepínají správné vstupy a komponenty seznamů a tabulek používají platnou strukturu HTML.
- **Překlady**: nainstalované překlady JavaScript se načítají v editoru a administračním přehledu, včetně dříve nepřeložených ovládacích prvků polí.

## Virtuální trasy

Některé stránky vycházejí z dat, nikoli z příspěvku spravovaného editorem. Například reference komponenty může potřebovat vlastní URL a název dokumentu, ale žádnou položku v `wp_posts`.

Zaregistrujte tento dokument pomocí `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']
    );
});
```

Trasa obslouží `/components/`. Její zpětné volání se spustí uvnitř výstupní vyrovnávací paměti Blockstudio, takže vykreslené bloky získají své styly, skripty, dodávané prostředky UI a výstup Tailwind běžným postupem. WordPress nepřemění odpovídající trasu na 404 ani ji nepřesměruje na příspěvek.

Pro skupinu adres URL nastavte `prefix` na `true` a zadejte zpětné volání `match`. Zpětné volání obdrží cestu za trasou a vrátí hodnotu potřebnou vykreslovači. Pokud vrátí `null` nebo `false`, požadavek se předá WordPress. Pomocí `urls` vypište cesty, které má zahrnout sestavení statického předběžného vykreslování. Jedna trasa bez prefixu ve výchozím nastavení zahrnuje vlastní cestu.

`Virtual_Routes::urls()` vrací absolutní adresy URL pro integrace, které sestavují mapu webu. Virtuální dokumenty se automaticky nepřidávají do mapy příspěvků WordPress.

Úplný popis API a dostupných možností najdete v části [Virtuální trasy](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/#virtual-routes).

## Přesnější sestavení pro předběžné vykreslování

Sestavení v grafovém režimu spuštěná přes HTTP nyní zaznamenávají soubory použité jednotlivými trasami: šablonu WordPress, vykreslené šablony a prostředky bloků, definice stránek a rozvržení souborů a závislosti přidané přes `blockstudio/render/dependencies`.

Při dalším sestavení `build_plan()` tyto závislosti porovná. Změna šablony bloku označí její závislé trasy k opětovnému vykreslení, aniž by bylo nutné znovu sestavit všechny nesouvisející stránky. Změny sdílené konfigurace stále ovlivní celé sestavení a nové či neplatné trasy se vykreslí jako dříve.

Změny pouze v databázi nejsou závislostmi souborů. Nasazení, které musí načíst novou hodnotu nastavení, příspěvku nebo jinou databázovou hodnotu, musí vynutit sestavení nebo výslovně vykreslit dotčené adresy URL.

Tato verze také opravuje změny identifikátorů sestavení během prvního vykreslení, zastaralé mapy pro předčasné obsloužení uložené v mezipaměti operačních kódů a vylučování platných adres URL jen proto, že jejich cesta obsahuje `search` nebo `preview`. Požadavky Markdown používající `Accept: text/markdown` obcházejí mezipaměť HTML a příslušné odpovědi odesílají `Vary: Accept`.

Statické předběžné vykreslování nyní při rozhodování, zda připojit své háčky, respektuje filtry zaregistrované aktivní šablonou. Šablona může tuto funkci vypnout, aniž by ji zanechalo aktivní dřívější načtení nastavení.

Viz [Statické předběžné vykreslování](https://blockstudio.dev/cs/docs/production/static-prerendering/).

## Uchovávání a údržba mezipaměti

Stránka HTML uložená v mezipaměti může přežít identitu běhového prostředí, ve kterém byla zkompilována její šablona stylů. `cache.namespaceGrace` určuje, jak dlouho zůstávají zastaralé jmenné prostory dostupné poté, co úklid poprvé zjistí, že zastaraly:

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

Tento příklad uchovává zastaralé soubory po dobu devíti dnů. Výchozí doba je jeden den. Aktivní jmenné prostory a jmenné prostory obsluhující nasazené artefakty předběžného vykreslení jsou před úklidem zastaralých položek chráněny.

Mapa pro předčasné obsloužení má také příkazy ke kontrole a úklidu:

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

Tyto příkazy vypisují a odstraňují položky smazaných webů nebo chybějících adresářů. Smazáním webu v multisite se odstraní také jeho položky. Chybějící dokumenty tras se vypisují samostatně, takže kvůli nim nedojde k odstranění celé platné položky webu.

Pokyny k uchovávání najdete v části [Ukládání do mezipaměti](https://blockstudio.dev/cs/docs/production/caching/) a příkazy v části [Údržba mapy](https://blockstudio.dev/cs/docs/production/static-prerendering/#warming-maintenance-and-observability).

## Spolehlivější editor

Úprava bloku vybraného spolu s dalšími nyní aktualizuje pouze tento blok. Při ukládání si každý blok uchová vlastní obsah, klíče, metadata a zámky, místo aby se mezi vybranými bloky kopírovaly atributy.

Hodnoty RichText jsou přímo v atributech bloku, takže Gutenberg je může zahrnout do vrácení a opakování změn. Pole postranního panelu jsou součástí stejné historie. `InnerBlocks templateLock="false"` se předává jako skutečná logická hodnota a odemyká obsah, i když je nadřazená oblast uzamčena.

Počáteční přednačtení obdrží ID a typ upravovaného příspěvku, takže šablony mohou při prvním vykreslení načíst správná metadata. Stejné podřízené bloky pod různými nadřazenými bloky si v přednačtení i mezipaměti vykreslování uchovají oddělený zděděný kontext. Změny atributů nebo kontextu během počátečního požadavku už nezpůsobí zastarání náhledu.

Blockstudio také přestává vkládat skryté prvky značek vykreslování mezi kořeny bloků. Selektory sousedních sourozenců, například `.card + .card`, nyní v editoru vidí stejné vztahy mezi prvky jako na frontendu, zatímco náhledy vykreslení v editoru a nástroji pro vkládání zůstávají oddělené.

## Bezpečnější ukládání nastavení pro celý web

Pole uložená v nastaveních stále poskytují hodnoty pro celý web, ale ukládání příspěvku už bez rozmyslu nezapisuje každou uloženou kopii těchto polí:

- Ukládání konceptů, čekajících, soukromých a naplánovaných příspěvků nezapisuje aktivní nastavení webu.
- U publikovaných příspěvků se zapisují dodaná pole, která se při úpravě změnila.
- Uložení pouze názvu staré kopie nevrátí novější hodnotu pro celý web.
- Chybějící pole a odebrané bloky nesmažou existující nastavení.
- Výslovný `null` odstraní nastavení. Prázdné řetězce, `false`, nula a prázdná pole zůstávají platnými hodnotami.

Toto je hlavní změna chování, kterou je třeba při upgradu ověřit. Pokud integrace používala soukromý příspěvek nebo koncept k aktualizaci aktivního nastavení, zapište toto nastavení výslovně nebo místo toho použijte publikovaný konfigurační příspěvek. Ukládání do metadat příspěvku omezením na publikované příspěvky ovlivněno není.

Úplná pravidla ukládání najdete v části [Ukládání](https://blockstudio.dev/cs/docs/blocks/storage/).

## Obsah souborů zůstává zachován

Řetězec převodu HTML na bloky zachovává více struktury, kterou jste vytvořili:

- Vnořené seznamy se mění na vnitřní bloky seznamu uvnitř nadřazené položky. Třídy seznamů a položek se zachovají; běžné ploché seznamy si ponechávají dosavadní výstup.
- Značky `main`, `header`, `footer`, `article` a `aside` se mění na skupinové bloky, které zachovávají daný prvek, místo surového HTML obcházejícího vykreslování bloků.
- Mapované odstavce s formátovaným textem zachovávají vložené značky, odstavce obsahující pouze obrázek se převedou na mapovaný blok obrázku a značky shortcode zachovají svůj obsah.
- Escapované atributy se dekódují a escapují jednou, včetně atributů na `InnerBlocks`, `RichText` a prvku `useBlockProps`.
- Větší než znaky uvnitř uvozovaných atributů samouzavíracích značek se přijímají.
- Globální atributy HTML se dostanou do kořene bloku Blockstudio, pokud je blok nedefinuje jako pole. `wp bs pages sync` vypisuje uložené atributy, které se nevykreslují.

Stránky, vzory a šablony editoru webu založené na Blade se nyní vykreslují přes `Blockstudio\Blade_Renderer`, který podporuje `illuminate/view` 8 až 12. Zaregistrují se všechny rozšiřující soubory cílící na stejný blok a jejich priorita, skupinová pole i seznamy cílů odpovídají dokumentovanému schématu.

Sledují se také vnořené závislosti SCSS. Úprava dílčí šablony importované jinou dílčí šablonou změní verzi závislé šablony stylů a spustí její opětovnou kompilaci.

## Vylepšení PHPStan

Samostatně instalovaný balíček `blockstudio/phpstan` rozšiřuje ověřování značek bloků na značky s prefixy a aliasy, mapované prvky stránek, rozvržení, dodávané bloky UI a volitelně další zdroje PHP projektu. Řešení jmenných prostorů odpovídá běhovému prostředí, včetně jmenných prostorů s pomlčkami, a přijímají se předávané globální atributy HTML.

Proměnné šablon bloků, například `$a`, `$block` a `$context`, považuje Blockstudio za definované. Typy polí se zachovávají při slučování s hodnotou null a v PHPStan 2.3 také při `isset()`, zatímco šablona, která přiřadí vlastní `$a`, si ponechá přiřazený typ.

Tyto změny jsou součástí `blockstudio/phpstan` 0.1.9. Aktualizujte balíček samostatně od pluginu; vyžaduje PHPStan 2.1.47 nebo novější:

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

Konfiguraci a předvolby analýzy najdete v části [PHPStan](https://blockstudio.dev/cs/docs/dev/phpstan/).

## Přístupnost a překlady

Dodávané spouštěče UI uvádějí rozbalený stav přímo na tlačítku. Popisky zaškrtávacích polí, přepínačů a přepínačů možností pojmenovávají a aktivují příslušné ovládací prvky. Drobečková navigace, stránkování, navigační nabídky a tabulky už mezi seznamy či tabulkami a jejich potomky nevkládají neplatné obalové prvky.

Přepínače viditelnosti hesla uvádějí stav stisknutí a mají větší aktivní oblast. Vstupy přijímají `autocomplete` a vstupy pro hesla přijímají výslovné ID a přístupný popisek. Zobrazovací oblasti karuselů lze zaměřit klávesnicí a animace indikátorů načítání i kosterních obrazovek respektují nastavení omezení pohybu.

Editor a administrační přehled načítají nainstalované překlady JavaScript pro textovou doménu `blockstudio`. Nabídky atributů a zástupné texty, akce vyskakovacího okna s kódem a štítky obrázků i souborů lze nyní překládat. Řetězce bez překladu zůstávají v angličtině.

Viz knihovna [UI](https://blockstudio.dev/cs/ui/) a [nastavení překladu](https://blockstudio.dev/cs/docs/general/getting-started/#translations).

## Dokumentace a upgrade

Dokumentace přidává průvodce weby s dokumentací, Content Sync, šablonami editoru webu, značkami bloků, islands, vlastními typy polí, nasazením, předběžným vykreslováním, nastavením registru, analytickými nástroji a obrazovkami aplikace UI. Průvodce migrací ACF odráží aktuální registraci ACF a Block Bindings.

Příklady vlastního naplnění nyní používají podporovaný filtr s pojmenovanou datovou sadou a jediným argumentem. Dokumentace k prostředkům vysvětluje pořadí stylů pro frontend a způsob načítání přepsání motivu po CSS bloku. Instalace pro přispěvatele používají veřejný balíček Font Awesome bez přihlašovacích údajů k registru.

PHP 8.2 a WordPress 6.7 zůstávají minimálními požadavky. Virtuální trasy a nové příkazy pro údržbu jsou dostupné bez změny stávajících kolekcí stránek. Projděte výše uvedená pravidla ukládání možností, aktualizujte samostatný balíček PHPStan, pokud jej používáte, a nadále výslovně spouštějte synchronizaci stránek jako dosud.

### 7.7.1 Následné kroky

Patch 7.7.1 zpřehledňuje a zvyšuje bezpečnost výsledků synchronizace. Sloučením podle klíče, které příspěvek nijak nezmění, už nevzniká nová revize ani se neaktualizuje čas změny. Stávající stavy publikace se zachovávají, nahrazení názvu a slugy spravovaných souborů se hlásí a uzamčené nebo odstraněné stránky se uvádějí v hlášení CLI. Content Sync označuje těla spravovaná Page Sync a zachovává stávající kontrolní kopie. Patch také chrání atributy spravované WordPress před konfliktními ID polí a zachovává třídy editoru přidané jinými filtry.
