Ugrás a tartalomhoz

Minták

A minták fájlalapú sablonok, amelyeket WordPress blokkmintaként regisztrál a rendszer. Megjelennek a blokkbeszúróban, és a felhasználók bárhol elhelyezhetik őket.

Az oldalakkal ellentétben a minták memóriában kerülnek regisztrálásra, és nem hoznak létre adatbázis-bejegyzéseket.

pattern.json

Minden mintamappához szükség van egy pattern.json konfigurációs fájlra:

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

Tulajdonságok

Tulajdonság Típus Alapértelmezett Leírás
name string kötelező Egyedi azonosító (előtagja blockstudio/)
title string kötelező Megjelenített cím a blokkbeszúróban
description string "" A beszúróban megjelenő leírás
categories string[] [] Minta-kategóriák (e.g., featured, header, footer)
keywords string[] [] Keresési kulcsszavak a beszúróhoz
viewportWidth number – Előnézeti szélesség pixelben
blockTypes string[] [] Társított blokktípusok
postTypes string[] [] Meghatározott bejegyzéstípusokra korlátozás
inserter boolean true Megjelenjen-e a blokkbeszúróban

Példa

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>

Egyéni elérési utak

Alapértelmezés szerint a Blockstudio a get_template_directory() . '/patterns' útvonalat vizsgálja. További útvonalakat a következő szűrővel adhat hozzá:

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

A több gyökérből származó fájlokat összeállító futásidejű integrációk a fájlrendszer vizsgálatát logikai felderítési forrással helyettesíthetik. A mintajegyzékek és a forrássablonok a végleges, látható logikai leltárból oldódnak fel.

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

Összehasonlítás az oldalakkal

Szempont Oldalak Minták
Tárolás Bejegyzésként szinkronizálva az adatbázisba Memóriában regisztrálva
Konfiguráció page.json pattern.json
Szinkronizálás Kifejezett, wp bs pages sync használatával Nincs szükség szinkronizálásra
Sablonzárolás Igen Nem
Felhasználási cél Előre meghatározott oldaltartalom Újra felhasználható blokk-sablonok