# Цели страници, дефинирани в код

Шаблони и Markdown, синхронизирани с WordPress с една команда.

## Колекции от файлове

Дефинирайте `pages.json` и оставете Blockstudio да открие всеки изходен файл под него. Вложените пътища стават вложени страници, колекцията получава зададените стойности по подразбиране, а липсващите родителски страници могат да бъдат генерирани.

Използвайте колекции за документация, бази от знания или целеви страници, а външни папки добавяйте под префикс на пътя с `loader.php`.

Поставете `layout.php` или оформление за визуализатора, например `layout.tsx`, до `pages.json`, за да обгърнете всяка страница от колекцията в обща обвивка, със `blockstudio_page_tree()` за страничната лента.

[Колекции от страници](https://blockstudio.dev/bg/docs/pages-and-patterns/pages/#page-collections)

pages/docs/pages.json

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

## Изрична синхронизация

wp bs pages sync прилага промените; непроменените страници не изискват никакви записи.

## Източници Markdown

Използвайте index.md с frontmatter или съчетайте page.json със съдържание Markdown.

## Суров Markdown

Markdown файловите страници отговарят на адреса си с добавено .md или на обичайния URL при Accept: text/markdown, с канонична връзка обратно към HTML чрез URL.

## Зареждащи модули за колекции

Добавяйте външни папки с документация към колекция под префикс на пътя.

## Колекции от сайтове

pages.json с обхват site прилага общи настройки по подразбиране към цялото дърво от страници и го изброява, без да променя URL адресите или редовете на публикациите.

## Помощни функции за навигация

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() и blockstudio_page_content() изграждат страничните ленти, навигацията между страниците и основното съдържание.

## Колекции и типове публикации

Колекциите могат да регистрират специални йерархични типове публикации.

## Заключване на шаблона

Заключвайте страници или отделни блокове с contentOnly, all или insert.

## Пишете HTML, получавате блокове

Стандартни елементи като `<h1>`, `<p>` и `<ul>` се преобразуват в основни блокове. Използвайте `<block>` за всяко друго име на блок и ниво на влагане.

Blockstudio анализира цели оформления на страници и ги преобразува в истински редактируеми блокове WordPress.

[Справочник за синтаксиса на страниците](https://blockstudio.dev/bg/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>
```

## Страници, визуализирани от компоненти

Задайте `render` в `page.json` като запис, например `page.tsx`, и loader `data.php`; тогава визуализаторът на страници, регистриран от темата или плъгина ви, изобразява цялата страница. Синхронизацията съхранява един блок `blockstudio/page`, а съдържание WordPress, например shortcode, остава в своя слот.

Ресурсите, върнати от визуализатора, преминават през същата обработка като ресурсите на блоковете и се отпечатват само веднъж, така че предварително визуализираната страница ги съдържа. Самата blockstudio.dev е изградена от страници на компоненти.

[Страници на компоненти](https://blockstudio.dev/bg/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" }
}
```

## Маршрути без публикация

`Blockstudio\Virtual_Routes::register()` предоставя документ, зад който няма публикация, например справочник за компоненти или каталог. С `prefix` и `match` една регистрация обслужва цяла група URL адреси, а връщането на `null` оставя URL на WordPress.

Маршрутът се изобразява в изходния буфер на Blockstudio, така че блоковете му получават ресурсите си и изхода на Tailwind. Пътищата в `urls` се включват в компилациите за статично предварително визуализиране, а `Virtual_Routes::urls()` ги връща за карта на сайта.

[Виртуални маршрути](https://blockstudio.dev/bg/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(),
        ]
    );
} );
```

## Синхронизирайте само когато поискате

Файловете на страниците променят WordPress само когато поискате. `wp bs pages sync` прилага всички променени източници, запазва съдържанието в блокове с ключове и премахва страниците, чиито файлове липсват.

Отпечатъците обхващат манифести, зареждащи модули, оформления и източници, така че непроменените страници не изискват никакви записи. При внедряване се извиква `Pages::reconcile()` и се получава машинночетим отчет.

[Поведение при синхронизация](https://blockstudio.dev/bg/docs/pages-and-patterns/pages/#sync-behavior)

Терминал

```
# 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
```

## Блоковете с ключове запазват съдържанието

Добавете `key` към всеки блок. При следващата синхронизация блоковете с ключове обединяват атрибутите на шаблона със съществуващото потребителско съдържание, а блоковете без ключове се заменят.

Променяйте структурата между внедряванията, като запазвате съдържанието на клиентите.

[Блокове с ключове](https://blockstudio.dev/bg/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>
```

