Liigu sisu juurde

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