Ga naar de inhoud

Patronen

Patronen zijn templates op basis van bestanden die als WordPress blokpatronen worden geregistreerd. Ze verschijnen in de blokinvoeger en gebruikers kunnen ze overal plaatsen.

Anders dan bij pagina’s worden patronen in het geheugen geregistreerd en maken ze geen database-items aan.

pattern.json

Elke patroonmap heeft een pattern.json-configuratiebestand nodig:

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

Eigenschappen

Eigenschap Type Standaard Beschrijving
name string vereist Unieke identificatie (met voorvoegsel blockstudio/)
title string vereist Weergavetitel in de blokinvoeger
description string "" Beschrijving die in de invoeger wordt getoond
categories string[] [] Patrooncategorieën (e.g., featured, header, footer)
keywords string[] [] Zoektermen voor de invoeger
viewportWidth number – Voorbeeldbreedte in pixels
blockTypes string[] [] Bijbehorende bloktypen
postTypes string[] [] Beperken tot specifieke berichttypen
inserter boolean true Tonen in de invoeger

Voorbeeld

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>

Aangepaste paden

Standaard scant Blockstudio get_template_directory() . '/patterns'. Voeg extra paden toe met het filter:

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

Runtime-integraties die bestanden uit meerdere hoofdmappen samenstellen, kunnen de bestandssysteemscan vervangen door een logische ontdekkingsbron. Patroonmanifesten en bronbestanden van templates worden gevonden in de uiteindelijke zichtbare logische inventaris.

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

Vergelijking met pagina’s

Aspect Pagina’s Patronen
Opslag Gesynchroniseerd naar database als berichten In het geheugen geregistreerd
Configuratie page.json pattern.json
Synchronisatie Expliciet, met wp bs pages sync Synchronisatie niet nodig
Template vergrendelen Ja Nee
Gebruik Vooraf gedefinieerde pagina-inhoud Herbruikbare bloktemplates