
Blockstudio Verze 7.4 se zaměřuje na lepší přenositelnost projektů založených na souborech. Zatímco verze 7.2 usnadnila kontrolu a distribuci větších projektů a verze 7.3 přidala vrstvu UI, verze 7.4 se soustředí na přesun větší části projektu, jeho stránek a vybraného obsahu z databáze do souborů spravovaných ve verzovacím systému.

Hlavní novinkou jsou kolekce stránek: umožňují nasměrovat Blockstudio do složky se zdroji stránek a vytvořit z nich úplnou vnořenou strukturu stránek WordPress. Zdrojem může být PHP, Twig, Blade, HTML, Markdown nebo důvěryhodný načítač, který vrací stránky z jiného místního zdroje.

Stručně řečeno:

- **Kolekce stránek**: `pages.json` může definovat úplnou sadu vnořených stránek, výchozí hodnoty, chování typu příspěvku, rozvržení, načítače a metadata kolekce.
- **Stránky Markdown**: `index.md` lze použít jako obsah stránky, buď společně s `page.json`, nebo samostatně s předními metadaty.
- **Rozvržení stránek na frontendu**: `layout.php` mohou obalit synchronizovaný obsah stránek a využívat pomocníky, například `blockstudio_page_tree()` a `blockstudio_page_content()`.
- **Externí zdroje dokumentace**: načítače kolekcí mohou vytvářet stránky z místních souborů nebo vrácených položek Markdown/HTML.
- **Přímý výstup Markdown**: zdroje stránek Markdown lze poskytovat jako `.md` nebo přes `Accept: text/markdown`.
- **Vlastní typy příspěvků kolekce**: kolekce mohou mít čisté URL, automatické obnovení pravidel přepisování, přímé trasy Markdown a migrace stránek na vlastní typ příspěvku bez pomocných úprav motivu.
- **Synchronizace obsahu**: `wp bs content pull`, `wp bs content push` a `wp bs content status` převádějí povolené příspěvky, termíny, vztahy a deklarované odkazy v metadatech projektu do přenositelných souborů.
- **Předpony značek bloků**: projektové předpony, například `<theme-card>`, lze rozpoznávat napříč uspořádanými jmennými prostory bez aliasů pro jednotlivé bloky.
- **Spolehlivější synchronizace**: změny stránek se zjišťují v manifestech, načítačích, rozvrženích, metadatech i zdrojových souborech.
- **Opravy běhového prostředí a editoru**: dynamické možnosti zůstávají aktuální, třídy bloků dotazů se zachovávají při programovém vykreslování, `bsui/select` funguje lépe v hustých formulářích, vlastnosti RichText se předávají editoru a odstranění řádku opakovače s RichText přetrvá i po uložení.

## Stránky založené na souborech

Většina novinek verze 7.4 staví na stránkách založených na souborech.

### Kolekce stránek

Před verzí 7.4 byly stránky založené na souborech převážně funkcí na úrovni složky: vytvořte `page.json`, přidejte `index.php` nebo `index.twig` a Blockstudio synchronizuje tuto jedinou stránku do WordPress.

Tento způsob stále funguje. Verze 7.4 přidává druhý režim pro rozsáhlejší struktury.

Přidejte do složky manifest `pages.json` a složka se změní na kolekci:

```txt
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
```

