Pāriet uz saturu

Lapu veidošana no failiem

Tradicionāli WordPress lapas veido bloku redaktorā: velk blokus, konfigurē iestatījumus un noklikšķina uz saglabāšanas. Tas der klientiem, kas veido savas lapas, taču izstrādātājiem, kuri veido strukturētas lapas ar versiju kontroli, tas rada problēmas. Lapas izkārtojums atrodas datubāzē, nevis kodā. To nevar pārskatīt izmaiņu pieprasījumā, atjaunot ar git vai atkārtoti izveidot tīrā instalācijā.

Blockstudio failos balstītās lapas to atrisina. Definējiet lapas kā failus savā dizainā, rakstiet HTML veidnes, kas tiek pārvērstas par WordPress blokiem, un precīzi nosakiet, ko klienti drīkst un nedrīkst rediģēt. Ar skaidru komandu šie faili tiek sinhronizēti parastās WordPress ziņās, un jūsu veidnes paliek galvenais patiesības avots.

Šajā rokasgrāmatā soli pa solim aplūkota lapu veidošana no nulles, īpašu uzmanību pievēršot bloķēšanas un rediģēšanas vadīklām, kas padara no failiem veidotas lapas praktiskas klientu projektiem.

Pirmā lapa

Izveidojiet sava dizaina mapē pages mapi un pēc tam pievienojiet apakšmapi ar diviem failiem:

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

Palaidiet lapu sinhronizācijas komandu:

Apvalks
wp bs pages sync

Blockstudio parsē HTML par WordPress blokiem un izveido lapu ar nosaukumu “About Us” un slug about. Atveriet to redaktorā, un redzēsiet virsrakstu un rindkopu — tieši tādus, it kā būtu tos pievienojis manuāli.

Rediģējiet index.php, mainiet tekstu un palaidiet komandu vēlreiz. Pārlādējiet redaktoru, lai redzētu izmaiņas. Tā notiek galvenais darba cikls: rakstiet HTML, apzināti sinhronizējiet un iegūstiet blokus.

Veidņu valoda

Blockstudio HTML parsētājs pārvērš standarta HTML elementus par WordPress blokiem. Uzrakstiet <p>, un iegūsiet rindkopas bloku. Uzrakstiet <h2>, un iegūsiet virsraksta bloku. Atbilstība ir intuitīva:

HTML Bloks
<p> Rindkopa
<h1> līdz <h6> Virsraksts (līmenis atbilst tagam)
<ul>, <ol> Saraksts
<blockquote> Citāts
<img> Attēls
<div>, <section> Grupa
<hr> Atdalītājs
<details> Detaļas
<table> Tabula

Blokiem, kuriem nav tiešas HTML atbilstības, izmantojiet elementu <block> ar atribūtu name:

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>

Elementu <block> atribūti tiek nodoti kā bloka atribūti. Vērtības tiek automātiski pārveidotas: "true" kļūst par Būla vērtību, "3" — par veselu skaitli, savukārt virknes JSON, piemēram, '{"type":"flex"}', tiek dekodētas par objektiem.

Izkārtojumi

Grupas atbalsta dažādus izkārtojuma režīmus, ko nosaka atribūts layout:

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>

Pielāgoti bloki

Sintakse <block> darbojas ar jebkuru reģistrētu bloku, tostarp jūsu pašu Blockstudio blokiem:

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

Atribūti tiek automātiski piesaistīti bloka Blockstudio lauku vērtībām.

Galvenās lapas izveide

Lūk, pilnīga galvenā lapa, kuras struktūrai un izkārtojumam izmantoti pamata bloki:

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>

Šajā lapā ir varoņa vāka attēls, trīs kolonnu funkciju režģis, sadaļa ar multividi un tekstu, FAQ akordeoni un CTA. Viss vienā HTML failā. page.json esošais templateLock: "all" nozīmē, ka klients neko nevar mainīt. Nākamajā sadaļā ir paskaidrots, kā ierobežojumus mazināt.

Redaktora vadība

Tieši šeit lapas, kuru pamatā ir faili, kļūst patiesi jaudīgas. Blockstudio sniedz divas neatkarīgas vadīklas: veidnes bloķēšanu un bloku rediģēšanas režīmu. Kopā tās ļauj precīzi noteikt, kuras lapas daļas klienti var mainīt. Bloķējiet struktūru, bet ļaujiet rediģēt tekstu. Iesaldējiet dažas sadaļas, bet citas atstājiet pilnībā atvērtas. Izveidojiet lapu, kurā klients var tikai ievadīt tekstu trīs konkrētos virsrakstos.

