Ugrás a tartalomhoz

Fájlalapú oldalak készítése

A hagyományos WordPress oldalkészítés a blokkszerkesztőben zajlik: blokkok húzása, beállítások megadása, mentésre kattintás. Ez jól működik, ha az ügyfelek saját oldalaikat építik, de problémákat okoz a strukturált, verziókövetett oldalakat készítő fejlesztőknek. Az oldalelrendezés az adatbázisban él, nem a kódban. Nem tekintheti át pull requestben, nem állíthatja vissza gittel, és nem reprodukálhatja új telepítésen.

A Blockstudio fájlalapú oldalai megoldják ezt. Az oldalakat a témában lévő fájlokként definiálja, HTML sablonokat ír, amelyek WordPress blokkokká alakulnak, és pontosan szabályozza, mit szerkeszthetnek az ügyfelek. Egy explicit parancs szinkronizálja ezeket a fájlokat a szokásos WordPress bejegyzésekbe; a sablonok maradnak az igazság forrásai.

Ez az útmutató végigvezeti az oldalépítés teljes folyamatán, különös tekintettel azokra a rögzítési és szerkesztési beállításokra, amelyek praktikussá teszik a fájlalapú oldalakat az ügyfélprojektekben.

Az első oldal

Hozzon létre egy pages mappát a témájában, majd adjon hozzá egy almappát két fájllal:

Kód
theme/
└── pages/
    └── about/
        ├── page.json
        └── index.php
JSON
{
  "name": "about",
  "title": "About Us",
  "postStatus": "publish"
}
HTML
<h1>About Us</h1>
<p>We build things for the web.</p>

Futtassa az oldalak szinkronizálására szolgáló parancsot:

Shell
wp bs pages sync

A Blockstudio elem feldolgozza a HTML fájlt WordPress blokkokká, majd létrehoz egy “About Us” nevű, about slugú oldalt. Nyissa meg a szerkesztőben: egy címsort és egy bekezdést lát, pontosan úgy, mintha kézzel adta volna hozzá őket.

Szerkessze a index.php fájlt, módosítsa a szöveget, majd futtassa újra a parancsot. Töltse újra a szerkesztőt a frissítés megtekintéséhez. Ez az alapvető munkafolyamat: írjon HTML, szinkronizáljon tudatosan, és megkapja a blokkokat.

A sablonnyelv

A Blockstudio HTML elemzője a szabványos HTML elemeket WordPress blokkokká alakítja. Írjon egy <p> elemet, és bekezdésblokkot kap. Írjon egy <h2> elemet, és címsorblokkot kap. A leképezés magától értetődő:

HTML Blokk
<p> Bekezdés
<h1>–<h6> Címsor (a szint megfelel a címkének)
<ul>, <ol> Lista
<blockquote> Idézet
<img> Kép
<div>, <section> Csoport
<hr> Elválasztó
<details> Részletek
<table> Táblázat

A közvetlen HTML megfelelő nélküli blokkokhoz használja a <block> elemet egy name attribútummal:

HTML
<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>

A <block> elemek attribútumai blokkattribútumként kerülnek továbbításra. Az értékek automatikusan típuskonverzión esnek át: a "true" logikai értékké, a "3" egész számmá alakul, az olyan JSON karakterláncok pedig, mint a '{"type":"flex"}', objektummá dekódolódnak.

Elrendezések

A csoportok az layout attribútummal különböző elrendezési módokat támogatnak:

HTML
<!-- 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>

Egyéni blokkok

A <block> szintaxis minden regisztrált blokknál működik, beleértve a saját Blockstudio blokkokat is:

HTML
<block name="my-theme/hero" title="Welcome" background="dark" />
<block name="my-theme/testimonial" quote="Great product." author="Jane" />

Az attribútumok automatikusan a blokk Blockstudio mezőértékeihez rendelődnek.

Landing oldal készítése

Íme egy teljes landing oldal, amely strukturáláshoz és elrendezéshez alapblokkokat használ:

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "slug": "landing",
  "postStatus": "publish",
  "templateLock": "all"
}
HTML
<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>

