# Повторно используемые паттерны из файлов шаблонов

Тот же HTML, что и у страниц, — прямо в панели вставки.

## Файлы шаблонов вместо кода регистрации

Создайте папку с `pattern.json` и шаблоном. Blockstudio зарегистрирует ее без шаблонного кода `register_block_pattern()`.

Паттерны вставляются как настоящие редактируемые блоки: пользователи получают настраиваемый исходный макет, а исходный файл остается под контролем версий.

[Синтаксис паттернов](https://blockstudio.dev/ru/docs/pages-and-patterns/patterns/)

index.php

```
<div>
  <h2>Pricing</h2>
  <p>Simple, transparent pricing.</p>
  <block name="core/columns">
    <block name="core/column"><h3>Starter</h3></block>
    <block name="core/column"><h3>Pro</h3></block>
  </block>
</div>
```

## Тот же синтаксис, что и у страниц

Стандартные HTML сопоставляются с базовыми блоками; тег блока обрабатывает всё остальное.

## Автоматическая регистрация

Добавьте шаблон и pattern.json — и он появится автоматически.

## Полностью редактируемые

Пользователи настраивают каждый вставленный паттерн независимо.

## С категориями и поиском

Категории и ключевые слова помогают находить паттерны.

## Любые блоки и уровни вложенности

Используйте основные, пользовательские или блоки Blockstudio на любой глубине вложенности.

## Ограничения по типам записей

Ограничивайте использование паттернов типами записей, для которых они предназначены.

## Связи блоков

Связывайте паттерны с типами блоков, чтобы они появлялись в качестве подсказок.

## Под контролем версий

Отслеживайте файлы паттернов в Git и развертывайте их в разных средах.

## Настройте с помощью pattern.json

Задайте заголовок, описание, категории, ключевые слова, ширину области просмотра, типы записей и блоков в `pattern.json`. Там же настройте видимость в панели вставки.

Категории упорядочивают паттерны, ключевые слова помогают их находить, а ширина области просмотра задает размер предварительного просмотра.

[Настройка паттернов](https://blockstudio.dev/ru/docs/pages-and-patterns/patterns/)

pattern.json

```
{
  "name": "pricing-table",
  "title": "Pricing Table",
  "description": "Two-column pricing layout",
  "categories": ["featured", "commerce"],
  "keywords": ["pricing", "plans", "table"],
  "viewportWidth": 1200,
  "blockTypes": ["core/group"],
  "postTypes": ["page", "landing"]
}
```

## Источники Blade и Twig

Запишите паттерн, страницу или шаблон редактора сайта как `index.blade.php` или `index.twig` вместо `index.php`. Blade рендерится через `Blockstudio\Blade_Renderer` с `illuminate/view` от 8 до 12, а для Twig требуется Timber.

Исходники компилируются без контекста запроса, поэтому динамические переменные в них недоступны. Используйте их для встроенных функций и фильтров движка.

[Движки шаблонов](https://blockstudio.dev/ru/docs/pages-and-patterns/#template-engines)

patterns/pricing/index.blade.php

```
<div>
  <h2>{{ strtoupper('Pricing') }}</h2>
  <p>Simple, transparent pricing.</p>
</div>
```

## Пользовательские шаблоны на выбор редактора

`template.json`, чей slug не входит в иерархию шаблонов, становится пользовательским шаблоном. Перечислите типы записей в `postTypes`, и редакторы смогут выбрать его в селекторе шаблонов.

`Blockstudio\Site_Templates` читает и компилирует исходники из PHP, поэтому тесты и проверки перед развёртыванием могут просматривать скомпилированную разметку и вызывать `selection_errors()` для нужных элементов.

[Руководство по шаблонам редактора сайта](https://blockstudio.dev/ru/guides/site-editor-templates/)

templates/page-landing/template.json

```
{
  "slug": "page-landing",
  "title": "Landing Page",
  "description": "Full-width page without a header",
  "postTypes": ["page"]
}
```

## Пользовательские пути поиска

Фильтры добавляют корневые каталоги для страниц, паттернов и шаблонов редактора сайта, например из плагина.

## Логические источники для поиска

Предварительные просмотры, наложения и сгенерированные темы могут передать Blockstudio составной перечень файлов вместо одной папки темы.

## Хуки жизненного цикла

Действия срабатывают после регистрации паттернов, а также после создания, обновления, синхронизации или согласования записи страницы.

## API паттерна

Blockstudio\Patterns::patterns() и get_pattern() читают зарегистрированные паттерны из PHP.

Plus

## Официальный набор расширений

Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.

- 500+ шаблонов сайтов
- Системные инструкции для ИИ
- Пожизненные обновления
- Закрытое сообщество Discord

[Получить Plus](https://blockstudio.dev/ru/plus/)