```json title="pages/docs/pages.json"
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

Všechny zdroje stránek v kolekci se objeví, normalizují, synchronizují a propojí podle cesty. Stránka na adrese `guide/install` se stane podřízenou stránkou `guide`; pokud chybí stránka `guide`, Blockstudio vytvoří generovanou kontejnerovou stránku, aby hierarchie WordPress stále odpovídala struktuře souborového systému.

Kolekce mohou používat nativní typ příspěvku `page` nebo vlastní typ. Pokud kolekce deklaruje typ příspěvku, který zatím neexistuje, Blockstudio jej zaregistruje z `postTypeArgs`. Manifest `postType` se také stává výchozí hodnotou pro všechny stránky v kolekci, takže ji projekty nemusí opakovat v `defaults`.

Typy příspěvků kolekcí používají jako veřejný základ URL slug kolekce. Kolekce `docs` zobrazí svou kořenovou stránku na adrese `/docs/`, stránku s `path: "getting-started"` na adrese `/docs/getting-started/` a vnořené cesty pod stejným základem. Zdvojené URL, například `/docs/docs/`, přesměrují na kanonickou adresu. Pravidla přepisování se při změně směrování typu příspěvku kolekce obnoví automaticky, takže nová kolekce nevyžaduje ruční uložení trvalých odkazů.

Právě díky tomu působí externí dokumentace, produktové příručky, znalostní báze a knihovny stránek v WordPress přirozeně: zdroj zůstává v souborech, ale výsledkem je stále skutečný upravitelný obsah WordPress.

### Markdown jako obsah stránky

Markdown je nyní plnohodnotným zdrojem stránky.

Samostatné stránky Markdown používají přední metadata:

```md title="pages/about/index.md"
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.
```

`page.json` můžete také kombinovat s `index.md`, pokud chcete mít konfiguraci a obsah v oddělených souborech. Přední metadata v `index.md` mohou přepsat odpovídající pole `page.json` a neznámé klíče předních metadat se zachovají jako metadata.

Markdown se převede na HTML a poté se zpracuje stejným parserem stránek jako šablony PHP, Twig a Blade, takže výsledný obsah tvoří nativní značky bloků.

### Rozvržení a pomocné funkce stránek

Kolekce mohou obsahovat soubor `layout.php`. Na frontendu Blockstudio obalí synchronizovaný obsah stránky tímto rozvržením.

```php title="pages/docs/layout.php"
<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>
```

Nové pomocné funkce zpřístupňují kolekci jako strukturovaná data:

```php
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
```

Díky tomu máte vše potřebné k vytvoření kompletního prostředí dokumentace: navigaci odvozenou ze stromu stránek, metadata stránek z předních metadat a synchronizovaný obsah bloků WordPress jako hlavní výstup.

### Načítače a přímé Markdown

Kolekce mohou obsahovat důvěryhodný místní soubor `loader.php`. Ten může přímo vracet stránky nebo nasměrovat Blockstudio na další místní adresáře, ve kterých se mají stránky vyhledat.

```php title="pages/docs/loader.php"
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];
```

To se hodí, když je zdroj už vytvořen jinde: ve složce s dokumentací balíčku, exportu Markdown nebo kroku sestavení, který vrací seznam stránek.

Zdroje stránek Markdown mohou také poskytovat přímý zdroj Markdown. Vyžádejte si stránku s příponou `.md` nebo odešlete `Accept: text/markdown`. Přední metadata se z odpovědi odstraní, takže nástroje získají čitelné tělo dokumentu. Funguje to i pro typy příspěvků kolekcí, včetně URL jako `/docs.md` a `/docs/getting-started.md`.

[Přečtěte si dokumentaci ke stránkám](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/)

## Synchronizace obsahu

Verze 7.4 také přináší synchronizaci obsahu, což je WP-CLI pracovní postup pro týmy, které chtějí mít více částí projektu WordPress uložených v souborech.

```bash
wp bs content pull
wp bs content push --dry-run
wp bs content status
```

Blockstudio už ve vašem projektu spravuje bloky, pole, šablony, vzory a stránky založené na souborech. Content Sync přidává do tohoto pracovního postupu založeného na souborech vybraný obsah z databáze: povolené příspěvky, termíny, vztahy a deklarovaná metadata lze stáhnout do souborů, zkontrolovat v git a odeslat do jiného prostředí.

Je záměrně nastavena výslovně. Zapnete ji v `blockstudio.json`, povolíte typy příspěvků a taxonomie, které chcete spravovat, a určíte odkazy v metadatech, jež se mají mezi prostředími přepisovat.

Při stažení Blockstudio zapíše do souborů v motivu přenositelné příspěvky, termíny, vztahy a povolená metadata. Před odesláním ověří plán a deklarované odkazy `post`, `term` a `attachment` převede zpět na místní ID databáze. Libovolná celá čísla nepovažuje automaticky za ID.

Rozsah verze 7.4 je záměrně konzervativní: příspěvky, termíny, vztahy mezi termíny, povolená metadata, přenositelná UID, manifesty příloh, zkušební běhy, zpracování odebíraných položek, uzamčené entity a hlášení stavu. Zachycení definic taxonomií, kopírování binárních souborů médií a přepisování ID ve značkách bloků jsou v této první verzi záměrně vynechány.

Týmy tak mohou přehledně spravovat ve verzovacím systému vybraný obsah, například členy týmu, případové studie, místa, položky dokumentace nebo jiné strukturované záznamy, aniž by musely migrovat celou produkční databázi. Tento přístup je určen pro sady obsahu, které lze stále kontrolovat jako soubory: desítky či stovky položek, v některých projektech i nižší tisíce, pokud je obsah strukturovaný a mění se zřídka. Nenahrazuje zálohy databáze, synchronizaci elektronického obchodu či objednávek, analytiku, protokoly, odeslané formuláře ani jiná objemná data.

[Přečtěte si dokumentaci k synchronizaci obsahu](https://blockstudio.dev/cs/docs/content-sync/)

### Spolehlivější synchronizace

Blockstudio nyní zjišťuje změny ve zdrojích stránek, manifestech kolekcí, souborech načítačů a rozvržení, metadatech i souvisejících cestách. Pokud se některá z těchto položek změní, synchronizovaná stránka WordPress se aktualizuje.

Řetězec zpracování stránek nyní také řeší podrobnosti, díky kterým jsou dokumenty ze souborů praktické ve skutečných projektech:

- Zdroje stránek Markdown se synchronizují jako nativní obsah bloků včetně atributů bloků.
- Metadata z předních metadat jsou dostupná pomocným funkcím a rozvržením frontendu.
- Stránky kolekcí si při synchronizaci zachovávají stabilní identitu.
- Vnořené stránky mimo kolekci odkazují na svou nadřazenou stránku.
- Vnořené stránky mimo kolekci mohou zdědit nejbližšího předka `layout.php`.
- Odstraněné zdroje kolekce odstraní své generované stránky WordPress.
- Změna kolekce z `page` na vlastní typ příspěvku převede stávající synchronizované příspěvky místo vytváření duplicit.
- Pořadí stránek se ukládá prostřednictvím `menu_order`.

## Předpony značek bloků

Značky bloků nyní podporují nastavitelné předpony jmenných prostorů. Projekt může zaregistrovat jednu krátkou předponu a nechat Blockstudio vyhledat blok v jednom či více jmenných prostorech:

```php
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});
```

Po tomto nastavení může `<theme-card>` odkazovat na `theme-components/card`, `<theme-button>` může přejít na `bsui/button` a `<theme-ui-feature-matrix>` může odkazovat na `theme-components/ui-feature-matrix`.

Výslovné `tag_aliases` mají stále přednost, když projekt potřebuje jednorázové přepsání. Neznámé značky s předponou zůstávají beze změny a na bloky rozpoznané podle předpony se stále vztahují stávající filtry povolených a zakázaných značek bloků.

[Přečtěte si dokumentaci ke značkám bloků](https://blockstudio.dev/cs/docs/blocks/rendering/#prefix-shorthands)

## Opravy běhového prostředí a editoru

Verze 7.4 přináší také sadu oprav vycházejících z používání v reálných projektech.

- Možnosti naplněné dynamickým dotazem zůstávají aktuální při změnách příspěvků, termínů, uživatelů nebo souvisejících metadat a výběrová pole dotazů `populate.fetch: true` načítají při prázdném hledání v editoru aktuální možnosti.
- Programové značky bloků `core/query` a `core/comments` zachovávají `className` ve vygenerovaném obalovém značkování.
- Pseudokomponenty šablon zachovávají vlastnosti camelCase, takže se vlastnosti jako `allowedFormats` a `withoutInteractiveFormatting` dostanou do komponenty editoru místo toho, aby byly předem odstraněny.
- `bsui/select` spolehlivěji zpracovává data možností a nabídky přesahující dostupné místo, zejména v hustších ovládacích prvcích editoru.
- `blockstudio/phpstan` rozpoznává pole deklarovaná uvnitř kontejnerů `tabs`, takže validace šablon, Twig/Blade a značek bloků rozumí stejné podobě polí Blockstudio používané v projektech.
- Odstranění řádku opakovače s RichText přetrvá i po uložení. Zastaralé hodnoty RichText už nemohou odstraněný řádek obnovit.

## Proč na tomto vydání záleží

Tématem verze 7.4 je přenositelnost.

Kolekce stránek promění celé dokumentační weby ve složky se zdrojovými soubory. Stránky Markdown usnadňují psaní obsahu i jeho zpětné načítání. Content Sync rozšiřuje stejný model založený na souborech na vybraný obsah z databáze, takže příspěvky, termíny a vztahy mohou být uloženy v git a přesouvány mezi prostředími. Předpony značek bloků zpřehledňují šablony ve velkých knihovnách bloků.

Blockstudio zůstává založený na souborech. Bloky jsou stále složky. Stránky jsou stále soubory. Verze 7.4 jen umožňuje mít v těchto souborech a přesouvat s nimi další části projektu, jeho struktury stránek a vybraný obsah.