Ez az oldal egy hero borítóval, háromoszlopos funkciórácscsal, média-szöveg szakasszal, lenyíló GYIK-elemekkel és CTA-val rendelkezik. Mindez egyetlen HTML fájlból. A templateLock: "all" a page.json helyen azt jelenti, hogy az ügyfél semmit sem módosíthat. A következő szakasz bemutatja, hogyan enyhíthet ezen a korlátozáson.

A szerkesztő vezérlése

Itt válnak igazán hatékonnyá a fájlalapú oldalak. A Blockstudio két egymástól független vezérlési lehetőséget kínál: a sablonzárolást és a blokkszerkesztési módot. Ezekkel pontosan meghatározhatja, hogy az ügyfelek az oldal mely részeit módosíthatják. Zárolja a szerkezetet, de engedje a szöveg szerkesztését. Fagyasszon be bizonyos szakaszokat, miközben másokat teljesen szabaddá tesz. Készítsen olyan oldalt, amelyen az ügyfél kizárólag három meghatározott címsorba írhat.

Sablonzárolás

A page.json templateLock tulajdonsága a szerkezet szerkesztését szabályozza: hogy a blokkok hozzáadhatók, eltávolíthatók vagy átrendezhetők-e.

"all" (alapértelmezett)

JSON
{
  "name": "terms",
  "templateLock": "all"
}

A legszigorúbb zárolás. Az ügyfelek nem adhatnak hozzá, nem távolíthatnak el és nem helyezhetnek át blokkokat. A blokktartalmat sem szerkeszthetik (kivéve, ha a blockEditingMode beállítással együtt használják). Ez az alapértelmezés, ha nem ad meg értéket.

Mikor használja: Jogi oldalakhoz, szolgáltatási feltételekhez és adatvédelmi szabályzatokhoz. Bármely olyan oldalhoz, amelynek tartalma csak kóddal módosítható.

"insert"

JSON
{
  "name": "about",
  "templateLock": "insert"
}

Az ügyfelek nem adhatnak hozzá és nem távolíthatnak el blokkokat, de áthelyezhetik a meglévőket és szerkeszthetik a tartalmukat. A blokkok száma állandó, a sorrendjük viszont módosítható.

Mikor használja: Olyan oldalakhoz, ahol rögzített szakaszokat szeretne, de azt is, hogy az ügyfél átrendezhesse őket. Például egy portfólióoldalhoz, ahol előre meghatározott a szakaszok száma, de az ügyfél dönt a sorrendjükről.

"contentOnly"

JSON
{
  "name": "homepage",
  "templateLock": "contentOnly"
}

Az ügyfelek szerkeszthetik a szöveges tartalmat, de nem adhatnak hozzá, nem távolíthatnak el és nem helyezhetnek át blokkokat. A "all" beállítástól az különbözteti meg, hogy a "all" a tartalomszerkesztést is megakadályozza, a "contentOnly" viszont kifejezetten engedélyezi.

Mikor használja: Ez a leggyakoribb választás ügyfeleknek szánt oldalakhoz. A fejlesztő szabályozza az elrendezést, az ügyfél pedig kitölti a szöveget.

false

JSON
{
  "name": "blog",
  "templateLock": false
}

Nincs zárolás. Az ügyfelek teljes szabadságot kapnak: bármelyik blokkot hozzáadhatják, eltávolíthatják, áthelyezhetik és szerkeszthetik. A sablon kiindulási szerkezetet ad, utána az ügyfél rendelkezik felette.

Mikor használja: Blogindexoldalakhoz, kötetlen tartalmi oldalakhoz, vagy bármely olyan oldalhoz, ahol teljes szerkesztési szabadságot szeretne adni az ügyfélnek.

Blokkszerkesztési mód

Míg a templateLock a szerkezetet szabályozza (hozzáadás, eltávolítás, áthelyezés), a blockEditingMode az egyes blokkokkal való interakciót: hogy a blokkok kiválaszthatók, beállíthatók vagy egyáltalán szerkeszthetők-e.

Állítson be alapértelmezett értéket az oldal szintjén a page.json segítségével:

JSON
{
  "name": "landing",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}

"default"

Teljes szerkesztési lehetőség. A blokkok kiválaszthatók, beállításaik módosíthatók, tartalmuk pedig szerkeszthető. Ez a szokásos szerkesztői élmény.

