Raksti
Raksti ir uz failiem balstītas veidnes, kas reģistrētas kā WordPress bloku raksti. Tie parādās bloku ievietotājā, un lietotāji var tos ievietot jebkur.
Atšķirībā no lapām, raksti tiek reģistrēti atmiņā un nerada datubāzes ierakstus.
pattern.json
Katrai raksta mapei ir nepieciešams konfigurācijas fails pattern.json:
JSON
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Rekvizīti
| Īpašība | Tips | Noklusējums | Apraksts |
|---|---|---|---|
name |
string |
obligāts | Unikāls identifikators (ar prefiksu blockstudio/) |
title |
string |
obligāts | Attēlotais nosaukums bloku ievietotājā |
description |
string |
"" |
Apraksts, kas redzams ievietotājā |
categories |
string[] |
[] |
Rakstu kategorijas (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Meklēšanas atslēgvārdi ievietotājam |
viewportWidth |
number |
– | Priekšskatījuma platums pikseļos |
blockTypes |
string[] |
[] |
Saistītie bloku tipi |
postTypes |
string[] |
[] |
Ierobežo konkrētiem ierakstu veidiem |
inserter |
boolean |
true |
Vai rādīt ievietotājā |
Piemērs
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>
Pielāgoti ceļi
Pēc noklusējuma Blockstudio skenē get_template_directory() . '/patterns'. Pievienojiet citus ceļus ar filtru:
PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Izpildlaika integrācijas, kas apvieno failus no vairākām saknēm, var aizstāt failu sistēmas skenēšanu ar loģisku atklāšanas avotu. Rakstu manifesti un avota veidnes tiek noteiktas, izmantojot galīgo redzamo loģisko inventāru.
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();
Salīdzinājums ar lapām
| Aspekts | Lapas | Raksti |
|---|---|---|
| Glabāšana | Sinhronizēti datubāzē kā ieraksti | Reģistrēti atmiņā |
| Konfigurācija | page.json |
pattern.json |
| Sinhronizācija | Tieša, ar wp bs pages sync |
Sinhronizācija nav vajadzīga |
| Veidnes bloķēšana | Jā | Nē |
| Lietojums | Iepriekš definēts lapas saturs | Atkārtoti izmantojamas bloku veidnes |