Zum Inhalt springen

Muster

Muster sind dateibasierte Vorlagen, die als WordPress-Blockmuster registriert werden. Sie erscheinen im Block-Inserter und können von Nutzern überall eingefügt werden.

Anders als Seiten werden Muster im Arbeitsspeicher registriert und erzeugen keine Datenbankeinträge.

pattern.json

Jeder Musterordner benötigt eine pattern.json-Konfigurationsdatei:

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

Eigenschaften

Eigenschaft Typ Standard Beschreibung
name string erforderlich Eindeutiger Bezeichner (mit Präfix blockstudio/)
title string erforderlich Anzeigetitel im Block-Inserter
description string "" Beschreibung im Inserter
categories string[] [] Musterkategorien (e.g., featured, header, footer)
keywords string[] [] Suchbegriffe für den Inserter
viewportWidth number – Vorschau-Breite in Pixeln
blockTypes string[] [] Zugehörige Blocktypen
postTypes string[] [] Auf bestimmte Beitragstypen beschränken
inserter boolean true Gibt an, ob das Muster im Inserter angezeigt wird

Beispiel

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>

Benutzerdefinierte Pfade

Standardmäßig durchsucht Blockstudio get_template_directory() . '/patterns'. Mit diesem Filter kannst du weitere Pfade hinzufügen:

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

Laufzeitintegrationen, die Dateien aus mehreren Stammverzeichnissen zusammensetzen, können den Dateisystem-Scan durch eine logische Erkennungsquelle ersetzen. Manifeste und Quellvorlagen für Muster werden anhand des endgültigen sichtbaren logischen Bestands aufgelöst.

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

Vergleich mit Seiten

Aspekt Seiten Muster
Speicherung Als Beiträge mit der Datenbank synchronisiert Im Arbeitsspeicher registriert
Konfiguration page.json pattern.json
Synchronisierung Explizit, mit wp bs pages sync Keine Synchronisierung erforderlich
Vorlagensperre Ja Nein
Anwendungsfall Vordefinierte Seiteninhalte Wiederverwendbare Blockvorlagen