Predloge in deli urejevalnika spletnega mesta iz datotek
Tema blokov svoj videz določa v mapah templates/*.html in parts/*.html:
datotekah s serializiranimi komentarji blokov, kot je
<!-- wp:template-part {"slug":"header"} /-->. Nihče ne mara, da jih piše
ročno, zato jih običajno ustvarimo v urejevalniku spletnega mesta in izvozimo. To deluje,
dokler iste predloge ne urejata dve osebi ali dokler mora pregledovalec brati razlike v
ubežnih znakih JSON v komentarjih HTML.
Blockstudio omogoča pisanje enakih predlog na način, kot pišete strani iz datotek:
mapa z majhnim manifestom JSON in izvorno datoteko v označevalnem jeziku,
podobnem HTML, z navadnimi elementi, oznakami <block> in lastnimi bloki
Blockstudio.
Blockstudio izvorno datoteko prevede v izvorno označevalno kodo blokov in jo kot datoteko teme preda urejevalniku WordPress.
Urejevalnik spletnega mesta še naprej deluje kot prej: uporabniki lahko
prilagodijo predlogo, s ponastavitvijo pa povrnejo različico iz datoteke.
Ta vodič ustvari del glave in noge, predlogi za prvo in posamezno stran ter predlogo po meri, ki jo lahko uredniki izberejo za strani, nato pa pokaže, kako jih razreši WordPress.
Struktura map
Predloge shranite v templates/, dele predlog pa v parts/. Vsaka je mapa
z manifestom in eno izvorno datoteko:
theme/
├── templates/
│ ├── front-page/
│ │ ├── template.json
│ │ └── index.php
│ ├── single/
│ │ ├── template.json
│ │ └── index.php
│ └── page-landing/
│ ├── template.json
│ └── index.php
└── parts/
├── header/
│ ├── part.json
│ └── index.php
└── footer/
├── part.json
└── index.html
To sta isti mapi templates/ in parts/, ki ju WordPress bere za temo
blokov. Blockstudio najprej pregleda aktivno temo, nato pa nadrejeno temo.
Mape z datoteko template.json ali part.json so viri Blockstudio; navadne
.html datoteke v njihovi bližini ostanejo izvorne predloge WordPress.
Izvorna datoteka je lahko index.php, index.blade.php, index.twig ali
index.html; preverjanje poteka v tem vrstnem redu. Za Twig potrebujete Timber, za Blade pa njegov paket za upodabljanje, kot je opisano v
Mehanizmi predlog.
1. korak: Del glave
Vsak del potrebuje part.json. area pove urejevalniku spletnega mesta, kam sodi del:
{
"slug": "header",
"title": "Header",
"description": "Site header with logo and navigation",
"area": "header"
}
Izvorna koda uporablja isto sintakso kot strani in vzorci Blockstudio. <div>
postane skupinski blok, atributi postanejo atributi bloka, elementi <block>
pa ustvarijo poljuben registriran blok:
<div layout='{"type":"flex","justifyContent":"space-between"}'>
<block name="core/site-title" />
<block name="core/navigation" overlayMenu="mobile" />
</div>
Blockstudio to prevede v naslednjo označevalno kodo blokov:
<!-- wp:group {"layout":{"type":"flex","justifyContent":"space-between"}} --><div class="wp-block-group is-layout-flex"><!-- wp:site-title /--><!-- wp:navigation {"overlayMenu":"mobile"} /--></div><!-- /wp:group -->
To je enako, kot bi sicer napisali ročno. Tudi lastni bloki delujejo
enako: <block name="acme/announcement" />, oznaka <bs:acme-announcement />
ali nastavljena predpona oznake se prevedejo v komentar bloka za ta
blok.
2. korak: Del noge
Del je lahko velik kot en odstavek. Ta uporablja index.html, da ponazori,
da je izvorna datoteka označevalni jezik, ne program:
{
"slug": "footer",
"title": "Footer",
"area": "footer"
}
<p>Built with Acme.</p>
Prevede se v <!-- wp:paragraph --><p>Built with Acme.</p><!-- /wp:paragraph -->.
3. korak: Predlogi za prvo in posamezno stran
Predloge uporabljajo template.json. slug mora biti natančno ime
predloge v hierarhiji WordPress, na primer front-page, single, page, archive, 404 ali single-product. Blockstudio ga nikoli ne postavi za predpono.
{
"slug": "front-page",
"title": "Front Page",
"description": "Homepage template"
}
<block name="core/template-part" slug="header" tagName="header" />
<main>
<block name="core/post-content" />
</main>
<block name="core/template-part" slug="footer" tagName="footer" />
Predloga za posamezno objavo sledi enaki zgradbi, vendar uporablja bloke objave:
{
"slug": "single",
"title": "Single Post"
}
<block name="core/template-part" slug="header" tagName="header" />
<main>
<block name="core/post-title" level="1" />
<block name="core/post-date" />
<block name="core/post-content" />
</main>
<block name="core/template-part" slug="footer" tagName="footer" />
Prevedena predloga za posamezno objavo:
<!-- wp:template-part {"slug":"header","tagName":"header"} /--><!-- wp:group {"tagName":"main"} --><main class="wp-block-group"><!-- wp:post-title {"level":1} /--><!-- wp:post-date /--><!-- wp:post-content /--></main><!-- /wp:group --><!-- wp:template-part {"slug":"footer","tagName":"footer"} /-->
<main> je postal skupinski blok z tagName: "main", bloki delov predloge pa se sklicujejo na dela iz 1. in 2. koraka po njihovih polžih. Ko WordPress upodobi predlogo, se sklici razrešijo v dele iz datotek, zato se izpis prve strani začne z <header class="wp-block-template-part"> z naslovom spletnega mesta in navigacijo ter konča z <footer class="wp-block-template-part"> z odstavkom noge.
4. korak: Predloga po meri za strani
Predloge, katerih polž ni del hierarhije, so predloge po meri. Vrste objav, za katere veljajo, navedite z postTypes, uredniki pa jih lahko izberejo v izbirniku predlog:
{
"slug": "page-landing",
"title": "Landing Page",
"description": "Full-width page without a header",
"postTypes": ["page"]
}
<main>
<block name="core/post-content" />
</main>
<block name="core/template-part" slug="footer" tagName="footer" />
get_block_templates( array( 'post_type' => 'page' ), 'wp_template' ) zdaj
vključuje page-landing, objekt predloge pa vsebuje
post_types: ["page"].
Viri se prevedejo enkrat
Vir se prebere in prevede v označevalno kodo blokov enkrat, ne ob vsaki zahtevi. Takrat ni trenutne objave ali konteksta zahteve. index.php se bere kot označevalni jezik: koda PHP v njem se ne izvede, zato se <?php echo get_bloginfo( 'name' ); ?> prevede v prazno. Vse, kar je odvisno od zahteve, sodi v blok, ki se upodobi med izvajanjem: core/site-title namesto izpisanega imena spletnega mesta, core/post-title namesto the_title() ali vaš lasten dinamični blok Blockstudio.
Rezultati prevajanja so predpomnjeni skupaj s podatki za spremljanje datotek. Urejanje manifesta ali izvorne datoteke razveljavi predpomnjeno vsebino tega elementa, zato naslednja zahteva prikaže spremembo brez ločenega koraka gradnje.
Kako WordPress vidi datoteke
Blockstudio se vključi v ista iskanja, ki jih WordPress uporablja za predloge tem. V get_block_templates() so predloge iz datotek prikazane z source: "theme" in origin: "theme", enako kot izvorne datoteke teme, get_block_template( 'acme//header', 'wp_template_part' ) pa vrne del glave z njegovim area.
Vrstni red iskanja je:
- Prilagoditev urejevalnika spletnega mesta, shranjena v zbirki podatkov.
- Izvorna datoteka
.htmlv aktivni temi. - Vir iz datoteke Blockstudio.
- Nadrejena tema ali nadomestni viri vtičnikov.
Ta vrstni red ohranja potek dela urejevalnika spletnega mesta. Ko uporabnik uredi nogo in jo shrani, WordPress shrani objavo wp_template_part, get_block_template() pa vrne to prilagoditev z source: "custom".
Poznejše spremembe v parts/footer/index.html niso prikazane, dokler prilagoditev obstaja. Ko uporabnik ponastavi del ali izbriše objavo, iskanje znova uporabi datoteko in vrne najnovejši prevedeni vir.
Blockstudio sprememb iz urejevalnika spletnega mesta ne zapisuje nazaj v datoteke. Če naj uporabnikova sprememba postane nova privzeta različica, jo kopirajte v izvorno datoteko in ponastavite prilagoditev.
Ugnezdeni index.html in polži
WordPress rekurzivno poišče datoteke .html v templates/ in parts/. Mapa z manifestom, ki uporablja index.html, na primer parts/footer/index.html, bi se zato prikazala tudi kot izvorni del s polžem, izpeljanim iz poti, footer/index. Ker Blockstudio 7.6.6, je del index.html z manifestom na voljo samo pod deklariranim polžem, zato urejevalnik spletnega mesta prikaže eno nogo, ne dveh. Ugnezdene datoteke .html brez manifesta ostanejo nedotaknjene.
Preverjanje predlog v PHP
Razred Blockstudio\Site_Templates prebere in prevede vire, kar je uporabno pri preizkusih in preverjanju namestitve:
$templates = Blockstudio\Site_Templates::templates();
$header = Blockstudio\Site_Templates::get_part( 'header' );
echo $header['area']; // header
echo $header['content']; // compiled block markup
$errors = Blockstudio\Site_Templates::errors();
Vsak element vključuje slug, title, description, type (wp_template ali wp_template_part), status, source_type, postTypes za predloge ali area za dele, meta in prevedeni content. Podajte seznam, da prevedete samo izbrane elemente, težave za ta izbor pa preberite z selection_errors():
$selected = Blockstudio\Site_Templates::templates( array( 'front-page' ) );
$errors = Blockstudio\Site_Templates::selection_errors( 'templates' );
Dodajanje drugih map
Če želite vire Blockstudio ločiti od izvornih predlog ali jih vključiti v vtičnik, dodajte korenske mape za iskanje s filtri:
add_filter( 'blockstudio/site_templates/template_paths', function ( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
add_filter( 'blockstudio/site_templates/part_paths', function ( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
Filtra blockstudio/site_templates/template_content in part_content prilagodita vir pred razčlenjevanjem, blockstudio/site_templates/parser pa za en element zamenja razčlenjevalnik. Celoten seznam je v tabeli s kavlji za Predloge spletnega mesta.
Kdaj uporabiti posamezno možnost
| Kaj želite | Uporabite |
|---|---|
| Postavitev teme WordPress za URL: glavo, nogo, posamezno stran, arhiv | Predloge in deli spletnega mesta |
| Stran z naslovom URL, katere vsebina je v datotekah | Strani iz datotek |
| Ponovno uporabljiv razdelek, ki ga uredniki vstavijo | Vzorci |
Predloge ne ustvarjajo objav, temveč jih ustvarjajo strani. Razdelek dokumentacije je na primer zbirka strani, katerih objave so upodobljene s predlogo, ki jo lahko še vedno ustvarite tukaj.
Naslednji koraki
- Referenca za predloge spletnega mesta: vse lastnosti manifesta, PHP API in vsi kavlji.
- Pregled strani in vzorcev: razčlenjevalnik HTML, oznake blokov in preslikava elementov, ki jih uporabljajo izvorne datoteke predlog.
- Izdelava spletnega mesta z dokumentacijo: zbirke strani z Markdown, nalagalniki in postavitvami.