
Blockstudio 7.4, dosya destekli projeleri daha taşınabilir hâle getirmeyi amaçlıyor. 7.2 büyük projelerin incelenmesini ve dağıtılmasını kolaylaştırdı, 7.3 ise üzerine bir UI katmanı ekledi. 7.4, bir projenin daha fazla bölümünü; sayfalarını ve derlenmiş içeriğini veritabanından çıkarıp sürüm denetimli dosyalara taşımaya odaklanıyor.

Öne çıkan özellik sayfa koleksiyonları: Blockstudio için bir sayfa kaynakları klasörü belirtip buradan iç içe geçmiş eksiksiz bir WordPress sayfa yapısı oluşturmanın yolu. Bu kaynak PHP, Twig, Blade, HTML, Markdown ya da başka bir yerel kaynaktan sayfalar döndüren güvenilir bir yükleyici olabilir.

Kısaca:

- **Sayfa koleksiyonları**: `pages.json` iç içe geçmiş eksiksiz bir sayfa kümesi, varsayılanlar, yazı türü davranışı, düzenler, yükleyiciler ve koleksiyon meta verileri tanımlayabilir.
- **Markdown sayfaları**: `index.md` sayfa içeriği olarak, `page.json` ile veya ön bilgi başlığıyla tek başına kullanılabilir.
- **Ön yüz sayfa düzenleri**: `layout.php` eşitlenen sayfa içeriğini sarabilir ve `blockstudio_page_tree()` ile `blockstudio_page_content()` gibi yardımcıları kullanabilir.
- **Harici belge kaynakları**: koleksiyon yükleyicileri yerel dosyalardan veya döndürülen Markdown/HTML içeriğinden sayfalar oluşturabilir.
- **Ham Markdown çıktısı**: Markdown sayfa kaynakları `.md` olarak veya `Accept: text/markdown` üzerinden sunulabilir.
- **Koleksiyona özel yazı türleri**: koleksiyonlar temiz URL'lere, otomatik yeniden yazma kurallarını yenilemeye, ham Markdown rotalarına ve tema tarafında geçici çözümler olmadan sayfadan özel yazı türüne geçişlere sahip olabilir.
- **Content Sync**: `wp bs content pull`, `wp bs content push` ve `wp bs content status` izin verilen yazıları, terimleri, ilişkileri ve tanımlı meta başvurularını taşınabilir dosyalara aktarır.
- **Blok etiketi önekleri**: `<theme-card>` gibi proje önekleri, blok başına takma ad gerektirmeden sıralı ad alanlarında çözümlenebilir.
- **Daha güvenilir eşitleme**: sayfa değişiklikleri bildirim dosyalarında, yükleyicilerde, düzenlerde, meta verilerde ve kaynak dosyalarda algılanır.
- **Çalışma zamanı ve düzenleyici düzeltmeleri**: dinamik seçenekler güncel kalır, sorgu bloğu sınıfları programlı oluşturma sırasında korunur, `bsui/select` yoğun formlarda daha iyi çalışır, RichText özellikleri düzenleyiciye ulaşır ve RichText içeren yineleyici satırlarının silinmesi kaydetme sonrasında da korunur.

## Dosya tabanlı sayfalar

7.4'ün büyük bölümü dosya tabanlı sayfalar üzerine kuruludur.

### Sayfa koleksiyonları

7.4'ten önce dosya tabanlı sayfalar çoğunlukla klasör düzeyinde bir özellikti: bir `page.json` oluşturun, bir `index.php` veya `index.twig` ekleyin; ardından Blockstudio bu tek sayfayı WordPress ile eşitlerdi.

Bu hâlâ çalışıyor. 7.4, daha büyük yapılar için ikinci bir kip ekliyor.

Bir klasöre `pages.json` bildirim dosyası ekleyin; klasör bir koleksiyona dönüşür:

```txt
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
```

