Vai al contenuto

Pattern

I pattern sono template basati su file, registrati come pattern di blocchi WordPress. Compaiono nell’inseritore di blocchi e gli utenti possono inserirli ovunque.

A differenza delle pagine, i pattern vengono registrati in memoria e non creano voci nel database.

pattern.json

Ogni cartella di pattern richiede un file di configurazione pattern.json:

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

Proprietà

Proprietà Tipo Predefinito Descrizione
name string obbligatorio Identificatore univoco (con prefisso blockstudio/)
title string obbligatorio Titolo visualizzato nell’inseritore di blocchi
description string "" Descrizione visualizzata nell’inseritore
categories string[] [] Categorie del pattern (e.g, featured, header, footer)
keywords string[] [] Parole chiave di ricerca per l’inseritore
viewportWidth number – Larghezza dell’anteprima in pixel
blockTypes string[] [] Tipi di blocchi associati
postTypes string[] [] Limita a tipi di post specifici
inserter boolean true Indica se visualizzare nell’inseritore

Esempio

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>

Percorsi personalizzati

Per impostazione predefinita, Blockstudio esegue la scansione di get_template_directory() . '/patterns'. Aggiungete altri percorsi con il filtro:

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

Le integrazioni runtime che compongono file da più radici possono sostituire la scansione del file system con una fonte di rilevamento logico. I manifest dei pattern e i template sorgente vengono risolti a partire dall’inventario logico definitivo.

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

Confronto con le pagine

Aspetto Pagine Pattern
Archiviazione Sincronizzati nel database come post Registrati in memoria
Configurazione page.json pattern.json
Sincronizzazione Esplicita, con wp bs pages sync Non è necessaria
Blocco del template Sì No
Caso d’uso Contenuti di pagine predefiniti Template di blocchi riutilizzabili