Перейти до вмісту

Шаблони блоків

Шаблони блоків — це шаблони на основі файлів, зареєстровані як шаблони блоків 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 Синхронізація не потрібна
Блокування шаблону Так Ні
Сценарій використання Наперед визначений вміст сторінки Багаторазово використовувані шаблони блоків