```json title="pages/docs/pages.json"
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "postTypeArgs": {
    "label": "Docs",
    "rewrite": {
      "slug": "docs"
    },
    "supports": ["title", "editor", "page-attributes"]
  },
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

Koleksiyondaki her sayfa kaynağı bulunur, normalleştirilir, eşitlenir ve yoluna göre bağlanır. `guide/install` konumundaki sayfa, `guide` öğesinin alt sayfası olur; `guide` sayfası yoksa Blockstudio oluşturulmuş bir kapsayıcı sayfa üretir ve böylece WordPress hiyerarşisi dosya sistemi yapısıyla eşleşmeye devam eder.

Koleksiyonlar yerel `page` yazı türünü veya kendi yazı türlerini kullanabilir. Bir koleksiyon henüz mevcut olmayan bir yazı türü tanımladığında Blockstudio bunu `postTypeArgs` üzerinden kaydeder. Bildirim dosyasındaki `postType` ayrıca koleksiyondaki her sayfanın varsayılanı olur; böylece projelerin bunu `defaults` içinde yinelemesi gerekmez.

Koleksiyon yazı türleri, koleksiyon slug'ını herkese açık URL tabanı olarak kullanır. Bir `docs` koleksiyonu kök sayfasını `/docs/` konumunda, `path: "getting-started"` içeren bir sayfayı `/docs/getting-started/` konumunda ve iç içe yolları aynı tabanın altında çözümler. `/docs/docs/` gibi yinelenmiş URL'ler standart konuma yönlendirilir. Koleksiyon yazı türü yönlendirmesi değiştiğinde yeniden yazma kuralları otomatik yenilenir; böylece yeni bir koleksiyon için kalıcı bağlantıları elle kaydetmek gerekmez.

Harici belgeleri, ürün kılavuzlarını, bilgi bankalarını ve sayfa kitaplıklarını WordPress içinde doğal hissettiren parça budur: kaynak dosyalarda kalır, sonuç ise düzenlenebilir gerçek WordPress içeriği olur.

### Sayfa içeriği olarak Markdown

Markdown artık birinci sınıf bir sayfa kaynağıdır.

Bağımsız Markdown sayfalarında ön bilgi başlığı kullanılır:

```md title="pages/about/index.md"
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.
```

Yapılandırma ile içeriği ayrı dosyalarda tutmak istediğinizde `page.json` öğesini `index.md` ile birlikte de kullanabilirsiniz. `index.md` içindeki ön bilgi başlığı, eşleşen `page.json` alanlarını geçersiz kılabilir; bilinmeyen ön bilgi anahtarları ise meta veri olarak korunur.

Markdown, HTML biçimine dönüştürülür ve ardından PHP, Twig ve Blade şablonlarıyla aynı sayfa ayrıştırıcısından geçirilir; böylece son içerik yerel blok işaretlemesi olur.

### Düzenler ve sayfa yardımcıları

Koleksiyonlar bir `layout.php` dosyası içerebilir. Ön yüzde Blockstudio eşitlenen sayfa içeriğini bu düzenle sarar.

```php title="pages/docs/layout.php"
<main class="docs-layout">
  <aside>
    <?php foreach (blockstudio_page_tree('docs') as $item) : ?>
      <a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
        <?php echo esc_html($item['title']); ?>
      </a>
    <?php endforeach; ?>
  </aside>

  <article>
    <?php echo blockstudio_page_content(); ?>
  </article>
