Siirry sisältöön

Mallit

Mallit ovat tiedostopohjaisia mallipohjia, jotka rekisteröidään WordPress-lohkomalleiksi. Ne näkyvät lohkolisääjässä, ja käyttäjät voivat lisätä niitä mihin tahansa.

Toisin kuin sivut, mallit rekisteröidään muistiin eivätkä ne luo tietokantamerkintöjä.

pattern.json

Jokainen mallikansio tarvitsee määritystiedoston pattern.json:

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

Ominaisuudet

Ominaisuus Tyyppi Oletusarvo Kuvaus
name string pakollinen Yksilöllinen tunniste (etuliitteenä blockstudio/)
title string pakollinen Näyttönimi lohkolisääjässä
description string "" Kuvaus, joka näytetään lisäysvalikossa
categories string[] [] Malliluokat (e.g. featured, header, footer)
keywords string[] [] Hakusanat lohkolisääjää varten
viewportWidth number – Esikatselun leveys pikseleinä
blockTypes string[] [] Liitetyt lohkotyypit
postTypes string[] [] Rajoita tiettyihin artikkelityyppeihin
inserter boolean true Näytetäänkö lohkolisääjässä

Esimerkki

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>

Mukautetut polut

Oletusarvoisesti Blockstudio etsii kohteesta get_template_directory() . '/patterns'. Lisää polkuja suodattimella:

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

Suorituksenaikaiset integraatiot, jotka kokoavat tiedostoja useista juurihakemistoista, voivat korvata tiedostojärjestelmän haun loogisella etsintälähteellä. Mallimanifestit ja lähdemallipohjat ratkaistaan lopullisesta näkyvästä loogisesta sisällöstä.

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

Vertailu sivuihin

Ominaisuus Sivut Mallit
Tallennus Synkronoidaan tietokantaan artikkeleina Rekisteröidään muistiin
Määritys page.json pattern.json
Synkronointi Nimenomainen, wp bs pages sync kanssa Synkronointia ei tarvita
Mallipohjan lukitus Kyllä Ei
Käyttötarkoitus Ennalta määritetty sivusisältö Uudelleenkäytettävät lohkomallipohjat