Veidnes bloķēšana

Īpašība templateLock objektā page.json nosaka strukturālo rediģēšanu: vai blokus var pievienot, noņemt vai pārkārtot.

"all" (pēc noklusējuma)

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

Visstingrākā bloķēšana. Klienti nevar pievienot, noņemt vai pārvietot blokus. Viņi nevar arī rediģēt bloku saturu (ja vien tas nav apvienots ar blockEditingMode). Šis režīms tiek izmantots pēc noklusējuma, ja vērtība nav norādīta.

Kad izmantot: juridiskām lapām, pakalpojumu sniegšanas noteikumiem un privātuma politikām. Jebkurai lapai, kuras saturu drīkst mainīt tikai ar koda palīdzību.

"insert"

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

Klienti nevar pievienot vai noņemt blokus, taču var pārvietot esošos blokus un rediģēt to saturu. Bloku skaits paliek nemainīgs, bet secību var mainīt.

Kad izmantot: lapām ar fiksētu sadaļu kopu, ko klients var pārkārtot. Piemēram, portfolio lapai, kur sadaļu skaits ir noteikts iepriekš, bet secību izvēlas klients.

"contentOnly"

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

Klienti var rediģēt teksta saturu, bet nevar pievienot, noņemt vai pārvietot blokus. Atšķirība no "all" ir tāda, ka "all" liedz rediģēt arī saturu, savukārt "contentOnly" to skaidri atļauj.

Kad izmantot: visbiežākā izvēle klientiem paredzētām lapām. Izstrādātājs kontrolē izkārtojumu. Klients ievada tekstu.

false

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

Bloķēšanas nav. Klientiem ir pilna kontrole: viņi var pievienot, noņemt, pārvietot un rediģēt jebkuru bloku. Veidne nodrošina sākotnējo struktūru, bet tālāk lapa ir klienta ziņā.

Kad izmantot: emuāra sākumlapām, brīvas formas satura lapām vai jebkurai lapai, kurā klientam jābūt pilnīgai redakcionālai brīvībai.

Bloku rediģēšanas režīms

Kamēr templateLock kontrolē struktūru (pievienošanu, noņemšanu un pārvietošanu), blockEditingMode nosaka mijiedarbību ar katru atsevišķu bloku: vai blokus vispār var atlasīt, konfigurēt vai rediģēt.

Iestatiet lapas noklusējuma vērtību objektā page.json:

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

"default"

Pilna rediģēšana. Blokus var atlasīt, mainīt to iestatījumus un rediģēt saturu. Šī ir parastā redaktora pieredze.

"contentOnly"

Blokus var rediģēt, taču tikai to teksta saturu. Nevar atvērt bloka iestatījumus, mainīt krāsas, pielāgot iekšējās atkāpes vai mainīt citus atribūtus, kas nav saistīti ar saturu. Bloka rīkjoslā ir redzamas tikai teksta formatēšanas opcijas.

"disabled"

Ar blokiem nav iespējams mijiedarboties. Tie tiek attēloti redaktorā, taču tos nevar noklikšķināt, atlasīt vai jebkādā veidā mainīt. Klients redz saturu, bet nevar to mainīt.

Atsevišķu elementu iestatījumu pārrakstīšana

Te sākas interesantākais. Lapas līmeņa blockEditingMode nosaka noklusējuma vērtību katram lapas blokam, bet veidnē to var pārrakstīt atsevišķiem elementiem:

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>

Lapas noklusējums ir "disabled", tāpēc visi bloki sākotnēji nav interaktīvi. Pēc tam konkrēti elementi izvēlas "contentOnly", ļaujot rediģēt tikai to tekstu. Rezultāts: lapa, kurā klients var ievadīt tekstu tikai divos teksta laukos (galvenē un rindkopā) un vienā funkcijas apraksta rindkopā. Viss pārējais ir bloķēts.

Tas darbojas ar jebkuru HTML elementu (<h1>, <p>, <div> u.c.) un <block> elementiem. Konkrētiem elementiem var iestatīt arī blockEditingMode="default", lai nodrošinātu pilnu piekļuvi rediģēšanai:

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

Tagad klients var mainīt pogas tekstu, URL, stilus un jebkuru citu iestatījumu. Viss pārējais lapā paliek nemainīgs.

Vecāku bloku ķēde

Ir svarīgi saprast, kā atsevišķu elementu iestatījumu pārrakstīšana mijiedarbojas ar konteineru blokiem. Ja lapas noklusējums ir "disabled" un grupas iekšpusē esošam virsrakstam iestatāt blockEditingMode="contentOnly", virsrakstam ir jābūt pieejamam. Taču tā vecākelements ir "disabled" grupa, kurai nav iespējams piekļūt.

