Treci la conținut

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