# Kodla tanımlanan tam sayfalar

Şablonlar ve Markdown, tek bir komutla WordPress ile eşitlenir.

## Dosyalardan koleksiyonlar

`pages.json` tanımlayın ve Blockstudio altındaki tüm kaynakları keşfetsin. İç içe yollar iç içe sayfalara dönüşür, varsayılanlar koleksiyona uygulanır ve eksik üst sayfalar oluşturulabilir.

Koleksiyonları dokümantasyon, bilgi tabanları veya açılış sayfaları için kullanın; harici klasörleri `loader.php` ile bir yol önekinin altına bağlayın.

Koleksiyondaki her sayfayı tek bir kabukla sarmalamak için `pages.json` yanına bir `layout.php` veya `layout.tsx` gibi bir renderer düzeni yerleştirin; kenar çubuğu için `blockstudio_page_tree()` kullanın.

[Sayfa koleksiyonları](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/#page-collections)

pages/docs/pages.json

```
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

## Açık eşitleme

wp bs pages sync değişiklikleri uygular; değişmemiş sayfalar için yazma işlemi gerekmez.

## Markdown kaynakları

index.md öğesini frontmatter ile kullanın veya page.json ile Markdown içeriğini eşleştirin.

## Ham Markdown

Markdown dosya sayfaları kendi URL yollarında .md uzantısıyla ya da Accept: text/markdown için normal URL yolunda yanıt verir ve HTML öğesine geri dönen bir standart bağlantı içerir.

## Koleksiyon yükleyicileri

Harici dokümantasyon klasörlerini bir yol önekinin altındaki koleksiyona bağlayın.

## Site koleksiyonları

scope site olan bir pages.json, URL’leri veya yazı satırlarını değiştirmeden tüm sayfa ağacına ortak varsayılanları uygular ve ağacı listeler.

## Gezinme yardımcıları

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() ve blockstudio_page_content(); kenar çubukları, sayfalayıcılar ve gövde oluşturur.

## Koleksiyonlar ve yazı türleri

Koleksiyonlar, özel hiyerarşik yazı türleri kaydedebilir.

## Şablon kilitleme

Sayfaları veya tek tek blokları contentOnly, all ya da insert ile kilitleyin.

## HTML yazın, blokları alın

`<h1>`, `<p>` ve `<ul>` gibi standart öğeler temel bloklarla eşleşir. Diğer tüm blok adları ve iç içe geçme düzeyleri için `<block>` kullanın.

Blockstudio, tam sayfa düzenlerini gerçek, düzenlenebilir WordPress bloklarına ayrıştırır.

[Sayfa sözdizimi başvurusu](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/)

index.php

```
<div>
  <h1 blockEditingMode="contentOnly">About Us</h1>
  <p>We build tools for WordPress developers.</p>
  <img src="/team.jpg" alt="Our team" />
</div>

<block name="core/columns">
  <block name="core/column"><h2>Our Mission</h2></block>
  <block name="core/column"><h2>Our Stack</h2></block>
</block>
```

## Bileşenlerle oluşturulan sayfalar

`page.json` içinde `render` değerini `page.tsx` gibi bir girdiye ve bir `data.php` yükleyicisine ayarlayın; temanızın veya eklentinizin kaydettiği sayfa oluşturucu tüm sayfayı çizer. Sync tek bir `blockstudio/page` bloğu kaydeder ve kısa kod gibi WordPress içerik kendi yuvasında kalır.

Oluşturucunun döndürdüğü varlıklar, blok varlıklarıyla aynı işlemlerden geçer ve yalnızca bir kez yazdırılır; böylece önceden oluşturulmuş bir sayfa bu varlıkları da içerir. blockstudio.dev ise bileşen sayfalarından oluşturulur.

[Bileşen sayfaları](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/#component-pages)

pages/legal-notice/page.json

```
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}
```

## Yazısı olmayan rotalar

`Blockstudio\Virtual_Routes::register()`, bileşen referansı veya katalog gibi arkasında bir yazı bulunmayan bir belgeyi sunar. `prefix` ve `match` ile tek bir kayıt, bir URL ailesinin tamamını karşılar; `null` döndürmek, URL öğesini WordPress’e bırakır.

Rota, Blockstudio’ın çıktı arabelleğinde oluşturulur; böylece blokları kendi varlıklarını ve Tailwind çıktısını alır. `urls` içindeki yollar statik ön oluşturma derlemelerine katılır ve `Virtual_Routes::urls()` bunları site haritası için döndürür.

[Sanal rotalar](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/#virtual-routes)

functions.php

```
add_action( 'init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function ( $component, string $rest ) {
            get_header();
            echo my_component_page( $component );
            get_footer();
        },
        [
            'prefix' => true,
            'match'  => fn ( string $rest ) => '' === $rest ? 'index' : my_component( $rest ),
            'title'  => fn ( $component ) => my_component_title( $component ),
            'urls'   => fn () => my_component_paths(),
        ]
    );
} );
```

## Siz istediğinizde eşitleyin

Sayfa dosyaları yalnızca siz istediğinizde WordPress değiştirilir. `wp bs pages sync`, değişen her kaynağı uygular, anahtarlı düzenleyici içeriğini korur ve dosyaları silinmiş sayfaları kaldırır.

Parmak izleri bildirim dosyalarını, yükleyicileri, düzenleri ve kaynakları kapsar; bu nedenle değişmemiş sayfalar için yazma işlemi gerekmez. Dağıtımlar `Pages::reconcile()` komutunu çalıştırır ve makine tarafından okunabilir bir rapor alır.

[Eşitleme davranışı](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/#sync-behavior)

Terminal

```
# Apply changed sources, keep keyed edits
wp bs pages sync