"contentOnly"

A blokkok szerkeszthetők, de csak a szöveges tartalmuk. Nem nyithatja meg a blokkbeállításokat, nem módosíthat színeket vagy térközöket, és más tartalmi attribútumokat sem változtathat meg. A blokk eszköztárán csak szövegformázási lehetőségek jelennek meg.

"disabled"

A blokkok egyáltalán nem interaktívak. Megjelennek a szerkesztőben, de nem kattinthatók, nem választhatók ki és semmilyen módon nem módosíthatók. Az ügyfél látja a tartalmat, de nem nyúlhat hozzá.

Elemenkénti felülbírálás

Itt válik igazán érdekessé a dolog. Az oldal szintű blockEditingMode alapértelmezett értéket állít be az oldal összes blokkjához, de a sablon egyes elemeinél felülbírálhatja:

JSON
{
  "name": "landing",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}
HTML
<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>

Az oldal alapértelmezett értéke "disabled", ezért minden blokk nem interaktívként indul. Ezután egyes elemeknél engedélyezze a "contentOnly" módot, így csak a szövegük lesz szerkeszthető. Az eredmény: az ügyfél pontosan két szövegmezőbe (a kiemelt címsorba és bekezdésbe), valamint egy jellemzőt bemutató bekezdésbe írhat. Minden más zárolva marad.

Ez bármely HTML elemen működik (<h1>, <p>, <div> stb.), valamint <block> elemeken is. Egyes elemeknél a blockEditingMode="default" beállítással teljes szerkesztési hozzáférést is adhat:

HTML
<block name="core/buttons" blockEditingMode="default">
  <block name="core/button" url="/contact">Fully editable button</block>
</block>

Az ügyfél most már módosíthatja a gomb feliratát, a URL-t, a stílusokat és minden más beállítást. Az oldal többi része változatlan marad.

Ősök kaszkádja

Fontos részlet, hogy az elemenkénti felülbírálások hogyan hatnak az összefoglaló blokkokra. Ha az oldal alapértelmezett értéke "disabled", és egy csoporton belüli címsornál beállítja a blockEditingMode="contentOnly" módot, a címsornak elérhetőnek kell lennie. A szülőcsoport viszont "disabled" módban van, ezért egyáltalán nem nyitható meg.

A Blockstudio ezt automatikusan kezeli. Ha egy gyermekblokk szerkesztési módját felülbírálja, az összes őse a "contentOnly" módot kapja, így a gyermek elérhető marad. Nem kell kézzel beállítania a szülő konténerek módját. Csak a szerkeszthetővé tenni kívánt blokk felülbírálását állítsa be, és az odavezető út megnyílik.

HTML
<!-- 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>

Az ősök kaszkádja a konténereket csak "contentOnly" módra emeli, "default" módra soha. Így az őscsoportok bejárhatók lesznek (megnyithatja őket), de teljesen nem szerkeszthetők (a beállításaik nem módosíthatók).

Döntési táblázat

A templateLock és a blockEditingMode kombinálásával a vezérlés számos szintje áll rendelkezésére. Íme a leghasznosabb kombinációk:

A fejlesztő mindent szabályoz

JSON
{ "templateLock": "all" }

Nincs szükség blockEditingMode beállításra. Az alapértelmezett templateLock: "all" minden módosítást megakadályoz. Használja ezt a teljes egészében kóddal kezelt oldalakhoz.

Az ügyfél az összes szöveget szerkesztheti

JSON
{ "templateLock": "contentOnly" }

Az ügyfél bármelyik blokk szövegét szerkesztheti, de az oldal szerkezetét nem módosíthatja. Egyszerű és rugalmas megoldás.

Az ügyfél csak bizonyos szövegeket szerkeszthet

JSON
{
  "templateLock": "all",
  "blockEditingMode": "disabled"
}

A sablon egyes elemeinél beállított blockEditingMode="contentOnly" móddal kombinálva. Ez a legpontosabb lehetőség: az ügyfél csak az Ön által kijelölt blokkokat szerkesztheti.

Az ügyfél átrendezheti a rögzített szakaszokat

