Site Düzenleyici Şablonları ve Dosyalardan Parçalar
Bir blok teması, düzenini templates/*.html ve parts/*.html içinde tanımlar:
<!-- wp:template-part {"slug":"header"} /--> gibi serileştirilmiş blok yorumlarıyla dolu dosyalarda. Bunları elle yazmaktan kimse hoşlanmaz; bu yüzden genellikle Site Düzenleyici’de oluşturulup dışa aktarılırlar. İki kişi aynı şablonu düzenleyene veya bir inceleyicinin HTML yorumlarındaki kaçış karakterli JSON farklarını okuması gerekene kadar bu yöntem işe yarar.
Blockstudio, aynı şablonları dosya tabanlı sayfaları yazdığınız gibi oluşturmanızı sağlar: küçük bir JSON bildirim dosyası ve düz öğeler, <block> etiketleri ve kendi Blockstudio bloklarınızı kullanan HTML benzeri işaretlemeli bir kaynak dosyası içeren klasörler. Blockstudio, kaynağı yerel blok işaretlemesine derler ve tema dosyası olarak WordPress’e iletir. Site Düzenleyici eskisi gibi çalışmaya devam eder: kullanıcılar şablonu özelleştirebilir ve sıfırladıklarında dosya sürümü geri yüklenir.
Bu kılavuzda bir üstbilgi ve altbilgi parçası, ön sayfa ve tekil şablonlar ile düzenleyicilerin sayfalar için seçebileceği özel bir şablon oluşturuluyor; ardından WordPress’ün bunları nasıl çözdüğü gösteriliyor.
Klasör Yapısı
Şablonlar templates/ içine, şablon parçaları parts/ içine konur. Her biri, bir bildirim dosyası ve bir kaynak dosyası içeren klasördür:
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
Bunlar, WordPress’ün blok teması için okuduğu templates/ ve parts/ klasörlerinin aynısıdır. Blockstudio önce etkin temayı, ardından üst temayı tarar. template.json veya part.json içeren klasörler Blockstudio kaynaklarıdır; yanlarındaki sıradan .html dosyaları yerel WordPress şablonları olarak kalır.
Kaynak dosyası index.php, index.blade.php, index.twig veya index.html olabilir; bu sırayla kontrol edilir. Twig, Timber gerektirir; Blade ise kendi işleyici paketini gerektirir. Ayrıntılar için Şablon Motorları bölümüne bakın.
1. Adım: Üstbilgi Parçası
Her parça bir part.json gerektirir. area, parçanın nereye ait olduğunu Site Düzenleyici’ye bildirir:
{
"slug": "header",
"title": "Header",
"description": "Site header with logo and navigation",
"area": "header"
}
Kaynak, Blockstudio sayfaları ve kalıplarıyla aynı sözdizimini kullanır. Bir <div> grup bloğuna dönüşür, öznitelikler blok özniteliklerine dönüşür ve <block> öğeleri kayıtlı herhangi bir bloğu oluşturur:
<div layout='{"type":"flex","justifyContent":"space-between"}'>
<block name="core/site-title" />
<block name="core/navigation" overlayMenu="mobile" />
</div>
Blockstudio bunu şu blok işaretlemesine derler:
<!-- 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 -->
Elle yazmanız gereken içerik de buydu. Kendi bloklarınız da aynı şekilde çalışır: <block name="acme/announcement" />, bir <bs:acme-announcement /> etiketi veya yapılandırılmış etiket öneki, ilgili bloğun blok yorumuna derlenir.
2. Adım: Altbilgi Parçası
Bir parça tek bir paragraf kadar küçük olabilir. Bu örnek, kaynağın bir program değil, işaretleme olduğunu göstermek için index.html kullanıyor:
{
"slug": "footer",
"title": "Footer",
"area": "footer"
}
<p>Built with Acme.</p>
<!-- wp:paragraph --><p>Built with Acme.</p><!-- /wp:paragraph --> olarak derlenir.
3. Adım: Ön Sayfa ve Tekil Şablonlar
Şablonlarda template.json kullanılır. slug; front-page, single, page, archive, 404 veya single-product gibi tam bir WordPress şablon hiyerarşisi adı olmalıdır. Blockstudio bu adın önüne hiçbir zaman eklenmez.
{
"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" />
Tekil yazı şablonu da yazı bloklarıyla aynı yapıyı izler:
{
"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" />
Derlenmiş tekil şablon:
<!-- 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>, tagName: "main" içeren bir grup bloğuna dönüştü; şablon parçası blokları da 1. ve 2. adımlardaki parçaları kısa adlarıyla belirtir. WordPress şablonu oluşturduğunda, bu başvurular dosya tabanlı parçalara çözülür. Böylece ön sayfa çıktısı, site başlığı ve gezinme menüsünü içeren <header class="wp-block-template-part"> ile başlar ve altbilgi paragrafını içeren <footer class="wp-block-template-part"> ile biter.
4. Adım: Sayfalar için Özel Şablon
Hiyerarşinin parçası olmayan kısa ada sahip şablonlar özel şablonlardır. postTypes ile uygulanacak yazı türlerini belirtin; düzenleyiciler de bunları şablon seçicisinden seçebilir:
{
"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' ) artık page-landing öğesini içeriyor ve şablon nesnesi post_types: ["page"] bilgisini taşıyor.
Kaynaklar Bir Kez Derlenir
Kaynak okunup blok işaretlemesine bir kez derlenir; her istekte yeniden derlenmez. Geçerli bir yazı veya istek bağlamı yoktur. index.php işaretleme olarak okunur: içindeki PHP kodu çalıştırılmaz, bu nedenle <?php echo get_bloginfo( 'name' ); ?> hiçbir şeye derlenmez. İsteğe bağlı her şey çalışma zamanında oluşturulan bir bloğa ait olmalıdır: site adını yankılamak yerine core/site-title, the_title() yerine core/post-title veya kendi dinamik Blockstudio bloğunuz.
Derlenmiş sonuçlar, dosya izleme meta verileriyle önbelleğe alınır. Bir bildirim dosyası veya kaynak dosyası düzenlendiğinde o öğenin önbelleğe alınmış içeriği geçersiz kılınır; böylece ayrı bir derleme adımı olmadan sonraki istekte değişiklik görülür.
WordPress Dosyaları Nasıl Görür
Blockstudio, tema şablonları için WordPress’ün kullandığı aramalara bağlanır. get_block_templates() içinde dosya tabanlı şablonlar, yerel tema dosyaları gibi source: "theme" ve origin: "theme" ile görünür; get_block_template( 'acme//header', 'wp_template_part' ) ise area bilgisiyle üstbilgi parçasını döndürür.
Arama sırası şöyledir:
- Veritabanında saklanan bir Site Düzenleyici özelleştirmesi.
- Etkin temadaki yerel bir
.htmldosyası. - Blockstudio dosya tabanlı kaynak.
- Üst tema veya eklenti yedekleri.
Bu sıra, Site Düzenleyici iş akışını korur. Kullanıcı altbilgiyi düzenleyip kaydettiğinde WordPress bir wp_template_part yazısı saklar ve get_block_template() bu özelleştirmeyi source: "custom" ile döndürür. Özelleştirme mevcutken parts/footer/index.html üzerindeki sonraki değişiklikler görünmez. Kullanıcı parçayı sıfırladığında veya yazı silindiğinde arama dosyaya geri döner ve en güncel derlenmiş kaynağı yeniden döndürür.
Blockstudio, Site Düzenleyici’deki değişiklikleri dosyalara geri yazmaz. Bir kullanıcının değişikliği yeni varsayılan olmalıysa, bunu kaynak dosyasına kopyalayıp özelleştirmeyi sıfırlayın.
İç İçe index.html ve Kısa Adlar
WordPress, templates/ ve parts/ içindeki .html dosyalarını özyinelemeli olarak keşfeder. Bu nedenle index.html kullanan bir bildirim klasörü (örneğin parts/footer/index.html), yoldan türetilen footer/index kısa adıyla yerel bir parça olarak da görünür. Blockstudio 7.6.6 olduğundan, bildirimin sahibi olduğu index.html yalnızca tanımlı kısa adıyla sunulur; böylece Site Düzenleyici iki altbilgi değil, bir altbilgi listeler. Bildirimi olmayan iç içe .html dosyalar olduğu gibi bırakılır.
PHP Üzerinden Şablonları Denetleme
Blockstudio\Site_Templates sınıfı kaynakları okur ve derler; testlerde ve dağıtım denetimlerinde kullanışlıdır:
$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();
Her öğe; slug, title, description, type (wp_template veya wp_template_part), status, source_type, şablonlar için postTypes veya parçalar için area, meta ve derlenmiş content öğesini içerir. Yalnızca seçili öğeleri derlemek için bir liste iletin; bu seçimle ilgili sorunları selection_errors() ile okuyun:
$selected = Blockstudio\Site_Templates::templates( array( 'front-page' ) );
$errors = Blockstudio\Site_Templates::selection_errors( 'templates' );
Başka Klasörler Ekleme
Blockstudio kaynaklarını yerel şablonlardan ayrı tutmak veya bunları bir eklentiden sunmak için filtrelerle keşif kökleri ekleyin:
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;
} );
blockstudio/site_templates/template_content ve part_content filtreleri, ayrıştırılmadan önce kaynağı düzenler; blockstudio/site_templates/parser ise tek bir öğe için ayrıştırıcıyı değiştirir. Listenin tamamını Site Şablonları kancaları tablosu içinde bulabilirsiniz.
Hangi Durumda Hangisi Kullanılır
| İstediğiniz | Kullanılacak |
|---|---|
| Temanın URL için seçtiği düzen: üstbilgi, altbilgi, tekil, arşiv | Site şablonları ve parçaları WordPress |
| İçeriği dosyalarda bulunan, yönlendirilebilir bir sayfa | Dosya tabanlı sayfalar |
| Düzenleyicilerin ekleyebileceği yeniden kullanılabilir bir bölüm | Kalıplar |
Şablonlar yazı oluşturmaz; sayfalar oluşturur. Örneğin bir dokümantasyon bölümü, yazıları hâlâ burada oluşturabileceğiniz bir şablon aracılığıyla görüntülenen bir sayfa koleksiyonudur.
Sonraki Adımlar
- Site Şablonları başvuru kaynağı: tüm bildirim özellikleri, PHP API ve tüm kancalar.
- Sayfalar ve Kalıplar genel bakışı: şablon kaynaklarının kullandığı HTML ayrıştırıcısı, blok etiketleri ve öğe eşlemesi.
- Dokümantasyon Sitesi Oluşturma: Markdown, yükleyiciler ve düzenlerle sayfa koleksiyonları.