# Celé stránky definované v kódu

Šablony a Markdown synchronizované s WordPress jediným příkazem.

## Kolekce ze souborů

Definujte `pages.json` a nechte Blockstudio najít všechny zdroje pod ním. Vnořené cesty se změní na vnořené stránky, pro kolekci se použijí výchozí hodnoty a chybějící nadřazené stránky lze vytvořit.

Kolekce se hodí pro dokumentaci, znalostní báze nebo vstupní stránky. Pomocí `loader.php` můžete také připojit externí složky pod předponou cesty.

Vedle `pages.json` umístěte `layout.php` nebo rozvržení rendereru, například `layout.tsx`, aby obalovalo každou stránku kolekce do jednoho shellu; pro postranní panel použijte `blockstudio_page_tree()`.

[Kolekce stránek](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/#page-collections)

pages/docs/pages.json

```
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

## Výslovná synchronizace

Příkaz wp bs pages sync použije změny; nezměněné stránky nevyžadují žádné zápisy.

## Zdroje Markdown

Použijte index.md s úvodními metadaty nebo spojte obsah page.json s Markdown.

## Surové Markdown

Stránky ze souborů Markdown jsou dostupné na svém URL plus .md nebo na běžném URL pro Accept: text/markdown, s kanonickým odkazem zpět na HTML.

## Načítače kolekcí

Připojte složky s externí dokumentací ke kolekci pod předponou cesty.

## Kolekce webu

pages.json s rozsahem site nastavuje sdílené výchozí hodnoty pro celý strom stránek a vypisuje jej, aniž mění URL nebo řádky příspěvků.

## Pomocníci navigace

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() a blockstudio_page_content() vytvářejí postranní panely, stránkování a tělo.

## Kolekce a typy příspěvků

Kolekce mohou registrovat vlastní hierarchické typy příspěvků.

## Uzamčení šablony

Zamkněte stránky nebo jednotlivé bloky pomocí contentOnly, all nebo insert.

## Napište HTML, získejte bloky

Standardní prvky jako `<h1>`, `<p>` a `<ul>` se mapují na základní bloky. Pro všechny ostatní názvy bloků a úrovně vnoření použijte `<block>`.

Blockstudio převádí kompletní rozvržení stránek na skutečné upravitelné bloky WordPress.

[Přehled syntaxe stránek](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/)

index.php

```
<div>
  <h1 blockEditingMode="contentOnly">About Us</h1>
  <p>We build tools for WordPress developers.</p>
  <img src="/team.jpg" alt="Our team" />
</div>

<block name="core/columns">
  <block name="core/column"><h2>Our Mission</h2></block>
  <block name="core/column"><h2>Our Stack</h2></block>
</block>
```

## Stránky vykreslované komponentami

Nastavte `render` v `page.json` na položku, například `page.tsx`, a loader `data.php`; renderer stránky zaregistrovaný vaší šablonou nebo pluginem pak vykreslí celou stránku. Sync ukládá jeden blok `blockstudio/page` a obsah WordPress, například shortcode, zůstává ve svém slotu.

Prostředky vrácené rendererem se zpracují stejně jako prostředky bloků a vytisknou se jen jednou, takže předem vykreslená stránka je obsahuje. Samotné blockstudio.dev se sestavuje z komponentových stránek.

[Komponentové stránky](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/#component-pages)

pages/legal-notice/page.json

```
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}
```

## Trasy bez příspěvku

`Blockstudio\Virtual_Routes::register()` poskytuje dokument, za kterým nestojí žádný příspěvek, například referenci komponenty nebo katalog. Pomocí `prefix` a `match` obslouží jedna registrace celou skupinu URL a vrácením `null` se URL přenechá WordPress.

Trasa se vykreslí do výstupní vyrovnávací paměti Blockstudio, takže její bloky získají své prostředky a výstup Tailwind. Cesty v `urls` se přidají k sestavením statického předvykreslení a `Virtual_Routes::urls()` je vrátí pro mapu webu.

[Virtuální trasy](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/#virtual-routes)

functions.php

```
add_action( 'init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function ( $component, string $rest ) {
            get_header();
            echo my_component_page( $component );
            get_footer();
        },
        [
            'prefix' => true,
            'match'  => fn ( string $rest ) => '' === $rest ? 'index' : my_component( $rest ),
            'title'  => fn ( $component ) => my_component_title( $component ),
            'urls'   => fn () => my_component_paths(),
        ]
    );
} );
```

## Synchronizace jen na vyžádání

Soubory stránek mění WordPress jen na vaše přání. `wp bs pages sync` použije všechny změněné zdroje, zachová obsah bloků s klíčem a odstraní stránky, jejichž soubory už neexistují.

Otisky zahrnují manifesty, načítače, rozvržení i zdroje, takže nezměněné stránky nevyžadují žádné zápisy. Při nasazení se zavolá `Pages::reconcile()` a vrátí strojově čitelnou zprávu.

[Chování synchronizace](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/#sync-behavior)

Terminál

```
# Apply changed sources, keep keyed edits
wp bs pages sync

# Replace managed content from the files
wp bs pages sync --authoritative

# Compare every page and report as JSON
wp bs pages sync --full --format=json
```

## Bloky s klíčem zachovávají obsah

Přidejte `key` do libovolného bloku. Při další synchronizaci se u bloků s klíčem sloučí atributy šablony s existujícím uživatelským obsahem, zatímco bloky bez klíče se nahradí.

Měňte strukturu při nasazování nových verzí, zatímco obsah klientů zůstane zachován.

[Bloky s klíči](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/#keyed-block-merging)

index.php

```
<h1 key="title">About Us</h1>
<block name="core/cover" key="hero" url="/hero.jpg">
  <h2>Welcome to our company</h2>
  <p>Edit this content freely.</p>
