Dosya Tabanlı Sayfalar Oluşturma
Geleneksel WordPress sayfa oluşturma işlemi blok düzenleyicide yapılır: blokları sürükleme, ayarları yapılandırma ve kaydet’e tıklama. Bu yöntem kendi sayfalarını oluşturan müşteriler için işe yarar; ancak yapılandırılmış ve sürüm denetimli sayfalar oluşturan geliştiriciler için sorunlara yol açar. Sayfa düzeni kodda değil, veritabanında bulunur. Düzeni bir çekme isteğinde inceleyemez, git ile önceki hâline döndüremez veya yeni bir kurulumda yeniden oluşturamazsınız.
Blockstudio dosya tabanlı sayfaları bu sorunları çözer. Sayfaları temanızda dosyalar olarak tanımlar, HTML şablonları yazıp bunları WordPress bloklarına dönüştürür ve müşterilerin neleri düzenleyip neleri düzenleyemeyeceğini tam olarak kontrol edersiniz. Açıkça çalıştırılan bir komut bu dosyaları normal WordPress gönderilerine eşitler ve şablonlarınız tek geçerli kaynak olarak kalır.
Bu kılavuzda sayfaların sıfırdan nasıl oluşturulacağı anlatılır; özellikle dosya tabanlı sayfaları müşteri projeleri için kullanışlı kılan kilitleme ve düzenleme denetimlerine odaklanılır.
İlk Sayfanız
Temanızda bir pages klasörü oluşturun, ardından içinde iki dosya bulunan bir alt klasör ekleyin:
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>
Sayfa eşitleme komutunu çalıştırın:
wp bs pages sync
Blockstudio, HTML dosyasını WordPress bloklarına dönüştürür ve about kısa adıyla “About Us” adlı bir sayfa oluşturur. Sayfayı düzenleyicide açtığınızda, elle eklemişsiniz gibi bir başlık ve paragraf görürsünüz.
index.php dosyasını düzenleyip metni değiştirin ve komutu yeniden çalıştırın. Güncellemeyi görmek için düzenleyiciyi yeniden yükleyin. Temel döngü şöyledir: HTML yazın, eşitlemeyi bilinçli olarak çalıştırın, blokları alın.
Şablon Dili
Blockstudio’nin HTML ayrıştırıcısı, standart HTML öğelerini WordPress bloklarına dönüştürür. Bir <p> yazdığınızda paragraf bloğu elde edersiniz. Bir <h2> yazdığınızda başlık bloğu elde edersiniz. Eşleme sezgiseldir:
| HTML | Blok |
|---|---|
<p> |
Paragraf |
<h1> ila <h6> |
Başlık (düzeyi etikete göre belirlenir) |
<ul>, <ol> |
Liste |
<blockquote> |
Alıntı |
<img> |
Görsel |
<div>, <section> |
Grup |
<hr> |
Ayırıcı |
<details> |
Ayrıntılar |
<table> |
Tablo |
Doğrudan HTML karşılığı olmayan bloklar için name özniteliğiyle birlikte <block> öğesini kullanın:
<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>
<block> öğelerindeki öznitelikler blok öznitelikleri olarak aktarılır. Değer türleri otomatik dönüştürülür: "true" boolean, "3" tamsayı olur ve '{"type":"flex"}' gibi JSON dizeleri nesnelere dönüştürülür.
Düzenler
Gruplar, layout özniteliği üzerinden farklı düzen modlarını destekler:
<!-- 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>
Özel bloklar
<block> sözdizimi, kendi Blockstudio bloklarınız da dahil olmak üzere kayıtlı tüm bloklarda çalışır:
<block name="my-theme/hero" title="Welcome" background="dark" />
<block name="my-theme/testimonial" quote="Great product." author="Jane" />
Öznitelikler, otomatik olarak bloğun Blockstudio alan değerlerine eşlenir.
Açılış Sayfası Oluşturma
Yapı ve düzen için çekirdek blokları kullanan eksiksiz bir açılış sayfası örneği:
{
"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>
Bu sayfada kapak tarzı bir hero, üç sütunlu bir özellik ızgarası, medya ve metin bölümü, SSS akordeonları ve bir CTA bulunur. Hepsi tek bir HTML dosyasındadır. page.json içindeki templateLock: "all", müşterinin hiçbir şeyi değiştiremeyeceği anlamına gelir. Sonraki bölümde bu kısıtlamanın nasıl gevşetileceği açıklanır.
Düzenleyiciyi Denetleme
Dosya tabanlı sayfaların gerçek gücü burada ortaya çıkar. Blockstudio size birbirinden bağımsız iki kontrol sunar: şablon kilidi ve blok düzenleme modu. Birlikte, müşterilerin bir sayfanın tam olarak hangi bölümlerini değiştirebileceğini belirlemenizi sağlarlar. Yapıyı kilitleyip metni düzenlemelerine izin verin. Bazı bölümleri dondurup diğerlerini tamamen açık bırakın. Müşterinin yapabileceği tek şeyin belirli üç başlığa yazı yazmak olduğu bir sayfa oluşturun.
Şablon Kilidi
page.json içindeki templateLock özelliği yapısal düzenlemeyi denetler: blokların eklenip eklenemeyeceğini, kaldırılıp kaldırılamayacağını veya yeniden sıralanıp sıralanamayacağını belirler.
"all" (varsayılan)
{
"name": "terms",
"templateLock": "all"
}
En katı kilit. Müşteriler blok ekleyemez, kaldıramaz veya taşıyamaz. Ayrıca blok içeriğini de düzenleyemezler (blockEditingMode ile birlikte kullanılmadığı sürece). Bir değer belirtmezseniz varsayılan budur.
Ne zaman kullanılır: Yasal sayfalar, hizmet şartları ve gizlilik politikaları. İçeriğin yalnızca kod aracılığıyla değiştirilmesi gereken her türlü sayfa.
"insert"
{
"name": "about",
"templateLock": "insert"
}
Müşteriler blok ekleyemez veya kaldıramaz, ancak mevcut blokları taşıyabilir ve içeriklerini düzenleyebilir. Blok sayısı sabit kalır, sıralama ise değiştirilebilir.
Ne zaman kullanılır: Sabit bir bölüm kümesi istediğiniz, ancak müşterinin bunları yeniden sıralayabilmesi gereken sayfalar. Bölüm sayısının önceden belirlendiği, sıralamaya ise müşterinin karar verdiği bir portföy sayfası.
"contentOnly"
{
"name": "homepage",
"templateLock": "contentOnly"
}
Müşteriler metin içeriğini düzenleyebilir, ancak blok ekleyemez, kaldıramaz veya taşıyamaz. "all" seçeneğinden farkı, "all" seçeneğinin içerik düzenlemeyi de engellemesi, "contentOnly" seçeneğinin ise buna açıkça izin vermesidir.
Ne zaman kullanılır: Müşterilere yönelik sayfalarda en sık tercih edilen seçenektir. Geliştirici yerleşimi kontrol eder. Müşteri metni doldurur.
false
{
"name": "blog",
"templateLock": false
}
Hiç kilit yoktur. Müşteriler tam kontrole sahiptir: istedikleri bloğu ekleyebilir, kaldırabilir, taşıyabilir ve düzenleyebilirler. Şablon başlangıç yapısını sağlar, sonrasında sayfanın sahibi müşteridir.
Ne zaman kullanılır: Blog dizini sayfaları, serbest içerik sayfaları veya müşterinin tüm içerik düzenleme özgürlüğüne sahip olması gereken her tür sayfa.
Blok Düzenleme Modu
templateLock yapıyı (ekleme, kaldırma, taşıma) denetlerken blockEditingMode tek tek bloklarla etkileşimi denetler: blokların seçilip seçilemeyeceğini, yapılandırılıp yapılandırılamayacağını veya düzenlenip düzenlenemeyeceğini belirler.
page.json içinde sayfa düzeyinde bir varsayılan belirleyin:
{
"name": "landing",
"templateLock": "all",
"blockEditingMode": "disabled"
}
"default"
Tam düzenleme. Bloklar seçilebilir, ayarları değiştirilebilir ve içerikleri düzenlenebilir. Bu, standart düzenleyici deneyimidir.
"contentOnly"
Bloklar düzenlenebilir, ancak yalnızca metin içerikleri. Blok ayarlarını açamaz, renkleri değiştiremez, dolguyu ayarlayamaz veya içerik dışındaki hiçbir niteliği değiştiremezsiniz. Blok araç çubuğunda yalnızca metin biçimlendirme seçenekleri görünür.
"disabled"
Bloklar tamamen etkileşime kapalıdır. Düzenleyicide görüntülenirler, ancak hiçbir şekilde tıklanamaz, seçilemez veya değiştirilemezler. Müşteri içeriği görür ama ona dokunamaz.
Öğe Başına Geçersiz Kılmalar
İşin ilginçleştiği yer burasıdır. Sayfa düzeyindeki blockEditingMode, sayfadaki her blok için bir varsayılan belirler; ancak bunu şablondaki tek tek öğelerde geçersiz kılabilirsiniz:
{
"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>
Sayfa varsayılanı "disabled" olduğundan her blok etkileşime kapalı başlar. Ardından belirli öğeler "contentOnly" modunu etkinleştirerek yalnızca metinlerinin düzenlenmesine izin verir. Sonuç: müşterinin tam olarak iki metin alanına (hero başlığı ve paragrafı) ve bir özellik paragrafına yazabildiği bir sayfa. Diğer her şey kilitlidir.
Bu, herhangi bir HTML öğesinde (<h1>, <p>, <div> vb.) ve <block> öğelerinde çalışır. Tam düzenleme erişimi vermek için belirli öğelerde blockEditingMode="default" de ayarlayabilirsiniz:
<block name="core/buttons" blockEditingMode="default">
<block name="core/button" url="/contact">Fully editable button</block>
</block>
Artık müşteri düğme metnini, URL değerini, stilleri ve diğer tüm ayarları değiştirebilir. Sayfanın geri kalanı kilitli kalır.
Üst Öğeler Zinciri
Öğe başına geçersiz kılmaların kapsayıcı bloklarla etkileşimiyle ilgili önemli bir ayrıntı var. Sayfa varsayılanı "disabled" ise ve bir grup içindeki başlıkta blockEditingMode="contentOnly" ayarlarsanız başlığa erişilebilmesi gerekir. Ancak üst grubu "disabled" olduğundan gruba hiç girilemez.
Blockstudio bu durumu otomatik olarak ele alır. Bir alt blok için düzenleme modu geçersiz kılındığında, alt bloğa erişilebilmesi için tüm üst blokları "contentOnly" olarak ayarlanır. Üst kapsayıcılarda modları elle ayarlamanız gerekmez. Düzenlenebilir olmasını istediğiniz blokta geçersiz kılmayı ayarlamanız yeterlidir; o bloğa giden yol açılır.
<!-- 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>
Üst öğeler zinciri, kapsayıcıları yalnızca "contentOnly" düzeyine çıkarır; hiçbir zaman "default" düzeyine çıkarmaz. Böylece üst gruplarda gezinilebilir (içlerine girebilirsiniz), ancak tamamen düzenleme yapılamaz (ayarlarını değiştiremezsiniz).
Karar Matrisi
templateLock ve blockEditingMode birlikte kullanıldığında geniş bir kontrol yelpazesi sunar. En kullanışlı birleşimler şunlardır:
Geliştirici her şeyi kontrol eder
{ "templateLock": "all" }
blockEditingMode gerekmez. Varsayılan templateLock: "all" tüm değişiklikleri engeller. Tamamen kod aracılığıyla yönetilen sayfalarda bunu kullanın.
Müşteri tüm metinleri düzenler
{ "templateLock": "contentOnly" }
Müşteri herhangi bir bloktaki metni düzenleyebilir, ancak sayfa yapısını değiştiremez. Basit ve esnek bir seçenek.
Müşteri yalnızca belirli metinleri düzenler
{
"templateLock": "all",
"blockEditingMode": "disabled"
}
Şablondaki belirli öğelerde blockEditingMode="contentOnly" ile birlikte kullanılır. En hassas seçenek budur: müşteri yalnızca işaretlediğiniz blokları düzenleyebilir.
Müşteri sabit bölümleri yeniden sıralar
{ "templateLock": "insert" }
Müşteri bölümleri yeniden sıralayabilir ve içeriği düzenleyebilir, ancak blok ekleyemez veya silemez. Sabit bir bölüm kümesinin esnek bir sırada sunulması gereken sayfalar için uygundur.
Müşteri tam kontrole sahip olur
{ "templateLock": false }
Şablon bir başlangıç noktasıdır. Müşteri sonrasında istediği her şeyi yapabilir.
Müşteri Düzenlemelerini Koruma
Varsayılan olarak, bir şablon dosyasını güncellediğinizde Blockstudio sayfanın tüm içeriğini değiştirir. Müşteri düzenleyicide bir başlığı düzenlediyse bu değişiklik sonraki eşitlemeden sonra kaybolur. Geliştirici tarafından kontrol edilen sayfalar için bu uygundur; ancak müşterilerin içerik eklediği sayfalarda çalışmalarını korumanın bir yoluna ihtiyacınız olur.
Anahtarlar
Bir öğeyi değiştirilmek yerine birleştirilmek üzere işaretlemek için öğeye key niteliğini ekleyin:
<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>
Şablon değişip sayfa yeniden eşitlendiğinde:
- Anahtarlı bloklar müşterinin içeriğini (metin, iç bloklar, biçimlendirme) korur. Şablonun yapısal nitelikleri (kapak bloğunun
urlniteliği gibi) yine güncellenir. - Anahtarsız bloklar tamamen şablon sürümüyle değiştirilir.
Bir anahtar, bloğun tamamını ve tüm alt öğelerini korur. Anahtarlı bir grubun içindeki paragrafları tek tek anahtarlamanız gerekmez. Grubun anahtarı içindeki her şeyi kapsar.
Anahtarlar benzersiz olmalıdır
Anahtarlar tüm şablonda benzersiz olmalıdır. İki öğe aynı anahtarı paylaşırsa ikincisi anahtarsız kabul edilir (ve bir PHP uyarısı verilir). Açıklayıcı adlar kullanın: "hero", "features", "cta", "testimonial-section".
Şablonları geliştirme
Anahtarlar, mevcut müşteri içeriğini bozmadan bir şablona yeni bölümler eklemenizi sağlar:
<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>
Eşitleme sırasında başlık ve hizmetler müşterinin düzenlemelerini korur. Yeni referanslar bölümü, şablonun varsayılan içeriğiyle görünür. Şablondan daha sonra anahtarlı bir bloğu kaldırırsanız sayfadan da silinir.
Eksiksiz müşteri iş akışı
Gerçek bir proje için tüm parçaları bir araya getirelim:
{
"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>
Bu sayfada anahtarlanmış dört bölüm var. Müşteri, blockEditingMode="contentOnly" ile işaretlenmiş başlıkları ve paragrafları düzenleyebilir; bu düzenlemeler şablon güncellemelerinden sonra da korunur. Geliştirici yerleşimi, görselleri, düğme URL’lerini ve genel yapıyı kontrol eder. Geliştirici daha sonra “about” ile “cta” arasına bir referanslar bölümü eklerse bu bölüm, müşterinin hiçbir metnini etkilemeden sonraki eşitlemede görünür.
Blok Bağlamaları: Anahtarlara Alternatif
WordPress 6.5 sürümü, blok niteliklerini gönderi meta verilerine bağlayan Blok BağlamalarıAPI özelliğini tanıttı. Düzenlenebilir içeriği blok işaretlemesinde (anahtarların koruduğu yerde) saklamak yerine içerik, wp_postmeta içinde tutulur (şablon eşitlemeleri buraya dokunamaz).
<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 anahtarları PHP içinde kaydedilmelidir:
register_post_meta( 'page', 'hero_title', array(
'show_in_rest' => true,
'single' => true,
'type' => 'string',
'default' => 'Default Title',
) );
Blok bağlamalarının anahtarlara göre iki avantajı vardır: verilere WP_Query aracılığıyla meta_query kullanarak sorgu gönderilebilir ve veriler REST API içinde kullanılabilir. Bunun karşılığında her meta anahtarını PHP içinde kaydetmeniz gerekir ve bağlamalar yalnızca tek tek blok niteliklerinde çalışır (karmaşık iç içe içeriklerde çalışmaz).
Blok yapısının önemli olduğu zengin içerikli bölümler (başlıklar, paragraflar ve görseller içeren bir grup) için anahtarları kullanın. Ayrıca sorgulamanız veya başka yerlerde göstermeniz gereken tekil metin değerleri için bağlamaları kullanın.
Yazı Türü Şablonları
Belirli bir türdeki tüm yeni gönderiler için varsayılan blok yapısını ayarlamak üzere templateFor kullanın:
{
"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>
Her yeni “product” gönderisi bu yapıyla başlar. templateLock: "insert", düzenleyicilerin bölümleri yeniden sıralamasına ve içeriği düzenlemesine izin verir; ancak blok eklemelerine veya kaldırmalarına izin vermez.
İpuçları
Eşitlemeyi planlı bir dağıtım sınırında yapın. Sayfa kaynaklarını değiştirdikten veya dağıttıktan sonra wp bs pages sync komutunu çalıştırın.
Frontend ve yönetici ziyaretleri sayfaları hiçbir zaman eşitlemez. PHP dağıtım araçları Blockstudio\Pages::reconcile() komutunu çağırabilir ve makine tarafından okunabilir raporunu inceleyebilir.
Önemli gönderi kimliklerini sabitleyin. Menülerde, sabit kodlanmış bağlantılarda veya harici sistemlerde başvurulan sayfalar için page.json içinde postId kullanın. Sabitleme yapılmazsa silinip yeniden oluşturulan bir sayfa yeni bir kimlik alır ve bu referanslar bozulur.
İskeletler için sync: false kullanın. Bir sayfayı bir kez oluşturup ardından tamamen müşteriye devretmek istiyorsanız "sync": false ayarlayın ve sayfayı Blockstudio\Pages::force_sync() ile oluşturun. Normal uzlaştırma bundan sonra bu sayfayı yok sayar.
PHP aracılığıyla kilitleyin ve kilidi açın. Belirli bir sayfanın eşitlenmesini önlemek için Blockstudio\Pages::lock('about') çağrısını kullanın (müşterinin düzenleme yaptığı dönemlerde kullanışlıdır). Eşitlemeyi yeniden etkinleştirmek için Blockstudio\Pages::unlock('about') çağrısını kullanın.
Şablon motorları. PHP dışında şablonlar Twig ile de yazılabilir (Timber gerektirir) veya Blade ile yazılabilir (illuminate/view gerektirir). Bu seçenek döngüler ve filtreler için kullanışlıdır; ancak sayfa şablonları frontend isteği sırasında değil, açık eşitleme sırasında derlenir. Kaynağın derlenmesi sırasında PHP-özel yardımcıların gerekmesi durumunda PHP kullanın.
Zorunlu eşitleme anahtarları yok sayar. Pages::force_sync('about') çağrısı, anahtarları ve değiştirilme zamanı denetimlerini yok sayarak sayfanın tüm içeriğini değiştirir. Bir sayfayı bilerek şablon durumuna sıfırlamak istediğinizde kullanın.
Sonraki Adımlar
- Sayfalar referansı: tüm
page.jsonözellikleri, PHP API ve anahtarlı birleştirme algoritmasının ayrıntıları. - Sayfalar ve kalıplar genel bakışı: HTML ayrıştırıcısı, blok sözdizimi referansı, özel oluşturucular ve öğe eşlemesi.
- Kalıplar: sayfalar yerine yeniden kullanılabilir blok kalıpları için aynı şablon sözdizimi.