JSON
{ "templateLock": "insert" }

Az ügyfél átrendezheti a szakaszokat és szerkesztheti a tartalmat, de nem adhat hozzá és nem törölhet blokkokat. Jó választás rögzített számú, szabadon rendezhető szakaszt tartalmazó oldalakhoz.

Az ügyfél teljes szabadságot kap

JSON
{ "templateLock": false }

A sablon kiindulópontot ad, onnantól az ügyfél bármit megtehet.

Az ügyfél módosításainak megőrzése

Alapértelmezés szerint egy sablonfájl frissítésekor a Blockstudio lecseréli az oldal teljes tartalmát. Ha az ügyfél módosított egy címsort a szerkesztőben, a következő szinkronizálás után elveszik a módosítás. Ez megfelelő a fejlesztő által kezelt oldalaknál, de ha az ügyfelek is hozzáadnak tartalmat, szükség van a munkájuk megőrzésére.

Kulcsok

Adjon hozzá key attribútumot bármely elemhez, hogy a rendszer lecserélés helyett egyesítse:

HTML
<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>

Amikor a sablon megváltozik, és az oldal újraszinkronizálódik:

  • A kulccsal ellátott blokkok megőrzik az ügyfél tartalmát (szövegét, belső blokkjait, formázását). A sablon szerkezeti attribútumai (például a borítókép url attribútuma) továbbra is frissülnek.
  • A kulcs nélküli blokkok teljes egészében a sablon változatára cserélődnek.

A kulcs a teljes blokkot és annak összes gyermekét védi. Nem kell külön kulcsot adnia a kulccsal ellátott csoporton belüli bekezdéseknek. A csoport kulcsa mindent lefed, ami benne van.

A kulcsoknak egyedinek kell lenniük

A kulcsoknak a teljes sablonban egyedinek kell lenniük. Ha két elem azonos kulcsot kap, a második kulcs nélküliként lesz kezelve (és a rendszer PHP figyelmeztetést ad). Használjon beszédes neveket: "hero", "features", "cta", "testimonial-section".

A sablonok továbbfejlesztése

A kulcsok segítségével új szakaszokat adhat a sablonhoz a meglévő ügyféltartalom megzavarása nélkül:

HTML
<h1 key="title">Welcome</h1>
<div key="services">
  <h2>Our Services</h2>
  <p>We do great work.</p>
</div>
HTML
<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>

Szinkronizáláskor a cím és a szolgáltatások megőrzik az ügyfél módosításait. Az új, ajánlásokat tartalmazó szakasz a sablon alapértelmezett tartalmával jelenik meg. Ha később eltávolít egy kulccsal ellátott blokkot a sablonból, az az oldalról is törlődik.

A teljes ügyfél-munkafolyamat

Így áll össze mindez egy valódi projektté:

JSON
{
  "name": "homepage",
  "title": "Home",
  "slug": "home",
  "postStatus": "publish",
  "templateLock": "all",
  "blockEditingMode": "disabled"
}
HTML
<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>

Ezen az oldalon négy kulccsal ellátott szakasz található. Az ügyfél szerkesztheti a blockEditingMode="contentOnly" jelölésű címsorokat és bekezdéseket, és ezek a módosítások a sablon frissítései után is megmaradnak. A fejlesztő szabályozza az elrendezést, a képeket, a gombok URL-jeit és a teljes szerkezetet. Ha a fejlesztő később hozzáad egy ajánlásokat tartalmazó szakaszt az „about” és a „cta” közé, az a következő szinkronizáláskor megjelenik, és nem módosítja az ügyfél szövegeit.

Blokkhozzárendelések: a kulcsok alternatívája

A WordPress 6.5 bevezette a Blokkhozzárendeléseket API, amelyek a blokk attribútumait a bejegyzés metaadataihoz kapcsolják. Ahelyett, hogy a szerkeszthető tartalmat a blokkjelölésben tárolná (ahol a kulcsok védik), a tartalom a wp_postmeta helyen kap helyet (ahol a sablonszinkronizálások nem módosíthatják).

HTML
<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>

A metaadatkulcsokat regisztrálni kell a PHP segítségével:

