Desenler
Desenler, WordPress blok desenleri olarak kaydedilen dosya tabanlı şablonlardır. Blok ekleyicide görünürler ve kullanıcılar tarafından istedikleri yere yerleştirilebilirler.
sayfalardan farklı olarak desenler belleğe kaydedilir ve veritabanı girdisi oluşturmaz.
pattern.json
Her desen klasöründe bir pattern.json yapılandırma dosyası bulunmalıdır:
JSON
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Özellikler
| Özellik | Tür | Varsayılan | Açıklama |
|---|---|---|---|
name |
string |
gerekli | blockstudio/ önekiyle başlayan benzersiz tanımlayıcı |
title |
string |
gerekli | Blok ekleyicide görünen başlık |
description |
string |
"" |
Ekleyicide gösterilen açıklama |
categories |
string[] |
[] |
Desen kategorileri (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Ekleyici için arama anahtar sözcükleri |
viewportWidth |
number |
– | Piksel cinsinden önizleme genişliği |
blockTypes |
string[] |
[] |
İlişkili blok türleri |
postTypes |
string[] |
[] |
Belirli yazı türleriyle sınırla |
inserter |
boolean |
true |
Ekleyicide gösterilip gösterilmeyeceği |
Örnek
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>
Özel Yollar
Varsayılan olarak Blockstudio, get_template_directory() . '/patterns' dizinini tarar. Filtreyle ek yollar ekleyin:
PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Birden çok kökten dosya oluşturan çalışma zamanı entegrasyonları, dosya sistemi taramasını mantıksal keşif kaynağı ile değiştirebilir. Desen manifestleri ve kaynak şablonları, son görünür mantıksal envanterden çözümlenir.
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();
Sayfalarla Karşılaştırma
| Özellik | Sayfalar | Desenler |
|---|---|---|
| Depolama | Veritabanına yazı olarak eşitlenir | Belleğe kaydedilir |
| Yapılandırma | page.json |
pattern.json |
| Eşitleme | Açıkça, wp bs pages sync ile |
Eşitleme gerekmez |
| Şablon kilidi | Evet | Hayır |
| Kullanım alanı | Önceden tanımlanmış sayfa içeriği | Yeniden kullanılabilir blok şablonları |