Lewati ke konten

Pola

Pola adalah templat berbasis berkas yang didaftarkan sebagai pola blok WordPress. Pola muncul di penyisip blok dan dapat ditempatkan di mana saja oleh pengguna.

Berbeda dengan halaman, pola didaftarkan di memori dan tidak membuat entri basis data.

pattern.json

Setiap folder pola memerlukan berkas konfigurasi pattern.json:

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "description": "A hero section with heading and CTA",
  "categories": ["featured", "header"],
  "keywords": ["hero", "banner", "cta"]
}

Properti

Properti Jenis Default Deskripsi
name string wajib Pengenal unik (diawali dengan blockstudio/)
title string wajib Judul yang ditampilkan di penyisip blok
description string "" Deskripsi yang ditampilkan di penyisip blok
categories string[] [] Kategori pola (e.g., featured, header, footer)
keywords string[] [] Kata kunci pencarian untuk penyisip blok
viewportWidth number – Lebar pratinjau dalam piksel
blockTypes string[] [] Jenis blok terkait
postTypes string[] [] Batasi pada jenis pos tertentu
inserter boolean true Apakah ditampilkan di penyisip blok

Contoh

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>

Jalur Kustom

Secara default, Blockstudio memindai get_template_directory() . '/patterns'. Tambahkan jalur tambahan dengan filter:

PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/custom-patterns';
    $paths[] = MY_PLUGIN_PATH . '/patterns';
    return $paths;
} );

Integrasi runtime yang menggabungkan berkas dari beberapa akar dapat mengganti pemindaian sistem berkas dengan sumber penemuan logis. Manifest pola dan templat sumber ditentukan dari inventaris logis akhir yang terlihat.

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();

Perbandingan dengan Halaman

Aspek Halaman Pola
Penyimpanan Disinkronkan ke basis data sebagai pos Didaftarkan di memori
Konfigurasi page.json pattern.json
Sinkronisasi Eksplisit, dengan wp bs pages sync Tidak perlu sinkronisasi
Penguncian templat Ya Tidak
Kasus penggunaan Konten halaman yang telah ditentukan Templat blok yang dapat digunakan kembali