Blockstudio to automātiski novērš. Ja bērnelementam ir pārrakstīts rediģēšanas režīms, visiem tā vecākelementiem tiek iestatīts "contentOnly", lai bērnelements paliktu pieejams. Vecākkonteineriem režīmi nav jāiestata manuāli. Vienkārši pārrakstiet iestatījumu blokam, kuru vēlaties padarīt rediģējamu, un ceļš līdz tam tiks atvērts.

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>

Vecāku bloku ķēde paaugstina konteinerus tikai līdz "contentOnly", nekad līdz "default". Tas nozīmē, ka vecākgrupās var pārvietoties (tās var atvērt), bet tās nevar pilnībā rediģēt (to iestatījumus mainīt nevar).

Lēmumu matrica

Apvienojot templateLock un blockEditingMode, iegūstat dažādas kontroles iespējas. Tālāk norādītas noderīgākās kombinācijas:

Izstrādātājs kontrolē visu

JSON
{ "templateLock": "all" }

blockEditingMode nav vajadzīgs. Noklusējuma templateLock: "all" liedz veikt jebkādas izmaiņas. Izmantojiet šo iestatījumu lapām, ko pārvalda tikai ar kodu.

Klients rediģē visu tekstu

JSON
{ "templateLock": "contentOnly" }

Klients var rediģēt tekstu jebkurā blokā, taču nevar mainīt lapas struktūru. Vienkāršs un pieļāvīgs iestatījums.

Klients rediģē tikai konkrētu tekstu

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

Veidnē konkrētiem elementiem pievienojiet blockEditingMode="contentOnly". Šī ir visprecīzākā iespēja: klients var rediģēt tikai tos blokus, kurus atzīmējat.

Klients pārkārto fiksētas sadaļas

JSON
{ "templateLock": "insert" }

Klients var pārkārtot sadaļas un rediģēt saturu, taču nevar pievienot vai dzēst blokus. Piemērots lapām ar fiksētu sadaļu kopu, ko var izvietot elastīgā secībā.

Klientam ir pilna kontrole

JSON
{ "templateLock": false }

Veidne ir sākumpunkts. Pēc tam klients var darīt jebko.

Klienta labojumu saglabāšana

Pēc noklusējuma, atjauninot veidnes failu, Blockstudio aizstāj visu lapas saturu. Ja klients redaktorā ir rediģējis virsrakstu, pēc nākamās sinhronizācijas šis labojums pazūd. Tas ir piemērots lapām, ko kontrolē izstrādātājs, bet lapām, kurās saturu veido klienti, ir nepieciešams veids, kā saglabāt viņu darbu.

Atslēgas

Pievienojiet jebkuram elementam atribūtu key, lai norādītu, ka tas ir jāapvieno, nevis jāaizstāj:

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>

Kad veidne mainās un lapa tiek atkārtoti sinhronizēta:

  • Bloki ar atslēgām saglabā klienta saturu (tekstu, iekšējos blokus un formatējumu). Veidnes strukturālie atribūti (piemēram, vāka url) joprojām tiek atjaunināti.
  • Bloki bez atslēgām tiek pilnībā aizstāti ar veidnes versiju.

Atslēga aizsargā visu bloku un visus tā bērnelementus. Atslēgas nav jāpiešķir katrai rindkopai grupā, kurai jau ir atslēga. Grupas atslēga aptver visu tās saturu.

Atslēgām jābūt unikālām

Atslēgām jābūt unikālām visā veidnē. Ja diviem elementiem ir viena un tā pati atslēga, otrais elements tiek uzskatīts par tādu, kam nav atslēgas (un tiek parādīts brīdinājums PHP). Izmantojiet aprakstošus nosaukumus: "hero", "features", "cta", "testimonial-section".

Veidņu pilnveidošana

Atslēgas ļauj veidnei pievienot jaunas sadaļas, netraucējot esošo klienta saturu:

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>

Pēc sinhronizācijas virsrakstā un pakalpojumu sadaļā tiek saglabāti klienta labojumi. Jaunā atsauksmju sadaļa tiek parādīta ar veidnes noklusējuma saturu. Ja vēlāk no veidnes noņemat bloku ar atslēgu, tas tiek dzēsts arī no lapas.

Pilna klienta darbplūsma

Lūk, kā to visu apvienot reālā projektā:

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>

