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 |