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.
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}---
title: Installation
order: 10
---
# Installation
Install Blockstudio from this Markdown page.<?php $current = blockstudio_current_page(); ?>
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<?php $is_current = ($item['post_id'] ?? null) === ($current['post_id'] ?? null); ?>
<a
href="<?php echo esc_url($item['permalink'] ?? '#'); ?>"
<?php echo $is_current ? 'aria-current="page"' : ''; ?>
>
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>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.
<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.
{
"name": "legal-notice",
"title": "Legal Notice",
"slug": "legal-notice",
"postStatus": "publish",
"render": { "entry": "page.tsx", "data": "data.php" }
}add_action(
'blockstudio/pages/renderers',
static function (): void {
Blockstudio\Page_Renderers::register(
'react',
array(
'extensions' => array( 'tsx' ),
'layouts' => array( 'layout.tsx' ),
'render' => 'my_theme_render_page',
)
);
}
);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.
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.
# 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$report = Blockstudio\Pages::reconcile();
if (0 === $report['failed']) {
// Once the release is live and verified:
Blockstudio\Pages::store_successful_source_identity(
$report['sourceIdentity']
);
}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.
<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>{
"name": "about",
"title": "About Us",
"slug": "about",
"templateLock": "contentOnly"
}Ş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.
<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>{
"name": "landing",
"title": "Landing Page",
"slug": "landing",
"templateLock": "contentOnly",
"blockEditingMode": "contentOnly"
}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.
<block name="core/template-part" slug="header" />
<div>
<h1>Welcome</h1>
<block name="core/post-content" />
</div>
<block name="core/template-part" slug="footer" />{
"slug": "front-page",
"title": "Front Page",
"description": "Homepage template"
}{
"slug": "header",
"title": "Header",
"area": "header"
}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.
{
"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"
}
}wp bs content pull --dry-run
wp bs content pull
wp bs content status
wp bs content push --dry-run
wp bs content push --prune --yesAnahtarlı 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.
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