# Replace managed content from the files
wp bs pages sync --authoritative

# Compare every page and report as JSON
wp bs pages sync --full --format=json
```

## Anahtarlı bloklar içeriği korur

Herhangi bir bloğa `key` ekleyin. Bir sonraki eşitlemede anahtarlı bloklar şablon özniteliklerini mevcut kullanıcı içeriğiyle birleştirirken anahtarsız bloklar değiştirilir.

Dağıtımlar boyunca yapıyı geliştirin; istemci içeriği olduğu gibi kalsın.

[Anahtarlı bloklar](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/#keyed-block-merging)

index.php

```
<h1 key="title">About Us</h1>
<block name="core/cover" key="hero" url="/hero.jpg">
  <h2>Welcome to our company</h2>
  <p>Edit this content freely.</p>
</block>
<block name="core/columns" key="team">
  <block name="core/column"><h3>Our Team</h3></block>
</block>
```

## Şablon kilitleme ve düzenleme modları

`"all"` değişiklikleri önler, `"contentOnly"` metin düzenlemelerine izin verirken yapıyı kilitler ve `"insert"` ekleme veya kaldırma olmadan düzenlemeye ve yeniden sıralamaya izin verir.

Kilitli bir sayfanın belirli bölümlerini düzenlenebilir yapmak veya tek bir bloğu devre dışı bırakmak için herhangi bir öğeyi `blockEditingMode` ile geçersiz kılın.

[Şablon kilitleme](https://blockstudio.dev/tr/docs/pages-and-patterns/pages/#template-lock)

index.php

```
<h1>Welcome to Our Product</h1>
<p>The best solution for your needs.</p>
<block name="core/cover" blockEditingMode="disabled" url="/static-banner.jpg">
  <p>Promotional banner</p>
</block>
<block name="core/group" blockEditingMode="default">
  <h2>Customizable Section</h2>
</block>
```

## Dosyalardan Site Editor şablonları

`template.json` ve bir şablonu `templates/` konumuna ya da `part.json` öğesini `parts/` konumuna ekleyin; blok temanız dosya tabanlı `wp_template` ve `wp_template_part` kaynaklarını alır.

Sayfalarla aynı sözdizimini kullanırlar. Biri sıfırlayana kadar Site Editor özelleştirmesi önceliklidir; ardından dosya kaynağı geri gelir.

[Site şablonları](https://blockstudio.dev/tr/docs/pages-and-patterns/site-templates/)

templates/front-page/index.php

```
<block name="core/template-part" slug="header" />

<div>
  <h1>Welcome</h1>
  <block name="core/post-content" />
</div>

