Перейти к содержимому

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

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

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

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

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

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. Там же настройте видимость в панели вставки.

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

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.

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

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() для нужных элементов.

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