Mustrid
Mustrid on failipõhised mallid, mis registreeritakse WordPress plokimustritena. Need ilmuvad plokivalijas ning kasutajad saavad need paigutada kuhu tahes.
Erinevalt lehtedest registreeritakse mustrid mälus ja andmebaasi kirjeid ei looda.
pattern.json
Iga mustri kaust vajab konfiguratsioonifaili pattern.json:
JSON
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Omadused
| Omadus | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
name |
string |
kohustuslik | Unikaalne tunnus (eesliitega blockstudio/) |
title |
string |
kohustuslik | Kuvatav pealkiri plokivalijas |
description |
string |
"" |
Valijas kuvatav kirjeldus |
categories |
string[] |
[] |
Mustri kategooriad (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Valija otsingusõnad |
viewportWidth |
number |
– | Eelvaate laius pikslites |
blockTypes |
string[] |
[] |
Seotud plokitüübid |
postTypes |
string[] |
[] |
Piira kindlate sisupostituse tüüpidega |
inserter |
boolean |
true |
Kas kuvada plokivalijas |
Näide
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>
Kohandatud teed
Vaikimisi skannib Blockstudio teed get_template_directory() . '/patterns'. Lisa täiendavaid teid filtriga:
PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Mitmest juurkataloogist faile koondavad käitusaegsed integratsioonid võivad asendada failisüsteemi skannimise loogilise tuvastusallikaga. Mustrite manifestid ja lähtefailide mallid lahendatakse lõpliku nähtava loogilise loendi põhjal.
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();
Võrdlus lehtedega
| Aspekt | Lehed | Mustrid |
|---|---|---|
| Salvestus | Sünkroonitakse andmebaasi postitustena | Registreeritakse mälus |
| Konfiguratsioon | page.json |
pattern.json |
| Sünkroonimine | Selgesõnaline, kasutades wp bs pages sync |
Sünkroonimine pole vajalik |
| Malli lukustus | Jah | Ei |
| Kasutusjuht | Eelmääratletud lehesisu | Korduvkasutatavad plokimallid |