Pereiti prie turinio

Šablonai

Šablonai – tai failais pagrįsti šablonai, užregistruoti kaip WordPress blokų šablonai. Jie rodomi blokų įterpimo priemonėje, o naudotojai gali juos įterpti bet kur.

Kitaip nei puslapiai, šablonai registruojami atmintyje ir nekuria duomenų bazės įrašų.

pattern.json

Kiekvienam šablono aplankui reikia pattern.json konfigūracijos failo:

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "description": "A hero section with heading and CTA",
  "categories": ["featured", "header"],
  "keywords": ["hero", "banner", "cta"]
}

Savybės

Savybė Tipas Numatytoji reikšmė Aprašymas
name string privaloma Unikalus identifikatorius (su prefiksu blockstudio/)
title string privaloma Rodomas pavadinimas blokų įterpimo priemonėje
description string "" Aprašymas, rodomas įterpimo priemonėje
categories string[] [] Šablonų kategorijos (e.g., featured, header, footer)
keywords string[] [] Paieškos raktažodžiai įterpimo priemonei
viewportWidth number – Peržiūros plotis pikseliais
blockTypes string[] [] Susietų blokų tipai
postTypes string[] [] Apribojimas konkretiems įrašų tipams
inserter boolean true Ar rodyti įterpimo priemonėje

Pavyzdys

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>

Tinkinti keliai

Pagal numatytuosius nustatymus Blockstudio nuskaito get_template_directory() . '/patterns'. Papildomų kelių pridėkite naudodami filtrą:

PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/custom-patterns';
    $paths[] = MY_PLUGIN_PATH . '/patterns';
    return $paths;
} );

Vykdymo metu failus iš kelių šakninių katalogų sujungiančios integracijos vietoj failų sistemos skenavimo gali naudoti loginį aptikimo šaltinį. Šablonų manifestai ir šaltinio šablonai nustatomi pagal galutinį matomą loginį išteklių sąrašą.

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();

Palyginimas su puslapiais

Savybė Puslapiai Šablonai
Saugojimas Sinchronizuojami su duomenų baze kaip įrašai Registruojami atmintyje
Konfigūracija page.json pattern.json
Sinchronizavimas Aiškus, naudojant wp bs pages sync Sinchronizuoti nereikia
Šablono užrakinimas Taip Ne
Naudojimo atvejis Iš anksto apibrėžtas puslapio turinys Pakartotinai naudojami blokų šablonai