Pāriet uz saturu

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