Patronen
Patronen zijn templates op basis van bestanden die als WordPress blokpatronen worden geregistreerd. Ze verschijnen in de blokinvoeger en gebruikers kunnen ze overal plaatsen.
Anders dan bij pagina’s worden patronen in het geheugen geregistreerd en maken ze geen database-items aan.
pattern.json
Elke patroonmap heeft een pattern.json-configuratiebestand nodig:
JSON
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Eigenschappen
| Eigenschap | Type | Standaard | Beschrijving |
|---|---|---|---|
name |
string |
vereist | Unieke identificatie (met voorvoegsel blockstudio/) |
title |
string |
vereist | Weergavetitel in de blokinvoeger |
description |
string |
"" |
Beschrijving die in de invoeger wordt getoond |
categories |
string[] |
[] |
Patrooncategorieën (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Zoektermen voor de invoeger |
viewportWidth |
number |
– | Voorbeeldbreedte in pixels |
blockTypes |
string[] |
[] |
Bijbehorende bloktypen |
postTypes |
string[] |
[] |
Beperken tot specifieke berichttypen |
inserter |
boolean |
true |
Tonen in de invoeger |
Voorbeeld
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>
Aangepaste paden
Standaard scant Blockstudio get_template_directory() . '/patterns'. Voeg extra paden toe met het filter:
PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Runtime-integraties die bestanden uit meerdere hoofdmappen samenstellen, kunnen de bestandssysteemscan vervangen door een logische ontdekkingsbron. Patroonmanifesten en bronbestanden van templates worden gevonden in de uiteindelijke zichtbare logische inventaris.
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();
Vergelijking met pagina’s
| Aspect | Pagina’s | Patronen |
|---|---|---|
| Opslag | Gesynchroniseerd naar database als berichten | In het geheugen geregistreerd |
| Configuratie | page.json |
pattern.json |
| Synchronisatie | Expliciet, met wp bs pages sync |
Synchronisatie niet nodig |
| Template vergrendelen | Ja | Nee |
| Gebruik | Vooraf gedefinieerde pagina-inhoud | Herbruikbare bloktemplates |