Strani in vzorci
Blockstudio vam omogoča, da strani WordPress, vzorce blokov in predloge urejevalnika spletnega mesta določite kot datoteke v svoji temi. Pišite predloge v slogu HTML, razčlenjevalnik v Blockstudio pa jih pretvori v izvorne bloke WordPress.
- Strani se sinhronizirajo z zbirko podatkov kot objave WordPress, tako da so datotečne predloge in vsebina strani usklajene.
- Vzorci se registrirajo v pomnilniku prek
register_block_pattern()in so na voljo v vstavljalniku blokov, kjer jih lahko uporabniki vstavijo kamor koli. - Predloge spletnega mesta zagotavljajo vire
wp_templateinwp_template_part, ki temeljijo na datotekah, za urejevalnik spletnega mesta WordPress.
Vse tri funkcije uporabljajo isti razčlenjevalnik HTML in isto sintakso blokov.
Ustvarjanje strani na podlagi datotek
Praktični vodnik po predlogah strani na podlagi datotek, sinhronizaciji in zaklepanju.
Struktura map
theme/
├── pages/
│ ├── about/
│ │ ├── page.json
│ │ └── index.php
│ └── contact/
│ ├── page.json
│ └── index.twig
├── patterns/
├── hero/
│ ├── pattern.json
│ └── index.php
└── cta/
├── pattern.json
└── index.blade.php
├── templates/
└── front-page/
├── template.json
└── index.php
└── parts/
└── header/
├── part.json
└── index.php
Vsaka podmapa vsebuje konfiguracijsko datoteko JSON (page.json, pattern.json, template.json ali part.json) in datoteko s predlogo.
Mehanizmi za predloge
Predloge lahko zapišete kot navadno označevanje v index.php ali pa uporabite Twig oziroma Blade:
| Datoteka | Mehanizem | Zahteva |
|---|---|---|
index.php |
Brez (bere se takšna, kot je; koda PHP se ne izvede) | Brez |
index.twig |
Twig | Timber |
index.blade.php |
Blade | illuminate/view |
Če obstaja več datotek s predlogami, je vrstni red prednosti: index.php > index.blade.php > index.twig.
Ker se predloge prevedejo ob inicializaciji (pred vzpostavitvijo konteksta zahteve), dinamične spremenljivke niso na voljo v predlogah Twig in Blade. Uporabne so za vgrajene funkcije in filtre, kot sta {{ "text"|upper }} ali {{ strtoupper("text") }}.
Preslikava HTML v bloke
Standardni elementi HTML se samodejno pretvorijo v ustrezne bloke WordPress.
Besedilo
| HTML | Blok |
|---|---|
<p> |
core/paragraph |
<h1> – <h6> |
core/heading |
<ul> |
core/list (neurejen) |
<ol> |
core/list (urejen) |
<li> |
core/list-item |
<blockquote> |
core/quote |
<code> |
core/code |
<pre> |
core/preformatted |
Seznami ohranijo svojo strukturo. Element <ul> ali <ol> znotraj elementa <li> postane notranji blok core/list tega elementa core/list-item, tako kot ga shrani urejevalnik. Zato seznami omogočajo poljubno globoko gnezdenje. class na seznamu ali njegovem elementu postane njegova className, s čimer lahko v datoteki strani nastavite slog bloka, kot je is-style-checks; enako naredi tudi <block name="core/list" className="...">.
Predstavnost
| HTML | Blok |
|---|---|
<img> |
core/image |
<figure> |
core/image (z napisom) |
<audio> |
core/audio |
<video> |
core/video |
Postavitev
| HTML | Blok |
|---|---|
<div>, <section> |
core/group |
<main>, <header>, <footer>, <article>, <aside> |
core/group, ki element ohrani kot svoj tagName |
<hr> |
core/separator |
<details> |
core/details |
<table> |
core/table |
Sintaksa blokov
Za bloke brez neposredne ustreznice HTML uporabite element <block>:
<block name="core/cover" url="https://example.com/hero.jpg">
<h1>Welcome</h1>
<p>Content inside the cover block.</p>
</block>
Osnovni bloki
<!-- Pullquote -->
<block name="core/pullquote">
<p>An important quote.</p>
</block>
<!-- Verse -->
<block name="core/verse">Roses are red,
Violets are blue.</block>
<!-- Cover -->
<block name="core/cover" url="https://example.com/image.jpg">
<h2>Cover Title</h2>
</block>
<!-- Embed -->
<block name="core/embed" url="https://youtube.com/watch?v=..." providerNameSlug="youtube" />
<!-- Spacer -->
<block name="core/spacer" height="50px" />
<!-- Gallery -->
<block name="core/gallery">
<img src="https://example.com/1.jpg" alt="Image 1" />
<img src="https://example.com/2.jpg" alt="Image 2" />
</block>
<!-- Columns -->
<block name="core/columns">
<block name="core/column">
<h3>Column 1</h3>
</block>
<block name="core/column">
<h3>Column 2</h3>
</block>
</block>
<!-- Buttons -->
<block name="core/buttons">
<block name="core/button" url="/get-started">Get Started</block>
</block>
<!-- Row (flex layout) -->
<block name="core/group" layout='{"type":"flex","flexWrap":"nowrap"}'>
<p>Item 1</p>
<p>Item 2</p>
</block>
Bloki po meri
Ista sintaksa deluje za vse registrirane bloke:
<block name="blockstudio/section">
<h1>Welcome</h1>
</block>
<block name="acf/hero" title="Hero Title" background="dark">
<p>Inner content becomes InnerBlocks.</p>
</block>
Atributi
Atributi HTML na elementih <block> se posredujejo kot atributi bloka. Podprte so vrednosti JSON:
<block name="core/heading" level="3">Custom Heading</block>
<block name="core/group" layout='{"type":"flex","orientation":"vertical"}'>
<p>Stacked content.</p>
</block>
<img src="https://example.com/photo.jpg" alt="Photo" width="800" height="400" />
Vrednosti atributov se dekodirajo enkrat, tako kot jih prebere brskalnik, zato data-animate="[&>span]:fade" in data-animate="[&>span]:fade" shranita isto vrednost.
Na elementu, preslikanem v blok Blockstudio, je vsak atribut shranjen skupaj z blokom. Deklarirana polja so na voljo predlogi; globalni atributi, ki jih blok ne deklarira (id, style, role, title, lang, dir, hidden, tabindex, aria-* in data-*), so ob izrisu dodani korenskemu elementu bloka, enako kot pri oznakah blokov oznake blokov. V virih strani in vzorcev predpona html- označuje samo enega od teh globalnih atributov, zato se html-role="note" posreduje kot role, medtem ko se obravnavalniki dogodkov, kot je html-onclick, nikoli ne izrišejo. Vse drugo, vključno z nedeklariranim class, ostane v vsebini objave in ne doseže strani, wp bs pages sync pa to navede za vsako stran, ki jo razčleni.
Izrisovalniki blokov po meri
Razčlenjevalnik HTML uporablja arhitekturo, ki temelji na registru. Dodajte graditelj bloka po meri z blockstudio/block_tags/builders:
add_filter( 'blockstudio/block_tags/builders', function( $builders, $parser ) {
$builders['acf/hero'] = function( array $attrs, string $inner_content ) {
$inner_blocks = Blockstudio\Block_Tags::parse_inner_blocks( $inner_content );
return array(
'blockName' => 'acf/hero',
'attrs' => $attrs,
'innerBlocks' => $inner_blocks,
'innerHTML' => '',
'innerContent' => array_fill( 0, count( $inner_blocks ), null ),
);
};
return $builders;
}, 10, 2 );
Nato ga uporabite v kateri koli predlogi:
<block name="acf/hero" background="dark">
<h1>Welcome</h1>
</block>
Prepišete lahko tudi način izrisa osnovnih blokov:
add_filter( 'blockstudio/parser/renderers', function( $renderers, $parser ) {
$renderers['core/paragraph'] = function( array $attrs, string $inner_content ) {
$content = trim( $inner_content );
$attrs['align'] = $attrs['align'] ?? 'center';
return array(
'blockName' => 'core/paragraph',
'attrs' => $attrs,
'innerBlocks' => array(),
'innerHTML' => '<p class="has-text-align-center">' . $content . '</p>',
'innerContent' => array( '<p class="has-text-align-center">' . $content . '</p>' ),
);
};
return $renderers;
}, 10, 2 );
Povratni klici graditelja prejmejo razčlenjene atribute in surovo notranjo vsebino. Vrniti morajo polje blokov WordPress. Celoten vrstni red filtrov in primer vsebnika si oglejte v razdelku Izrisovalniki po meri.
Podpis funkcije graditelja
/**
* @param array $attrs Parsed element or block-tag attributes.
* @param string $inner_content Raw inner content.
* @return array WordPress block array.
*/
function my_builder( array $attrs, string $inner_content ): array {}
Preslikava elementov
Standardni elementi HTML, kot so <h1>, <p> in <img>, so privzeto preslikani v osnovne bloke WordPress. To preslikavo lahko prepišete in kateri koli element HTML usmerite v drug blok s filtrom blockstudio/parser/element_mapping:
add_filter( 'blockstudio/parser/element_mapping', function( $mapping ) {
$mapping['h1'] = 'custom/heading';
$mapping['h2'] = 'custom/heading';
$mapping['p'] = 'custom/paragraph';
$mapping['img'] = 'custom/image';
return $mapping;
}, 10, 2 );
Ko je ta filter aktiven, bo vsak <h1> v vaših predlogah ustvaril blok custom/heading namesto bloka core/heading. Atributi elementa se posredujejo ciljnemu bloku. Če je za ime ciljnega bloka registriran izrisovalnik, bo uporabljen. Sicer se ustvari splošna struktura bloka.
To je uporabno, kadar tema ali vtičnik ponuja vrste blokov po meri, ki naj nadomestijo privzete bloke v vseh predlogah strani in vzorcev.
Pri preprostih preslikavah <p> lahko Blockstudio notranjo vsebino HTML neposredno usmeri v atribut richtext content registriranega bloka Blockstudio, ki ni osnovni blok. Ciljni blok mora deklarirati atribut z id: "content" in type: "richtext".
Vrstično oblikovanje (a, b, br, code, del, em, i, img, ins, mark, s, small, span, strong, sub, sup, u) ostane v usmerjeni vrednosti, tudi če je ista oznaka preslikana v element, kot sta privzeto code in img. Odstavek, katerega edini podrejeni element je slika, postane blok, v katerega se preslika <img>; tak blok ustvari tudi Markdown za samostojno sliko. Gnezdene oznake blokov in bloki HTML na ravni blokov se še naprej razčlenjujejo kot notranji bloki.
Vrednosti preslikav so lahko tudi klicljive funkcije, kadar je ciljni blok odvisen od atributov elementa:
add_filter( 'blockstudio/parser/element_mapping', function( $mapping ) {
$mapping['div'] = function( array $attrs ) {
if ( isset( $attrs['width'] ) ) {
return 'theme/row';
}
if ( isset( $attrs['gap'] ) ) {
return 'theme/flow';
}
return 'theme/div';
};
return $mapping;
} );
Bloki po meri, preslikani iz elementov vsebnika, kot sta <section> in <div>, rekurzivno razčlenijo gnezdene podrejene elemente HTML, zato notranji naslovi, slike, oznake blokov in odstavki postanejo izvorni podrejeni bloki.
Celoten primer
Celotna predloga strani, ki združuje več vrst blokov:
<div>
<h1>Welcome to Our Site</h1>
<p>This is an <strong>introduction</strong> with <em>formatting</em>.</p>
<block name="core/columns">
<block name="core/column">
<h3>Feature One</h3>
<p>First feature description.</p>
</block>
<block name="core/column">
<h3>Feature Two</h3>
<p>Second feature description.</p>
</block>
</block>
<block name="core/cover" url="https://example.com/hero.jpg">
<h2>Our Mission</h2>
<p>Building amazing things together.</p>
</block>
<details>
<summary>FAQ</summary>
<p>Answers to common questions.</p>
</details>
<block name="core/buttons">
<block name="core/button" url="/contact">Contact Us</block>
<block name="core/button" url="/learn-more">Learn More</block>
</block>
</div>