Šajā lapā ir četras sadaļas ar atslēgām. Klients var rediģēt virsrakstus un rindkopas, kas atzīmētas ar blockEditingMode="contentOnly", un šie labojumi tiek saglabāti arī pēc veidņu atjaunināšanas. Izstrādātājs kontrolē izkārtojumu, attēlus, pogu URL un kopējo struktūru. Ja izstrādātājs vēlāk pievieno atsauksmju sadaļu starp sadaļām “par mums” un “cta”, tā parādās nākamajā sinhronizācijā, netraucējot klienta tekstu.

Bloku saistījumi: alternatīva atslēgām

WordPress 6.5. versijā tika ieviesti Bloku saistījumi API, kas savieno bloku atribūtus ar ieraksta meta datiem. Tā vietā, lai rediģējamo saturu glabātu bloka marķējumā (kur to aizsargā atslēgas), saturs tiek glabāts objektā wp_postmeta (kur veidnes sinhronizācija tam nevar piekļūt).

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>

Meta atslēgas jāreģistrē objektā PHP:

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

Bloku saistījumiem ir divas priekšrocības salīdzinājumā ar atslēgām: datus var vaicāt ar WP_Query, izmantojot meta_query, un tie ir pieejami REST API. Kompromiss ir tāds, ka katra meta atslēga ir jāreģistrē objektā PHP un saistījumi darbojas tikai ar atsevišķiem bloka atribūtiem (nevis ar sarežģītu, ligzdotu saturu).

Izmantojiet atslēgas satura sadaļām, kur svarīga ir bloku struktūra (grupai ar virsrakstiem, rindkopām un attēliem). Izmantojiet saistījumus atsevišķām teksta vērtībām, par kurām jāveido vaicājumi vai kuras jāattēlo citur.

Ierakstu veidu veidnes

Izmantojiet templateFor, lai noteiktu noklusējuma bloku struktūru visiem jauniem konkrēta veida ierakstiem:

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>

Katrs jauns “product” ieraksts sākas ar šo struktūru. templateLock: "insert" ļauj redaktoriem pārkārtot sadaļas un rediģēt saturu, bet ne pievienot vai noņemt blokus.

Padomi

Sinhronizējiet plānotā izvietošanas posmā. Palaidiet wp bs pages sync pēc lapu avotu maiņas vai izvietošanas. Priekšgala un administratora apmeklējumi lapas nesinhronizē. PHP izvietošanas rīki var izsaukt Blockstudio\Pages::reconcile() un pārbaudīt tā mašīnlasāmo pārskatu.

Fiksējiet svarīgu ierakstu ID. Izmantojiet postId objektā page.json lapām, uz kurām norāda izvēlnes, kodā ierakstītas saites vai ārējas sistēmas. Bez fiksēta ID, dzēšot un no jauna izveidojot lapu, tai tiek piešķirts jauns ID, tādējādi pārtraucot šīs atsauces.

Izmantojiet sync: false sākotnējo lapu izveidei. Ja vēlaties lapu izveidot vienreiz un pēc tam pilnībā nodot klientam, iestatiet "sync": false un izveidojiet to ar Blockstudio\Pages::force_sync(). Parastās saskaņošanas laikā šī lapa tiek ignorēta.

Bloķējiet un atbloķējiet ar PHP. Izsauciet Blockstudio\Pages::lock('about'), lai liegtu konkrētai lapai sinhronizēties (noderīgi klienta intensīva rediģēšanas darba laikā). Izsauciet Blockstudio\Pages::unlock('about'), lai atkal iespējotu sinhronizāciju.

Veidņu dzinēji. Papildus PHP veidnes var rakstīt arī Twig (nepieciešams Timber) vai Blade (nepieciešams illuminate/view). Tas noder cikliem un filtriem, taču lapu veidnes tiek kompilētas tikai skaidri veiktas sinhronizācijas laikā, nevis priekšgala pieprasījuma laikā. Izmantojiet PHP, ja paša avota kompilēšanai nepieciešami tikai PHP palīgfunkcijas.

Piespiedu sinhronizācija ignorē atslēgas. Izsaucot Pages::force_sync('about'), tiek aizstāts viss lapas saturs, ignorējot atslēgas un modificēšanas laika pārbaudes. Izmantojiet to, ja vēlaties apzināti atiestatīt lapu uz veidnes stāvokli.

Nākamie soļi

  • Lapu atsauce: detalizēti aprakstītas visas page.json īpašības, PHP API un apvienošanas algoritms, kas izmanto atslēgas.
  • Lapu un rakstu rakstu pārskats: HTML parsētājs, bloku sintakses atsauce, pielāgoti renderētāji un elementu kartēšana.
  • Raksti: tā pati veidņu sintakse atkārtoti lietojamiem bloku rakstiem, nevis lapām.