<block name="core/template-part" slug="footer" />
```

## git içindeki seçili veritabanı içeriği

`wp bs content pull`, izin verilen yazıları, terimleri, ilişkileri ve tanımlanmış meta verileri taşınabilir dosyalara aktarır; `push` bunları başka bir ortama uygular. Tanımlanmış referanslar, üst öğeler ve terim ilişkileri sabit UID’ler olarak taşınır.

Sayfa eşitlemesiyle yönetilen yazılar, `includePageSyncManaged` ile birlikte kullanılabilir. Dosyalarında `"bodyOwner": "page-sync"` bulunur; böylece Content Sync meta verilerini taşırken sayfa eşitlemesi gövdeyi korur.

[İçerik Eşitleme](https://blockstudio.dev/tr/docs/content-sync/)

blockstudio.json

```
{
  "content": {
    "enabled": true,
    "id": "default",
    "path": "content",
    "postTypes": ["team_member"],
    "taxonomies": ["category"],
    "meta": {
      "include": ["_my_*"],
      "references": {
        "_thumbnail_id": { "kind": "attachment" },
        "_related_posts": { "kind": "post", "path": "*" }
      }
    },
    "media": "manifest"
  }
}
```

## Anahtarlı bloklar

Şablonlar geliştikçe kullanıcı içeriğini koruyun.

## Düzenleme modları

Sayfa varsayılanlarını belirleyin ve öğeleri tek tek geçersiz kılın.

## Blok Bağlamaları

İçeriğin eşitleme sırasında korunması için blokları yazı meta verilerine bağlayın.

## Yazı türü şablonları

templateFor, bir sayfayı belirli bir türdeki her yeni yazının başlangıç blok yapısı yapar.

## Sabitlenmiş yazı kimlikleri

postId, bir sayfa silinip yeniden eşitlendiğinde aynı kimliği geri alır; böylece menüler ve bağlantılar çalışmaya devam eder.

## İskeletler ve kilitler

sync: false ile birlikte Pages::force_sync(), düzenleyicilerin sahiplenmesi için bir sayfayı bir kez oluşturur. Pages::lock() ve unlock(), bir sayfanın eşitlenmesini engeller.

## Özel ayrıştırıcı oluşturucuları

Oluşturucu ve renderer filtreleri, bir blok etiketini üçüncü taraf bir bloğun blok dizisine dönüştürür veya bir çekirdek bloğun yazılma biçimini değiştirir.

## Öğe eşlemesi

Bir HTML öğesini başka bir bloğa eşleyin, bloğu öğenin niteliklerinden seçin ve paragraf HTML değerini bir içerik alanına yönlendirin.

## Özel keşif yolları

Filtreler, örneğin bir eklentiden sayfalar, desenler ve Site Editor şablonları için kökler ekler.

## Mantıksal keşif kaynakları

Önizlemeler, katmanlar ve oluşturulan temalar, tek bir tema klasörü yerine birleştirilmiş dosya envanterini Blockstudio’e aktarabilir.

## Kararlı başvurular

Bildirilen yazı, terim ve ek başvuruları, içeri alınırken taşınabilir UID’lere dönüşür; gönderilirken yerel kimliklerle eşleştirilir.

## Gönderim öncesi durum

wp bs content status, her varlığı unchanged, would-update, missing-db, conflict, locked veya orphaned olarak bildirir ve sır gibi görünen meta anahtarları hakkında uyarır.

## Doğrulanmış, kapsamı belirlenmiş gönderimler

Push, yazma işlemi yapmadan önce planın tamamını doğrular ve kilitli varlıkları atlar. –dry-run planı gösterir; –prune –yes ise yalnızca bu içerik kümesinin varlıklarını kaldırır.

## Sürüm denetimli

Sayfa dosyalarını Git içinde izleyin ve ortamlar arasında dağıtın.

## PHP API

Ağaçlara, alt öğelere, meta verilere, eşitlemeye, kilitlemeye ve kimliklere programatik olarak erişin.

Plus

## Resmî uzantı kiti

Premium site şablonları, yapay zekâ sistem talimatları ve özel bir Discord topluluğu. Tek seferlik satın alma, ömür boyu güncellemeler.

- 500+ site şablonu
- Yapay zekâ sistem talimatları
- Ömür boyu güncellemeler
- Özel Discord topluluğu

[Plus edinin](https://blockstudio.dev/tr/plus/)
