İçeriğe geç

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.

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.

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.

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.

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.

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.

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.

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.

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.

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