## Заключване на шаблони и режими на редактиране

`"all"` предотвратява промените, `"contentOnly"` заключва структурата, като позволява редактиране на текста, а `"insert"` позволява редактиране и пренареждане без добавяне или премахване на елементи.

Заменете всеки елемент с `blockEditingMode`, за да разрешите избирателно редактиране на заключена страница или да деактивирате отделен блок.

[Заключване на шаблона](https://blockstudio.dev/bg/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>
```

## Шаблони на Site Editor от файлове

Добавете `template.json` и шаблон към `templates/` или `part.json` към `parts/`, за да получи блоковата ви тема източници за `wp_template` и `wp_template_part`, базирани на файлове.

Те използват същия синтаксис като страниците. Персонализация в Site Editor продължава да има предимство, докато някой не я нулира; тогава отново се използва източникът от файла.

[Шаблони на сайта](https://blockstudio.dev/bg/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" />
```

## Избрано съдържание от базата данни в git

`wp bs content pull` експортира публикации, термини, връзки и декларирани метаданни от разрешения списък в преносими файлове, а `push` ги прилага в друга среда. Декларираните препратки, родители и връзки към термини се пренасят като стабилни UID.

Публикациите, управлявани чрез синхронизиране на страници, могат да се обединят с `includePageSyncManaged`. Файловете им съдържат `"bodyOwner": "page-sync"`, така че Content Sync прехвърля метаданните, докато синхронизирането на страници запазва основното съдържание.

[Синхронизиране на съдържание](https://blockstudio.dev/bg/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"
  }
}
```

## Блокове с ключове

Запазвайте потребителското съдържание, докато шаблоните се развиват.

## Режими на редактиране

Задавайте стойности по подразбиране за страници и ги замествайте за отделни елементи.

## Свързване на блокове

Свързвайте блокове с метаданните на публикация, за да се запази съдържанието при синхронизация.

## Шаблони за типове публикации

templateFor задава началната структура от блокове за всяка нова публикация от даден тип.

## Фиксирани ID на публикации

postId възстановява същото ID, когато дадена страница бъде изтрита и синхронизирана отново, така че менютата и връзките да продължат да работят.

## Начални шаблони и заключвания

sync: false със Pages::force_sync() създава страница еднократно, която редакторите да управляват. Pages::lock() и unlock() изключват отделна страница от синхронизирането.

## Персонализирани визуализатори на парсера

Филтрите за конструктор и визуализатор преобразуват таг на блок в масив от блокове на външен блок или променят начина, по който се записва основен блок.

## Съотнасяне на елементи

Съотнесете елемент HTML към друг блок, изберете блока според атрибутите на елемента и насочете абзацния HTML към поле за съдържание.

## Персонализирани пътища за откриване

Филтрите добавят коренови директории за страници, шаблони и шаблони на Site Editor, например от плъгин.

## Логически източници за откриване

Предварителните прегледи, наслагванията и генерираните теми могат да предоставят на Blockstudio съставен списък с файлове вместо една папка на тема.

## Стабилни препратки

Декларираните препратки към публикации, термини и прикачени файлове се преобразуват в преносими UID при изтегляне и се разрешават до локални ID при изпращане.

## Състояние преди изпращане

wp bs content status отчита всяка единица като непроменена, ще бъде актуализирана, липсваща в базата данни, в конфликт, заключена или осиротяла и предупреждава за мета ключове, които изглеждат като тайни.

## Проверени изпращания с ограничен обхват

Push проверява целия план преди запис и пропуска заключените единици. –dry-run показва плана, а –prune –yes премахва само единиците от този набор съдържание.

## С контрол на версиите

Проследявайте файловете на страниците в Git и ги внедрявайте в различни среди.

## PHP API

Достъпвайте програмно дървета, дъщерни елементи, метаданни, синхронизация, заключване и ID.

Plus

## Официалният комплект за разширения

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

- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord

[Вземете Plus](https://blockstudio.dev/bg/plus/)
