Modele
Modelele sunt șabloane bazate pe fișiere, înregistrate ca modele de blocuri WordPress. Acestea apar în inseratorul de blocuri și pot fi plasate oriunde de către utilizatori.
Spre deosebire de pagini, modelele sunt înregistrate în memorie și nu creează intrări în baza de date.
pattern.json
Fiecare dosar de model necesită un fișier de configurare 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ăți
| Proprietate | Tip | Valoare implicită | Descriere |
|---|---|---|---|
name |
string |
obligatoriu | Identificator unic (cu prefixul blockstudio/) |
title |
string |
obligatoriu | Titlul afișat în inseratorul de blocuri |
description |
string |
"" |
Descriere afișată în inserator |
categories |
string[] |
[] |
Categorii de modele (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Cuvinte-cheie pentru căutarea în inserator |
viewportWidth |
number |
– | Lățime de previzualizare în pixeli |
blockTypes |
string[] |
[] |
Tipuri de blocuri asociate |
postTypes |
string[] |
[] |
Restricționează la anumite tipuri de articole |
inserter |
boolean |
true |
Dacă se afișează în inserator |
Exemplu
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>
Căi personalizate
În mod implicit, Blockstudio scanează get_template_directory() . '/patterns'. Adăugați căi suplimentare cu filtrul:
PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Integrările de execuție care combină fișiere din mai multe rădăcini pot înlocui scanarea sistemului de fișiere cu o sursă logică de descoperire. Manifeste de modele și șabloane sursă sunt rezolvate din inventarul logic final vizibil.
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();
Comparație cu paginile
| Aspect | Pagini | Modele |
|---|---|---|
| Stocare | Sincronizate în baza de date ca articole | Înregistrate în memorie |
| Configurare | page.json |
pattern.json |
| Sincronizare | Explicită, cu wp bs pages sync |
Nu este necesară sincronizarea |
| Blocarea șablonului | Da | Nu |
| Caz de utilizare | Conținut predefinit pentru pagini | Șabloane de blocuri reutilizabile |