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:
{
"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:
{
"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:
<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á:
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
// 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 |