Šablonai
Šablonai – tai failais pagrįsti šablonai, užregistruoti kaip WordPress blokų šablonai. Jie rodomi blokų įterpimo priemonėje, o naudotojai gali juos įterpti bet kur.
Kitaip nei puslapiai, šablonai registruojami atmintyje ir nekuria duomenų bazės įrašų.
pattern.json
Kiekvienam šablono aplankui reikia pattern.json konfigūracijos failo:
JSON
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Savybės
| Savybė | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
name |
string |
privaloma | Unikalus identifikatorius (su prefiksu blockstudio/) |
title |
string |
privaloma | Rodomas pavadinimas blokų įterpimo priemonėje |
description |
string |
"" |
Aprašymas, rodomas įterpimo priemonėje |
categories |
string[] |
[] |
Šablonų kategorijos (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Paieškos raktažodžiai įterpimo priemonei |
viewportWidth |
number |
– | Peržiūros plotis pikseliais |
blockTypes |
string[] |
[] |
Susietų blokų tipai |
postTypes |
string[] |
[] |
Apribojimas konkretiems įrašų tipams |
inserter |
boolean |
true |
Ar rodyti įterpimo priemonėje |
Pavyzdys
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>
Tinkinti keliai
Pagal numatytuosius nustatymus Blockstudio nuskaito get_template_directory() . '/patterns'. Papildomų kelių pridėkite naudodami filtrą:
PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Vykdymo metu failus iš kelių šakninių katalogų sujungiančios integracijos vietoj failų sistemos skenavimo gali naudoti loginį aptikimo šaltinį. Šablonų manifestai ir šaltinio šablonai nustatomi pagal galutinį matomą loginį išteklių sąrašą.
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();
Palyginimas su puslapiais
| Savybė | Puslapiai | Šablonai |
|---|---|---|
| Saugojimas | Sinchronizuojami su duomenų baze kaip įrašai | Registruojami atmintyje |
| Konfigūracija | page.json |
pattern.json |
| Sinchronizavimas | Aiškus, naudojant wp bs pages sync |
Sinchronizuoti nereikia |
| Šablono užrakinimas | Taip | Ne |
| Naudojimo atvejis | Iš anksto apibrėžtas puslapio turinys | Pakartotinai naudojami blokų šablonai |