PHP
register_post_meta( 'page', 'hero_title', array(
    'show_in_rest' => true,
    'single'       => true,
    'type'         => 'string',
    'default'      => 'Default Title',
) );

A blokkhozzárendelések két előnnyel járnak a kulcsokhoz képest: az adatok lekérdezhetők WP_Query segítségével, a meta_query útján, és elérhetők a REST API felületen. Cserébe minden metaadatkulcsot regisztrálni kell a PHP segítségével, a hozzárendelések pedig csak egyes blokkattribútumokon működnek (összetett, beágyazott tartalmakon nem).

Használjon kulcsokat olyan gazdag tartalmú szakaszokhoz, ahol fontos a blokkszerkezet (például címsorokat, bekezdéseket és képeket tartalmazó csoportoknál). Hozzárendeléseket olyan egyedi szövegértékekhez használjon, amelyeket le is szeretne kérdezni vagy máshol megjeleníteni.

Bejegyzéstípus-sablonok

A templateFor segítségével állítson be alapértelmezett blokkszerkezetet egy adott típusú összes új bejegyzéshez:

JSON
{
  "name": "product-template",
  "title": "Product Template",
  "templateFor": "product",
  "templateLock": "insert"
}
HTML
<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>

Minden új „product” bejegyzés ezzel a szerkezettel indul. A templateLock: "insert" lehetővé teszi a szerkesztőknek a szakaszok átrendezését és a tartalom módosítását, a blokkok hozzáadását és eltávolítását viszont nem.

Tippek

Szinkronizáljon egy előre meghatározott telepítési ponton. Az oldal forrásának módosítása vagy telepítése után futtassa a wp bs pages sync parancsot. A frontend és az adminfelület meglátogatása soha nem szinkronizálja az oldalakat. A PHP telepítési eszközök meghívhatják a Blockstudio\Pages::reconcile() függvényt, és ellenőrizhetik annak géppel olvasható jelentését.

Rögzítse a fontos bejegyzésazonosítókat. Használja a postId beállítást a page.json helyen azokhoz az oldalakhoz, amelyekre menük, kódba írt hivatkozások vagy külső rendszerek hivatkoznak. Rögzítés nélkül egy törölt, majd újra létrehozott oldal új azonosítót kap, így ezek a hivatkozások megszakadnak.

Használja a sync: false beállítást kiindulási oldalakhoz. Ha egyszer szeretne létrehozni egy oldalt, majd teljes egészében átadni az ügyfélnek, állítsa be a "sync": false értéket, és hozza létre a Blockstudio\Pages::force_sync() segítségével. A normál egyeztetés ezután figyelmen kívül hagyja.

Zárolja és oldja fel a PHP segítségével. Az Blockstudio\Pages::lock('about') meghívásával megakadályozhatja egy adott oldal szinkronizálását (ez hasznos az ügyfél szerkesztési időszakaiban). Az Blockstudio\Pages::unlock('about') meghívásával újra engedélyezheti a szinkronizálást.

Sablonmotorok. A PHP mellett a sablonok Twig használatával is megírhatók (ehhez szükséges: Timber), vagy Blade használatával (ehhez szükséges: illuminate/view). Ez hurkokhoz és szűrőkhöz hasznos, az oldalsablonok azonban csak kifejezett szinkronizáláskor fordulnak le, nem a frontendkérés során. Maradjon a PHP használatánál, ha a forrás fordításához magához PHP-specifikus segédfüggvényekre van szüksége.

A kényszerített szinkronizálás figyelmen kívül hagyja a kulcsokat. A Pages::force_sync('about') meghívása lecseréli az oldal teljes tartalmát, figyelmen kívül hagyva a kulcsokat és a módosítási idő ellenőrzését. Akkor használja, ha szándékosan vissza szeretné állítani az oldalt a sablon állapotára.

Következő lépések

  • Oldalhivatkozás: az összes page.json tulajdonság, a PHP API és a kulcsalapú egyesítési algoritmus részletes leírása.
  • Oldalak és minták áttekintése: a HTML elemző, a blokkszintaxis hivatkozása, az egyéni megjelenítők és az elemek leképezése.
  • Minták: ugyanez a sablonszintaxis újrahasználható blokkmintákhoz oldalak helyett.