Tiedostopohjaisten sivujen rakentaminen
Perinteinen WordPress-sivujen rakentaminen tapahtuu lohkoeditorissa: lohkoja vedetään, asetuksia määritetään ja tallennusta napsautetaan. Tämä toimii asiakkaille, jotka rakentavat sivuja itse, mutta rakenteisia ja versiohallittuja sivuja kehittäville siitä koituu ongelmia. Sivun asettelu on tietokannassa, ei koodissa. Et voi tarkistaa sitä pull requestissa, palauttaa sitä git-työkalulla aiempaan versioon tai luoda sitä uudelleen uudessa asennuksessa.
Blockstudion tiedostopohjaiset sivut ratkaisevat tämän. Määrität sivut teeman tiedostoina, kirjoitat HTML-mallipohjia, jotka muunnetaan WordPress-lohkoiksi, ja päätät tarkasti, mitä asiakkaat voivat muokata ja mitä eivät. Erillinen komento synkronoi tiedostot tavallisiksi WordPress-artikkeleiksi, ja mallipohjat pysyvät totuuden lähteenä.
Tässä oppaassa käydään läpi sivujen rakentaminen alusta alkaen. Erityistä huomiota kiinnitetään lukitus- ja muokkausohjauksiin, jotka tekevät tiedostopohjaisista sivuista käytännöllisiä asiakasprojekteissa.
Ensimmäinen sivusi
Luo teemaan pages-kansio ja lisää sitten alikansio, jossa on kaksi tiedostoa:
theme/
└── pages/
└── about/
├── page.json
└── index.php
{
"name": "about",
"title": "About Us",
"postStatus": "publish"
}
<h1>About Us</h1>
<p>We build things for the web.</p>
Suorita sivujen synkronointikomento:
wp bs pages sync
Blockstudio jäsentää tiedoston HTML WordPress-lohkoiksi ja luo sivun nimeltä
“Tietoa meistä”, jonka polkutunnus on about. Avaa sivu editorissa, niin näet
otsikon ja kappaleen aivan kuin olisit lisännyt ne itse.
Muokkaa tiedostoa index.php, muuta tekstiä ja suorita komento uudelleen. Lataa editori uudelleen,
niin näet päivityksen. Peruskierto on tämä: kirjoita HTML, synkronoi tarkoituksella, saat
lohkot.
Mallipohjakieli
Blockstudion HTML-jäsennin muuntaa tavalliset HTML-elementit WordPress-lohkoiksi. Kirjoita <p>, niin saat kappalelohkon. Kirjoita <h2>, niin saat otsikkolohkon. Vastaavuudet ovat intuitiivisia:
| HTML | Lohko |
|---|---|
<p> |
Kappale |
<h1>–<h6> |
Otsikko (taso vastaa tunnistetta) |
<ul>, <ol> |
Luettelo |
<blockquote> |
Lainaus |
<img> |
Kuva |
<div>, <section> |
Ryhmä |
<hr> |
Erotin |
<details> |
Tiedot |
<table> |
Taulukko |
Lohkoille, joilla ei ole suoraa HTML-vastinetta, käytä <block>-elementtiä ja name-määritettä:
<block name="core/cover" url="https://example.com/hero.jpg">
<h2>Hero Title</h2>
<p>Content over the background image.</p>
</block>
<block name="core/spacer" height="80px" />
<block name="core/buttons">
<block name="core/button" url="/contact">Get in Touch</block>
<block name="core/button" url="/work">See Our Work</block>
</block>
Elementtien <block> määritteet välitetään lohkon määritteiksi. Arvot muunnetaan automaattisesti: "true" muuttuu totuusarvoksi, "3" kokonaisluvuksi, ja '{"type":"flex"}':n kaltaiset JSON-merkkijonot puretaan objekteiksi.
Asettelut
Ryhmät tukevat eri asettelutiloja layout-määritteen avulla:
<!-- Default group (stacked) -->
<div>
<p>Stacked by default.</p>
</div>
<!-- Row (horizontal flex) -->
<block name="core/group" layout='{"type":"flex","flexWrap":"nowrap"}'>
<p>Side</p>
<p>by side</p>
</block>
<!-- Stack (vertical flex) -->
<block name="core/group" layout='{"type":"flex","orientation":"vertical"}'>
<p>Stacked</p>
<p>with flex</p>
</block>
<!-- Columns -->
<block name="core/columns">
<block name="core/column">
<p>Left column.</p>
</block>
<block name="core/column">
<p>Right column.</p>
</block>
</block>
Mukautetut lohkot
<block>-syntaksi toimii kaikilla rekisteröidyillä lohkoilla, myös omilla Blockstudio-lohkoillasi:
<block name="my-theme/hero" title="Welcome" background="dark" />
<block name="my-theme/testimonial" quote="Great product." author="Jane" />
Määritteet yhdistetään automaattisesti lohkon Blockstudio-kenttäarvoihin.
Laskeutumissivun rakentaminen
Tässä on kokonainen laskeutumissivu, jossa käytetään ydinlohkoja rakenteeseen ja asetteluun:
{
"name": "landing",
"title": "Landing Page",
"slug": "landing",
"postStatus": "publish",
"templateLock": "all"
}
<block name="core/cover" url="https://images.unsplash.com/photo-1497366216548-37526070297c?w=1600">
<h1>Build faster with Blockstudio</h1>
<p>File-based blocks. Zero build step. Full editor integration.</p>
<block name="core/buttons">
<block name="core/button" url="/get-started">Get Started</block>
<block name="core/button" url="/docs">Documentation</block>
</block>
</block>
<div>
<h2>Why developers love it</h2>
<block name="core/columns">
<block name="core/column">
<h3>No build step</h3>
<p>Write PHP, CSS, and JavaScript. No webpack, no bundler, no transpiler.</p>
</block>
<block name="core/column">
<h3>File-based</h3>
<p>Every block is a folder. Every page is a template. Version control everything.</p>
</block>
<block name="core/column">
<h3>Full editor support</h3>
<p>Fields, previews, and InnerBlocks work in the block editor out of the box.</p>
</block>
</block>
</div>
<block name="core/media-text" mediaurl="https://images.unsplash.com/photo-1460925895917-afdab827c52f?w=800" mediatype="image">
<h2>Ship entire sites from your IDE</h2>
<p>Define pages, blocks, and patterns as files. Blockstudio handles the rest.</p>
</block>
<div>
<h2>Frequently asked questions</h2>
<details>
<summary>Do I need to learn React?</summary>
<p>No. Templates are PHP. Fields are JSON. Interactivity is optional.</p>
</details>
<details>
<summary>Does it work with my existing theme?</summary>
<p>Yes. Drop a blockstudio folder into any theme and start creating blocks.</p>
</details>
</div>
<div>
<block name="core/buttons">
<block name="core/button" url="/get-started">Start Building</block>
</block>
</div>
Tällä sivulla on kansikuvaosio, kolmen sarakkeen ominaisuusruudukko, media- ja tekstiosio, UKK-haitarit sekä CTA. Kaikki yhdessä HTML-tiedostossa. Kohdassa page.json oleva templateLock: "all" tarkoittaa, ettei asiakas voi muuttaa mitään. Seuraavassa osiossa kerrotaan, miten rajoituksia voi höllentää.
Editorin hallinta
Tässä tiedostopohjaiset sivut pääsevät todella oikeuksiinsa. Blockstudio tarjoaa kaksi toisistaan riippumatonta hallintakeinoa: mallipohjan lukitus ja lohkojen muokkaustila. Yhdessä niiden avulla voit määrittää tarkasti, mitä sivun osia asiakkaat voivat muokata. Lukitse rakenne mutta anna heidän muokata tekstiä. Jäädytä jotkin osiot ja jätä toiset täysin avoimiksi. Luo sivu, jolla asiakas voi kirjoittaa vain kolmeen tiettyyn otsikkoon.
Mallipohjan lukitus
templateLock-ominaisuus kohteessa page.json ohjaa rakenteen muokkausta: sitä, voiko lohkoja lisätä, poistaa tai järjestellä uudelleen.
"all" (oletus)
{
"name": "terms",
"templateLock": "all"
}
Tiukin lukitus. Asiakkaat eivät voi lisätä, poistaa tai siirtää lohkoja. He eivät myöskään voi muokata lohkojen sisältöä (ellei tätä yhdistetä asetukseen blockEditingMode). Tämä on oletus, jos arvoa ei määritetä.
Milloin käyttää: lakisivuilla, käyttöehdoissa ja tietosuojakäytännöissä. Kaikilla sivuilla, joiden sisällön pitäisi muuttua vain koodin kautta.
"insert"
{
"name": "about",
"templateLock": "insert"
}
Asiakkaat eivät voi lisätä tai poistaa lohkoja, mutta he voivat siirtää olemassa olevia lohkoja ja muokata niiden sisältöä. Lohkojen määrä pysyy samana, mutta järjestys on vapaa.
Milloin käyttää: sivuilla, joille haluat kiinteän osiojoukon mutta joilla asiakkaan pitäisi voida järjestää osiot uudelleen. Esimerkiksi portfoliosivu, jolla osioiden määrä on ennalta määrätty mutta asiakas päättää niiden järjestyksen.
"contentOnly"
{
"name": "homepage",
"templateLock": "contentOnly"
}
Asiakkaat voivat muokata tekstisisältöä mutta eivät lisätä, poistaa tai siirtää lohkoja. Erona asetukseen "all" on se, että "all" estää myös sisällön muokkaamisen, kun taas "contentOnly" sallii sen nimenomaisesti.
Milloin käyttää: yleisin valinta asiakkaille näkyville sivuille. Kehittäjä hallitsee asettelua. Asiakas täyttää tekstin.
false
{
"name": "blog",
"templateLock": false
}
Ei lukitusta. Asiakkaat hallitsevat kaikkea: he voivat lisätä, poistaa, siirtää ja muokata mitä tahansa lohkoa. Mallipohja tarjoaa lähtörakenteen, mutta siitä eteenpäin asiakas vastaa sivusta.
Milloin käyttää: blogin etusivuilla, vapaamuotoisilla sisältösivuilla tai millä tahansa sivulla, jolla asiakkaalla pitäisi olla täysi toimituksellinen vapaus.
Lohkojen muokkaustila
Siinä missä templateLock ohjaa rakennetta (lisääminen, poistaminen ja siirtäminen), blockEditingMode ohjaa yksittäisten lohkojen käyttöä: voiko lohkoja ylipäätään valita, määrittää tai muokata.
Aseta sivutason oletusarvo kohdassa page.json:
{
"name": "landing",
"templateLock": "all",
"blockEditingMode": "disabled"
}
"default"
Täysi muokkausoikeus. Lohkoja voi valita, niiden asetuksia muuttaa ja sisältöä muokata. Tämä on editorin normaali käyttötapa.
"contentOnly"
Lohkoja voi muokata, mutta vain niiden tekstisisältöä. Lohkon asetuksia ei voi avata, värejä vaihtaa, sisennyksiä säätää eikä muita kuin sisältöön liittyviä määritteitä muuttaa. Lohkon työkalurivillä näkyvät vain tekstin muotoiluasetukset.
"disabled"
Lohkot eivät ole lainkaan vuorovaikutteisia. Ne näkyvät editorissa, mutta niitä ei voi napsauttaa, valita tai muokata millään tavalla. Asiakas näkee sisällön mutta ei voi muokata sitä.
Elementtikohtaiset ohitukset
Tässä asia muuttuu kiinnostavaksi. Sivutason blockEditingMode asettaa oletuksen kaikille sivun lohkoille, mutta voit ohittaa sen mallipohjan yksittäisissä elementeissä:
{
"name": "landing",
"templateLock": "all",
"blockEditingMode": "disabled"
}
<block name="core/cover" url="https://example.com/hero.jpg">
<h1 blockEditingMode="contentOnly">Edit This Heading</h1>
<p blockEditingMode="contentOnly">Edit this paragraph too.</p>
</block>
<div>
<h2>Features</h2>
<p>This paragraph cannot be edited (inherits "disabled").</p>
<p blockEditingMode="contentOnly">But this one can.</p>
</div>
<block name="core/buttons">
<block name="core/button" url="/contact">This button is frozen</block>
</block>
Sivun oletus on "disabled", joten kaikki lohkot ovat aluksi vuorovaikutuksettomia. Tietyissä elementeissä otetaan sitten käyttöön "contentOnly", jolloin vain niiden tekstiä voi muokata. Tuloksena on sivu, jolla asiakas voi kirjoittaa täsmälleen kahteen tekstikenttään (pääosan otsikkoon ja kappaleeseen) sekä yhteen ominaisuuskappaleeseen. Kaikki muu on lukittu.
Tämä toimii kaikissa HTML-elementeissä (<h1>, <p>, <div> jne.) ja <block>-elementeissä. Voit myös asettaa blockEditingMode="default" tietyille elementeille, jolloin ne ovat täysin muokattavissa:
<block name="core/buttons" blockEditingMode="default">
<block name="core/button" url="/contact">Fully editable button</block>
</block>
Nyt asiakas voi muuttaa painikkeen tekstiä, URL-asetusta, tyylejä ja muita asetuksia. Kaikki muu sivulla pysyy lukittuna.
Ylemmiltä lohkoilta periytyvä ketju
Elementtikohtaisten ohitusten ja säilölohkojen yhteisvaikutuksessa on tärkeä yksityiskohta. Jos sivun oletus on "disabled" ja asetat ryhmän sisällä olevalle otsikolle asetuksen blockEditingMode="contentOnly", otsikon on oltava saavutettavissa. Sen emoryhmä on kuitenkin asetuksessa "disabled", joten sitä ei voi avata lainkaan.
Blockstudio hoitaa tämän automaattisesti. Kun alilohkolla on muokkaustilan ohitus, kaikkien sen ylempien lohkojen asetukseksi tulee "contentOnly", jotta alilohko pysyy käytettävissä. Ylätason säilöille ei tarvitse asettaa tiloja käsin. Aseta ohitus vain lohkolle, jota haluat voida muokata, niin reitti siihen avautuu.
<!-- page default: "disabled" -->
<div>
<!-- this group is auto-set to "contentOnly" because it contains an override -->
<div>
<!-- this group is also auto-set to "contentOnly" -->
<p blockEditingMode="contentOnly">Deeply nested but still editable.</p>
</div>
</div>
Ylemmiltä lohkoilta periytyvä ketju muuttaa säilöjen tilaksi vain "contentOnly", ei koskaan asetusta "default". Näin ylemmissä ryhmissä voi liikkua (ne voi avata), mutta niitä ei voi muokata kokonaan (niiden asetuksia ei voi muuttaa).
Valintamatriisi
Kun yhdistät asetukset templateLock ja blockEditingMode, saat käyttöösi erilaisia hallintatasoja. Tässä hyödyllisimmät yhdistelmät:
Kehittäjä hallitsee kaikkea
{ "templateLock": "all" }
Asetusta blockEditingMode ei tarvita. Oletusasetus templateLock: "all" estää kaikki muutokset. Käytä tätä sivuilla, joita hallitaan kokonaan koodin kautta.
Asiakas muokkaa kaikkea tekstiä
{ "templateLock": "contentOnly" }
Asiakas voi muokata minkä tahansa lohkon tekstiä mutta ei sivun rakennetta. Yksinkertainen ja salliva vaihtoehto.
Asiakas muokkaa vain tiettyjä tekstejä
{
"templateLock": "all",
"blockEditingMode": "disabled"
}
Yhdistä tähän mallipohjan tietyissä elementeissä asetus blockEditingMode="contentOnly". Tämä on tarkin vaihtoehto: asiakas voi muokata vain juuri niitä lohkoja, jotka merkitset.
Asiakas järjestää kiinteät osiot uudelleen
{ "templateLock": "insert" }
Asiakas voi järjestää osiot uudelleen ja muokata sisältöä, mutta ei lisätä tai poistaa lohkoja. Sopii sivuille, joilla on kiinteä määrä osioita mutta vapaa järjestys.
Asiakas hallitsee kaikkea
{ "templateLock": false }
Mallipohja toimii lähtökohtana. Sen jälkeen asiakas voi tehdä mitä haluaa.
Asiakkaan muokkausten säilyttäminen
Oletuksena mallipohjatiedoston päivittäminen korvaa Blockstudio-toiminnolla koko sivun sisällön. Jos asiakas on muokannut otsikkoa editorissa, muutos katoaa seuraavan synkronoinnin jälkeen. Tämä sopii kehittäjän hallitsemille sivuille, mutta asiakkaiden sisältöä sisältävillä sivuilla tarvitaan tapa säilyttää heidän työnsä.
Avaimet
Lisää mihin tahansa elementtiin key-määrite, jotta se yhdistetään korvaamisen sijaan:
<block name="core/cover" key="hero" url="https://example.com/hero.jpg">
<h1>Default Hero Title</h1>
<p>Default hero description.</p>
</block>
<div key="features">
<h2>Features</h2>
<p>Feature introduction text.</p>
</div>
<div>
<h2>Unkeyed Section</h2>
<p>This gets replaced on every sync.</p>
</div>
Kun mallipohja muuttuu ja sivu synkronoidaan uudelleen:
- Avaimilla merkityt lohkot säilyttävät asiakkaan sisällön (teksti, sisälohkot ja muotoilun). Mallipohjan rakenteelliset määritteet (kuten kansilohkon
url) päivittyvät silti. - Ilman avainta olevat lohkot korvataan kokonaan mallipohjan versiolla.
Avain suojaa koko lohkon ja kaikki sen alilohkot. Avaimilla merkittyyn ryhmään kuuluvia yksittäisiä kappaleita ei tarvitse merkitä erikseen. Ryhmän avain kattaa kaiken sen sisällä.
Avainten on oltava yksilöllisiä
Avainten on oltava yksilöllisiä koko mallipohjassa. Jos kahdella elementillä on sama avain, jälkimmäistä käsitellään kuin sillä ei olisi avainta (ja PHP-varoitus näytetään). Käytä kuvaavia nimiä: "hero", "features", "cta", "testimonial-section".
Mallipohjien kehittäminen
Avainten avulla voit lisätä mallipohjaan uusia osioita häiritsemättä asiakkaan olemassa olevaa sisältöä:
<h1 key="title">Welcome</h1>
<div key="services">
<h2>Our Services</h2>
<p>We do great work.</p>
</div>
<h1 key="title">Welcome</h1>
<div key="services">
<h2>Our Services</h2>
<p>We do great work.</p>
</div>
<div key="testimonials">
<h2>What Clients Say</h2>
<p>Default testimonial text.</p>
</div>
Synkronoinnin jälkeen otsikko ja palvelut säilyttävät asiakkaan tekemät muokkaukset. Uusi suositteluosio tulee näkyviin mallipohjan oletussisällöllä. Jos poistat myöhemmin mallipohjasta avaimella merkityn lohkon, se poistetaan myös sivulta.
Asiakkaan koko työnkulku
Kootaan tämä yhteen todellisen projektin avulla:
{
"name": "homepage",
"title": "Home",
"slug": "home",
"postStatus": "publish",
"templateLock": "all",
"blockEditingMode": "disabled"
}
<block name="core/cover" key="hero" url="https://example.com/hero.jpg">
<h1 blockEditingMode="contentOnly">Your Company Name</h1>
<p blockEditingMode="contentOnly">Your tagline goes here.</p>
<block name="core/buttons">
<block name="core/button" url="/contact">Contact Us</block>
</block>
</block>
<div key="features">
<h2 blockEditingMode="contentOnly">What We Do</h2>
<block name="core/columns">
<block name="core/column">
<h3 blockEditingMode="contentOnly">Service One</h3>
<p blockEditingMode="contentOnly">Describe this service.</p>
</block>
<block name="core/column">
<h3 blockEditingMode="contentOnly">Service Two</h3>
<p blockEditingMode="contentOnly">Describe this service.</p>
</block>
<block name="core/column">
<h3 blockEditingMode="contentOnly">Service Three</h3>
<p blockEditingMode="contentOnly">Describe this service.</p>
</block>
</block>
</div>
<block name="core/media-text" key="about" mediaurl="https://example.com/team.jpg" mediatype="image">
<h2 blockEditingMode="contentOnly">About Us</h2>
<p blockEditingMode="contentOnly">Tell your story here.</p>
</block>
<div key="cta">
<h2 blockEditingMode="contentOnly">Ready to get started?</h2>
<block name="core/buttons">
<block name="core/button" url="/contact">Get in Touch</block>
</block>
</div>
Tällä sivulla on neljä avaimella merkittyä osiota. Asiakas voi muokata otsikoita ja kappaleita, jotka on merkitty asetuksella blockEditingMode="contentOnly", ja muutokset säilyvät mallipohjan päivityksissä. Kehittäjä hallitsee asettelua, kuvia, painikkeiden URL-osoitteita ja koko rakennetta. Jos kehittäjä lisää myöhemmin suositteluosion kohtien ”about” ja ”cta” väliin, se tulee näkyviin seuraavassa synkronoinnissa häiritsemättä asiakkaan tekstejä.
Lohkosidokset: vaihtoehto avaimille
WordPress 6.5 toi mukanaan lohkojen sidokset API, jotka yhdistävät lohkojen määritteet julkaisun metatietoihin. Sen sijaan, että muokattava sisältö tallennettaisiin lohkomerkintään (jossa avaimet suojaavat sitä), sisältö tallennetaan kohteeseen wp_postmeta (johon mallipohjan synkronointi ei ulotu).
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
Default Title
</h1>
<p metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_description"}}}}'>
Default description.
</p>
Meta-avaimet on rekisteröitävä kohteessa PHP:
register_post_meta( 'page', 'hero_title', array(
'show_in_rest' => true,
'single' => true,
'type' => 'string',
'default' => 'Default Title',
) );
Lohkosidoksilla on kaksi etua avaimiin verrattuna: tietoja voi hakea WP_Query-toiminnolla kohteen meta_query kautta, ja ne ovat käytettävissä kohteessa REST API. Haittapuolena on, että jokainen meta-avain on rekisteröitävä kohteessa PHP, ja sidokset toimivat vain yksittäisissä lohkomääritteissä (eivät monimutkaisessa sisäkkäisessä sisällössä).
Käytä avaimia sisältörikkaissa osioissa, joissa lohkorakenne on tärkeä (ryhmä, jossa on otsikoita, kappaleita ja kuvia). Käytä sidoksia yksittäisille tekstiarvoille, joita sinun täytyy myös hakea tai näyttää muualla.
Artikkelityypin mallipohjat
Aseta kohteessa templateFor oletuslohkorakenne kaikille tietyn tyypin uusille julkaisuille:
{
"name": "product-template",
"title": "Product Template",
"templateFor": "product",
"templateLock": "insert"
}
<h1>Product Name</h1>
<block name="core/columns">
<block name="core/column">
<img src="" alt="Product image" />
</block>
<block name="core/column">
<p>Product description goes here.</p>
<block name="core/buttons">
<block name="core/button" url="#">Buy Now</block>
</block>
</block>
</block>
<div>
<h2>Specifications</h2>
<table>
<thead>
<tr><th>Feature</th><th>Value</th></tr>
</thead>
<tbody>
<tr><td>Weight</td><td>1.2 kg</td></tr>
</tbody>
</table>
</div>
Jokainen uusi ”product”-julkaisu alkaa tällä rakenteella. Asetus templateLock: "insert" sallii muokkaajien järjestää osiot uudelleen ja muokata sisältöä, mutta ei lisätä tai poistaa lohkoja.
Vinkkejä
Synkronoi tarkoituksellisessa käyttöönottovaiheessa. Suorita wp bs pages sync sivulähteiden muuttamisen tai käyttöönoton jälkeen. Frontendin ja ylläpidon sivukäynnit eivät synkronoi sivuja. PHP-käyttöönottotyökalut voivat kutsua toimintoa Blockstudio\Pages::reconcile() ja tarkastella sen koneluettavaa raporttia.
Kiinnitä tärkeät julkaisujen tunnisteet. Käytä asetusta postId kohteessa page.json sivuille, joihin valikot, kovakoodatut linkit tai ulkoiset järjestelmät viittaavat. Ilman kiinnitystä poistettu ja uudelleen luotu sivu saa uuden tunnisteen, mikä rikkoo nämä viittaukset.
Käytä asetusta sync: false runkoihin. Jos haluat luoda sivun kerran ja luovuttaa sen sitten kokonaan asiakkaalle, aseta "sync": false ja luo sivu toiminnolla Blockstudio\Pages::force_sync(). Tavallinen täsmäytys ohittaa sen tämän jälkeen.
Lukitse ja avaa lukitus toiminnolla PHP. Estä tietyn sivun synkronointi kutsumalla toimintoa Blockstudio\Pages::lock('about') (hyödyllistä asiakkaan muokkausjaksojen aikana). Ota synkronointi uudelleen käyttöön kutsumalla toimintoa Blockstudio\Pages::unlock('about').
Mallinnuskielet. Kohteen PHP lisäksi mallipohjia voi kirjoittaa kielellä Twig (vaatii riippuvuudet Timber) tai kielellä Blade (vaatii riippuvuudet illuminate/view). Tämä on hyödyllistä silmukoissa ja suodattimissa, mutta sivumallipohjat käännetään eksplisiittisen synkronoinnin aikana, ei frontend-pyynnön aikana. Käytä PHP-ratkaisua, jos jo lähdekoodin käännös tarvitsee vain PHP-avustajia.
Pakotettu synkronointi ohittaa avaimet. Toiminnon Pages::force_sync('about') kutsuminen korvaa koko sivun sisällön ja ohittaa avaimet sekä muokkausajantarkistukset. Käytä sitä, kun haluat tarkoituksella palauttaa sivun mallipohjan mukaiseksi.
Seuraavat vaiheet
- Sivujen viite: kaikki
page.json-ominaisuudet, PHP API ja avaimiin perustuva yhdistämisalgoritmi yksityiskohtaisesti. - Sivut ja kuviot -yleiskatsaus: HTML-jäsennin, lohkojen syntaksiviite, mukautetut renderöijät ja elementtien vastaavuudet.
- Kuviot: sama mallipohjasyntaksi uudelleenkäytettäville lohkokuvioille sivujen sijaan.