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 |