Шаблони блоків
Шаблони блоків — це шаблони на основі файлів, зареєстровані як шаблони блоків WordPress. Вони з’являються у вставнику блоків, і користувачі можуть розміщувати їх будь-де.
На відміну від сторінок, шаблони блоків реєструються в пам’яті й не створюють записів у базі даних.
pattern.json
У кожній теці шаблону блоків потрібен файл конфігурації pattern.json:
JSON
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Властивості
| Властивість | Тип | За замовчуванням | Опис |
|---|---|---|---|
name |
string |
обов’язково | Унікальний ідентифікатор (із префіксом blockstudio/) |
title |
string |
обов’язково | Назва у вставнику блоків |
description |
string |
"" |
Опис, який відображається у вставнику |
categories |
string[] |
[] |
Категорії шаблонів блоків (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Пошукові ключові слова для вставника |
viewportWidth |
number |
– | Ширина попереднього перегляду в пікселях |
blockTypes |
string[] |
[] |
Пов’язані типи блоків |
postTypes |
string[] |
[] |
Обмеження для певних типів записів |
inserter |
boolean |
true |
Чи показувати у вставнику |
Приклад
pattern.json:
JSON
{
"name": "hero-with-cta",
"title": "Hero with CTA",
"description": "A full-width hero section with heading and call-to-action buttons",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta", "landing"],
"viewportWidth": 1200
}
index.php:
HTML
<block name="core/cover" url="https://example.com/hero-bg.jpg" dimRatio="60">
<h1>Build Something Amazing</h1>
<p>Create beautiful websites with the power of blocks.</p>
<block name="core/buttons">
<block name="core/button" url="/get-started">Get Started</block>
<block name="core/button" url="/learn-more" className="is-style-outline">Learn More</block>
</block>
</block>
Власні шляхи
За замовчуванням Blockstudio сканує get_template_directory() . '/patterns'. Додайте інші шляхи за допомогою фільтра:
PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Інтеграції середовища виконання, що об’єднують файли з кількох кореневих каталогів, можуть замінити сканування файлової системи на логічне джерело виявлення. Маніфести шаблонів блоків і вихідні шаблони визначаються за кінцевим видимим логічним переліком.
PHP API
PHP
// Get all registered patterns
$patterns = Blockstudio\Patterns::patterns();
// Get a specific pattern
$pattern = Blockstudio\Patterns::get_pattern('hero-section');
// Get registered paths
$paths = Blockstudio\Patterns::get_registered_paths();
Порівняння зі сторінками
| Аспект | Сторінки | Шаблони блоків |
|---|---|---|
| Зберігання | Синхронізуються з базою даних як записи | Реєструються в пам’яті |
| Конфігурація | page.json |
pattern.json |
| Синхронізація | Явна, з wp bs pages sync |
Синхронізація не потрібна |
| Блокування шаблону | Так | Ні |
| Сценарій використання | Наперед визначений вміст сторінки | Багаторазово використовувані шаблони блоків |