</main>
```

Yeni yardımcılar koleksiyonu yapılandırılmış veri olarak sunar:

```php
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
```

Böylece eksiksiz bir belge kabuğu oluşturmak için gereken parçalar sağlanır: sayfa ağacından gezinme, ön bilgi başlığından sayfa meta verileri ve ana içerik alanı olarak eşitlenen WordPress blok içeriği.

### Yükleyiciler ve ham Markdown

Koleksiyonlar güvenilir bir yerel `loader.php` dosyası içerebilir. Bu dosya doğrudan sayfalar döndürebilir veya Blockstudio öğesine keşfedilecek ek yerel dizinleri gösterebilir.

```php title="pages/docs/loader.php"
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];
```

Kaynak başka bir yerde zaten oluşturuluyorsa bu kullanışlıdır: bir paket belgeleri klasörü, bir Markdown dışa aktarımı veya sayfa listesi döndüren bir derleme adımı.

Markdown sayfa kaynakları ham Markdown kaynağını da sunabilir. Sayfayı `.md` uzantısıyla isteyin veya `Accept: text/markdown` gönderin. Ön bilgi başlığı yanıttan kaldırılır; böylece araçlar okunabilir belge gövdesini alır. Bu, `/docs.md` ve `/docs/getting-started.md` gibi URL'ler dahil koleksiyon yazı türlerinde de çalışır.

[Sayfalar belgelerini okuyun](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/)

## Content Sync

7.4 ayrıca, WordPress projelerinin daha fazlasını dosya olarak temsil etmek isteyen ekipler için WP-CLI iş akışını sunuyor.

```bash
wp bs content pull
wp bs content push --dry-run
wp bs content status
```

Blockstudio blokları, alanları, şablonları, desenleri ve dosya tabanlı sayfaları zaten projenizde tutuyor. Content Sync, seçili veritabanı içeriğini bu önce dosya yaklaşımına ekliyor: izin verilen yazılar, terimler, ilişkiler ve tanımlı meta veriler dosyalara aktarılabilir, git içinde incelenebilir ve başka bir ortama gönderilebilir.

Bu özellik bilerek açık seçim gerektirir. `blockstudio.json` içinde etkinleştirir, yönetmek istediğiniz yazı türleriyle sınıflandırmaları izin listesine ekler ve ortamlar arasında yeniden yazılması gereken meta başvurularını tanımlarsınız.

Çekme sırasında Blockstudio taşınabilir yazıları, terimleri, ilişkileri ve izin verilen meta verileri temanızdaki dosyalara yazar. Gönderme sırasında yazmadan önce planı doğrular ve tanımlı `post`, `term` ve `attachment` başvurularını yerel veritabanı kimliklerine dönüştürür. Rastgele tamsayıların kimlik olduğunu varsaymaz.

7.4 kapsamı bilerek temkinli tutulmuştur: yazılar, terimler, terim ilişkileri, izin verilen meta veriler, taşınabilir UID'ler, ek dosya bildirimleri, deneme çalıştırmaları, budama işlemleri, kilitli öğeler ve durum raporlaması. Sınıflandırma tanımlarının yakalanması, medya ikili dosyalarının kopyalanması ve blok işaretlemesindeki kimliklerin yeniden yazılması bu ilk sürümün dışında bırakılmıştır.

Böylece ekipler, ekip üyeleri, vaka çalışmaları, konumlar, belge girdileri veya diğer yapılandırılmış kayıtlar gibi derlenmiş içerikleri, tüm üretim veritabanını bir geçişe dönüştürmeden sürüm denetimine alabilir. Bu özellik, hâlâ dosya olarak incelenebilen içerik kümeleri için tasarlanmıştır: onlarca veya yüzlerce satır; bazı projelerde ise içerik yapılandırılmış ve nadiren değişiyorsa birkaç bin satıra kadar. Veritabanı yedeklerinin, e-ticaret/sipariş eşitlemesinin, analizlerin, günlüklerin, form gönderimlerinin veya diğer yüksek hacimli verilerin yerini almaz.

[Content Sync belgelerini okuyun](https://blockstudio.dev/tr/docs/content-sync/)

### Daha güvenilir eşitleme

Blockstudio artık sayfa kaynakları, koleksiyon bildirim dosyaları, yükleyici dosyaları, düzen dosyaları, meta veriler ve ilgili yollar arasındaki değişiklikleri algılıyor. Bunlardan herhangi biri değişirse eşitlenen WordPress sayfası güncelleniyor.

Sayfa işlem hattı, dosya destekli belgeleri gerçek projelerde kullanışlı kılan ayrıntıları da ele alıyor:

- Markdown sayfa kaynakları, blok öznitelikleri dahil yerel blok içeriği olarak eşitlenir
- ön bilgi başlığı meta verileri ön yüz yardımcılarına ve düzenlere sunulur
- koleksiyon sayfaları eşitlemeler arasında kararlı kimliklerini korur
- koleksiyon dışındaki iç içe sayfalar üst sayfalarına bağlanır
- koleksiyon dışındaki iç içe sayfalar en yakın üst `layout.php` öğesini devralabilir
- kaldırılan koleksiyon kaynakları, oluşturdukları WordPress sayfalarını temizler
- bir koleksiyonun `page` türünden özel yazı türüne geçirilmesi, yinelenen kayıtlar oluşturmak yerine mevcut eşitlenmiş yazıları taşır
- sayfa sırası `menu_order` üzerinden kalıcı olarak saklanır

## Blok etiketi önekleri

Blok etiketleri artık yapılandırılabilir ad alanı öneklerini destekliyor. Proje kısa bir önek kaydedebilir ve Blockstudio öğesinin bloğu bir veya daha fazla ad alanında çözümlemesini sağlayabilir:

```php
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});
```

Bu ayarla `<theme-card>`, `theme-components/card` olarak çözümlenebilir; `<theme-button>`, `bsui/button` öğesine geri dönebilir ve `<theme-ui-feature-matrix>`, `theme-components/ui-feature-matrix` olarak çözümlenebilir.

Bir defaya mahsus geçersiz kılma gerektiğinde açık `tag_aliases` tanımları önceliğini korur. Bilinmeyen önek etiketleri olduğu gibi bırakılır; blok etiketleri için mevcut izin verme/engelleme filtreleri de önekle çözümlenen bloklara uygulanmaya devam eder.

[Blok Etiketleri belgelerini okuyun](https://blockstudio.dev/tr/docs/blocks/rendering/#prefix-shorthands)

## Çalışma zamanı ve düzenleyici düzeltmeleri

7.4 ayrıca gerçek projelerdeki kullanımdan ortaya çıkan bir dizi düzeltme içeriyor.

- Yazılar, terimler, kullanıcılar veya ilgili meta veriler değiştiğinde sorguyla doldurulan dinamik seçenekler güncel kalır; `populate.fetch: true` sorgu seçimleri, düzenleyicide arama sonucu olmadığında canlı seçenekleri getirir.
- Programlı `core/query` ve `core/comments` blok etiketleri, oluşturulan sarmalayıcı işaretlemesinde `className` öğesini korur.
- Şablon sözde bileşenleri camelCase özelliklerini korur; böylece `allowedFormats` ve `withoutInteractiveFormatting` gibi özellikler önceden atılmak yerine düzenleyici bileşenine ulaşır.
- `bsui/select`, özellikle yoğun düzenleyici denetimlerinde seçenek verilerini ve taşan menüleri daha güvenilir biçimde işler.
- `blockstudio/phpstan`, `tabs` kapsayıcılarında tanımlanan alanları tanır; böylece şablon, Twig/Blade ve blok etiketi doğrulamaları, Blockstudio'in projelerde kullandığı alan yapısını anlar.
- RichText içeren bir yineleyici satırının silinmesi kaydetme sonrasında da korunur. Eski RichText değerleri artık silinen satırı geri getiremez.

## Bu sürüm neden önemli

7.4'ün teması taşınabilirliktir.

Sayfa koleksiyonları, tüm belge sitelerini kaynak dosya klasörlerine dönüştürür. Markdown sayfaları bu içeriği yazmayı ve yeniden okumayı kolaylaştırır. Content Sync, aynı önce dosya modelini derlenmiş veritabanı içeriğine genişletir; böylece yazılar, terimler ve ilişkiler git içinde bulunabilir ve ortamlar arasında taşınabilir. Blok etiketi önekleri, büyük blok kitaplıklarının şablonlarda okunaklı kalmasını sağlar.

Blockstudio hâlâ dosya tabanlı. Bloklar hâlâ klasörlerden oluşuyor. Sayfalar hâlâ dosyalarda. 7.4 yalnızca bir projenin daha fazla bölümünün; sayfa yapılarının ve derlenmiş içeriğinin bu dosyalarda bulunmasını ve onlarla birlikte taşınmasını sağlıyor.