</block>
<block name="core/columns" key="team">
  <block name="core/column"><h3>Our Team</h3></block>
</block>
```

## Zamykání šablon a režimy úprav

`"all"` brání změnám, `"contentOnly"` zamyká strukturu a umožňuje upravovat text a `"insert"` umožňuje úpravy a změnu pořadí bez přidávání nebo odebírání.

Pomocí `blockEditingMode` přepište libovolný prvek a umožněte vybrané úpravy zamčené stránky nebo zakažte jednotlivý blok.

[Uzamčení šablony](https://blockstudio.dev/cs/docs/pages-and-patterns/pages/#template-lock)

index.php

```
<h1>Welcome to Our Product</h1>
<p>The best solution for your needs.</p>
<block name="core/cover" blockEditingMode="disabled" url="/static-banner.jpg">
  <p>Promotional banner</p>
</block>
<block name="core/group" blockEditingMode="default">
  <h2>Customizable Section</h2>
</block>
```

## Šablony editoru webu ze souborů

Přidejte `template.json` a šablonu do `templates/` nebo `part.json` do `parts/` a vaše blokové téma získá zdroje `wp_template` a `wp_template_part` uložené v souborech.

Používají stejnou syntaxi jako stránky. Přizpůsobení v editoru webu má stále přednost, dokud ho někdo neobnoví; pak se znovu použije zdroj ze souboru.

[Šablony webu](https://blockstudio.dev/cs/docs/pages-and-patterns/site-templates/)

templates/front-page/index.php

```
<block name="core/template-part" slug="header" />

<div>
  <h1>Welcome</h1>
  <block name="core/post-content" />
</div>

<block name="core/template-part" slug="footer" />
```

## Vybraný obsah databáze v git

`wp bs content pull` exportuje povolené příspěvky, termíny, vztahy a deklarovaná metadata do přenositelných souborů a `push` je použije v jiném prostředí. Deklarované reference, nadřazené položky a vztahy termínů se přenášejí jako stabilní UID.

Příspěvky spravované synchronizací stránek lze propojit s `includePageSyncManaged`. Jejich soubory obsahují `"bodyOwner": "page-sync"`, takže Content Sync přenáší metadata, zatímco synchronizace stránek ponechává tělo.

[Synchronizace obsahu](https://blockstudio.dev/cs/docs/content-sync/)

blockstudio.json

```
{
  "content": {
    "enabled": true,
    "id": "default",
    "path": "content",
    "postTypes": ["team_member"],
    "taxonomies": ["category"],
    "meta": {
      "include": ["_my_*"],
      "references": {
        "_thumbnail_id": { "kind": "attachment" },
        "_related_posts": { "kind": "post", "path": "*" }
      }
    },
    "media": "manifest"
  }
}
```

## Bloky s klíči

Zachovejte uživatelský obsah při změnách šablon.

## Režimy úprav

Nastavte výchozí hodnoty stránky a přepište jednotlivé prvky.

## Vazby bloků

Propojte bloky s metadaty příspěvků, aby obsah přežil synchronizaci.

## Šablony typů příspěvků

templateFor nastaví stránku jako výchozí strukturu bloků pro každý nový příspěvek daného typu.

## Připnutá ID příspěvků

postId při opětovné synchronizaci znovu přidělí stejné ID, i když byla stránka smazána, takže nabídky a odkazy dál fungují.

## Kostra a zámky

sync: false spolu s Pages::force_sync() vytvoří stránku jednou, aby ji spravovali editoři. Pages::lock() a unlock() zabrání synchronizaci jediné stránky.

## Vlastní renderery parseru

Filtry builderu a rendereru převedou značku bloku na pole bloků bloku třetí strany nebo změní způsob zápisu základního bloku.

## Mapování prvků

Namapujte prvek HTML na jiný blok, vyberte blok podle atributů prvku a přesměrujte HTML odstavce do pole obsahu.

## Vlastní cesty pro vyhledávání

Filtry přidávají kořenové cesty pro stránky, vzory a šablony Site Editoru, například z pluginu.

## Logické zdroje pro vyhledávání

Náhledy, překryvy a generované šablony mohou předat Blockstudio složený seznam souborů místo jediné složky šablony.

## Stabilní odkazy

Deklarované odkazy na příspěvky, termíny a přílohy se při stažení změní na přenositelné UID a při odeslání se převedou na místní ID.

## Stav před odesláním

wp bs content status hlásí stav každé entity jako unchanged, would-update, missing-db, conflict, locked nebo orphaned a upozorňuje na meta klíče, které vypadají jako tajné údaje.

## Ověřená odeslání s vymezeným rozsahem

Příkaz push ověří celý plán ještě před zápisem a přeskočí zamčené entity. –dry-run zobrazí plán a –prune –yes odstraní pouze entity této sady obsahu.

## Správa verzí

Sledujte soubory stránek v Git a nasazujte je napříč prostředími.

## PHP API

Programově přistupujte ke stromům, potomkům, metadatům, synchronizaci, zamykání a ID.

Plus

## Oficiální sada rozšíření

Prémiové šablony webů, systémové pokyny pro umělou inteligenci a soukromá komunita Discord. Jednorázový nákup, doživotní aktualizace.

- 500+ šablon webů
- Systémové instrukce AI
- Doživotní aktualizace
- Soukromá komunita Discord

[Získat Plus](https://blockstudio.dev/cs/plus/)
