İçeriğe geç

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ı