Dennis · 23 Temmuz 2026
Blockstudio 7.5
Blockstudio 7.5, Blockstudio için önce dosya yaklaşımını tamamlıyor: özel alan türleri, dosya destekli Site Editor şablonları, blok adacıkları, Storh veritabanı depolaması, mantıksal keşif kaynakları, birleştirilebilir blok etiketleri ve daha hızlı dağıtım ile çalışma zamanı yolları.
Yeniden kullanılabilir özel alanlar, projelerin mevcut alanlardan oluşan bir grubu bir kez tanımlayıp type: "custom/{name}" ile yeniden kullanmasını zaten sağlıyor. Özel alan türleri farklı bir sorunu çözüyor. Tema veya eklentilerin yeni, ad alanı belirlenmiş bir alan türü kaydetmesine, kendi düzenleyici denetimini sağlamasına ve değeri normal Blockstudio verisi olarak saklamasına olanak tanıyor.
Kısaca:
- Mantıksal keşif kaynakları: çalışma zamanları, kaynak bilgisini ve önbellek kimliğini içeren birleştirilmiş mantıksal tema envanteri sağlayabilir; Blockstudio ise keşif, eş dosyaların çözümlenmesi, oluşturulan varlıklar, Canvas ve Tailwind davranışının sahipliğini korur.
- PHP alan türü kayıt defteri: temalar ve eklentiler,
bs_register_field_type()ileacme/dimensionsgibi ad alanlı alan türlerini veyablockstudio/field_typesfiltresini kullanarak kaydedebilir. - Düzenleyici denetim kayıt defteri: özel düzenleyici betikleri
window.blockstudio.registerFieldType()çağrısını yapabilir ve normal Blockstudio alan UI içinde eşleşen React denetimini görüntüleyebilir. - Yapılandırılmış değerler: özel alanlar; nesne değerlerini seçenek alanı normalizasyonundan geçirmeden dizeler, sayılar, boole değerleri, diziler veya nesneler saklayabilir.
- Depolama desteği: yazı meta verileri ve seçenek destekli özel alanlar, nesne ve dizi değerleri de dahil olmak üzere değer türlerini ve REST şemasını belirtebilir.
- Yerel entegrasyon: özel alan türleri gruplarda, sekmelerde, tekrarlayıcılarda, yeniden kullanılabilir özel alanlarda, şablonlarda ve uzantı şablonu yollarında çalışır.
- Site Editor şablonları: temalar,
template.json,part.jsonve Blockstudio şablon dosyalarındanwp_templatevewp_template_partkaynaklarını tanımlayabilir. - Blok adacıkları: bloklar önce önbelleğe uygun bir kabuk oluşturabilir, ardından sayfa yüklendikten sonra isteğe özel parçaları etkinleştirebilir veya toplu olarak getirebilir.
- Storh veritabanı depolaması:
bs.db, karşıya yüklemeler içinde kayıt başına bir dosya kullanan dizinlenmiş bir depodan yararlanabilir; herkese açık tamsayı kimlikleri korunur ve WP-CLI aracılığıyla JSONC’den Storh’e geçiş yapılabilir. - Ayrıştırıcı ve bsui iyileştirmeleri: eşlenen zengin metin paragrafları için daha az özel ayrıştırıcı kodu gerekir;
InnerBlocksbelirteçlere ayrılmışallowedBlockskullanabilir; iç içebs_render_block()çıktısı düzenleyici önizlemelerinde ön yüz görüntülemesiyle eşleşir;bsui/buttonise simgeler ve daha kolay biçimlendirme kancaları kazanır. - Birleştirilebilir blok etiketleri: önek etiketleri başka bir önek üzerinden çözümlenebilir (
<theme-ui-input>,bsui/input‘e); önek ve takma ad etiketleri yalnızca sayfa içeriğinde değil, blok şablonu çıktısında da görüntülenir. - Ana makine güvenli derleme önbellekleri: çalışma zamanı ve düzenleyici önbellekleri artık varsayılan olarak karşıya yüklemeler dışında tutulur, yapılandırılabilir konumları destekler ve eski girdileri temizler; böylece uzun süre çalışan projelerde önbellek dosyaları birikmez.
- Artımlı sayfa uzlaştırması: dağıtım araçları tüm dosya tabanlı sayfa envanterini uzlaştırabilir, değişmeyen yazıları atlayabilir, değişenleri tam olarak bildirebilir ve etkinleştirme sonrasında doğrulanmış bir kaynak kimliğini saklayabilir.
- Daha hızlı sıcak görüntüleme: geçerli çalışma zamanı önbellekleri keşiften önce yüklenir, eşzamanlı soğuk istekler tek bir atomik sonuç yayımlar ve Tailwind site boyutunda bir önbelleği yeniden kullanılabilir derleyici durumuyla birlikte tutar.
- Güvenli toplu görüntüleme: dışa aktarıcılar keşfi yeniden oluşturmadan belgeler arasında istek kapsamlı görüntüleme durumunu sıfırlayabilir ve bloklar görüntülenirken kaynak bağımlılıklarını toplayabilir.
Yeni özellikler
7.5; keşif, şablonlar ve depolama genelinde kapsamlı yeni özellikler sunuyor.
Mantıksal keşif kaynakları
Blockstudio normalde dosyaları fiziksel tema dizinlerinden keşfeder. 7.5; temayı katmanlardan, önizlemelerden, oluşturulan dosyalardan, uzak bağlama noktalarından veya başka birleştirilmiş envanterlerden oluşturan çalışma zamanları için daha alt düzey bir API kaynağı ekler.
Bir entegrasyon, son mantıksal dosya ağacını sağlayabilir; blok, alan, sayfa, desen, Site Editor, Canvas, varlık ve Tailwind davranışının sahipliği ise Blockstudio’da kalır:
use Blockstudio\Inventory_Discovery_Source;
add_filter(
'blockstudio/discovery/sources',
function (array $sources, string $context): array {
if ('blocks' !== $context) {
return $sources;
}
return [
new Inventory_Discovery_Source(
'preview:feature-card',
'/runtime-preview/feature-card/blockstudio',
[
'card/block.json' => [
'path' => '/theme/blockstudio/card/block.json',
'provenance' => ['layer' => 'parent'],
],
'card/index.php' => [
'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
'provenance' => ['layer' => 'preview'],
],
],
'preview-fingerprint'
),
];
},
10,
2
);
Fiziksel eş dosyalar farklı köklerden gelse bile mantıksal yollar kararlı kalır. Kaynak kimlikleri ve parmak izleri çalışma zamanı ve Tailwind önbellek kimliklerine dahil edilir; izlenen girdiler bunları geçersiz kılar ve kaynak bilgisi, oluşturulan dosyaların nereye yazılabileceğini belirler. Normal temalar için varsayılan dosya sistemi kaynağı değişmez.
Dosya tabanlı Site Editor şablonları
Sayfalar ve desenler, ekiplerin içerik yapılarını dosyalarda tutmasına zaten olanak tanıyordu. 7.5 bu modeli doğrudan Site Editor’a da genişletiyor.
theme/
templates/
front-page/
template.json
index.php
parts/
header/
part.json
index.php
{
"slug": "front-page",
"title": "Front Page"
}
<div class="site-shell">
<block name="core/template-part" slug="header" />
<main>
<h1>Welcome</h1>
<block name="core/post-content" />
</main>
</div>
Blockstudio, kaynağı sayfalar ve desenlerle aynı ayrıştırıcıyı kullanarak derler, ardından sonucu WordPress’e normal bir Site Editor şablonu veya şablon parçası olarak sunar. Site Editor şablonu görür, ön yüz onu görüntüleyebilir ve özelleştirmelerin sahipliği WordPress’da kalır.
Son kısım önemlidir. Dosya tabanlı şablonlar kaynak yedeğidir. Kullanıcı Site Editor’da bir şablonu kaydederse WordPress normal wp_template veya wp_template_part veritabanı özelleştirmesini oluşturur ve bu sürüm öncelik kazanır. Özelleştirmeyi sıfırlayın; en güncel dosya kaynağı yeniden görünür.
Artımlı sayfa dağıtımı
Dosya tabanlı sayfalara 7.5’te bir dağıtım uzlaştırma API özelliği eklendi. 7.6.2 itibarıyla bu açık API ve wp bs pages sync, eşitleme için kullanılan tek giriş noktalarıdır; normal istekler kaynak değişikliklerini hiçbir zaman uygulamaz:
$report = Blockstudio\Pages::reconcile([
'authoritative' => true,
'plan_valid' => true,
'source' => [
'commit' => $commit,
'dirtyHash' => $dirtyHash,
],
]);
İşlem, istenen tüm sayfa envanterini keşfeder, içerik ve eşitleme motoru parmak izlerini karşılaştırır ve oluşturulan, güncellenen, değişmeyen, kaldırılan ve başarısız olan sayfaları bildirir. Parmak izleri aynı olan sayfalarda yazı veya yazı meta verisi yazılmaz. Yönetilen eksik sayfalar yalnızca keşif hatasız tamamlandıktan sonra temizlenir.
Uzlaştırma belirleyici bir kaynak kimliği döndürür ancak dağıtımın başarılı olduğunu işaretlemez. Dağıtım araçları bu kimliği yalnızca eşleşen dosyalar ve yönlendirmeler etkinleştirilip doğrulandıktan sonra saklar. Normal WP-CLI başlatma işlemi, her sayfayı keşfedip eşitlemeden önbelleğe alınmış koleksiyon yazı türlerini ve yeniden yazma kurallarını kaydeder.
Blok adacıkları
Blockstudio bloklarının çoğu sunucu tarafında görüntülenir. Bu, WordPress için uygundur; ancak tanıdık bir önbellekleme sorunu doğurur: kişiselleştirilmiş tek bir blok tüm sayfanın önbelleğe alınmasını zorlaştırabilir.
Blok adacıkları bu sınırı blok düzeyinde ayırır.
{
"name": "acme/cart-count",
"blockstudio": {
"island": "dynamic"
}
}
Dinamik bir adacık ilk yanıtta yalnızca önbelleğe uygun bir yer tutucu görüntüler. Tarayıcı daha sonra sayfadaki hazır tüm dinamik adacıklar için tek bir toplu istek gönderir ve Blockstudio bu parçaları ziyaretçinin gerçek istek bağlamında görüntüler.
Böylece tam sayfa önbelleği sayfa kabuğunu saklarken sepet sayısı, hesap denetimleri, izinle kısıtlanmış UI veya kullanıcıya özel diğer parçalar güncel kalabilir.
<div class="cart-count-placeholder">Loading cart...</div>
<div class="cart-count">
<?php echo esc_html(acme_cart_count()); ?>
</div>
Zaten önbelleğe uygun HTML görüntüleyen ve yalnızca bir ön yüz bağlama sinyaline ihtiyaç duyan bloklar için etkinleştirilmiş bir adacık kullanın:
{
"name": "acme/tabs",
"blockstudio": {
"island": "hydrate"
}
}
Etkinleştirilmiş adacıklar bir REST isteği yapmaz. Normal şekilde görüntülenir ve ön yüzde bir blockstudio:island:hydrate etkinliği alırlar.
Dinamik adacıklar programlı görüntüleme yollarında da çalışır:
bs_render_block([
'name' => 'acme/cart-count',
'data' => ['productId' => 42],
]);
Blok etiketleriyle de kullanılabilir:
<bs:acme-cart-count product-id="42" />
Uç noktanın kapsamı bilerek dar tutulmuştur. Yalnızca kayıtlı, dinamik olan ve açıkça dinamik adacık olarak işaretlenmiş Blockstudio bloklarını görüntüler. Öznitelikler blok şemasına ve adacık izin listesine göre filtrelenir; her işaretçi, hizmet veren WordPress sitesi tarafından oluşturulmuş bir imza taşır.
Storh veritabanı depolaması
Blockstudio veritabanı katmanı zaten tabloları, SQLite, JSONC, yazı meta verilerini ve özel yazı türlerini destekliyor. 7.5, daha güvenli eşzamanlı yazımlar ve şemadan türetilen dizinlerle dosya tabanlı bir depo isteyen; ancak canlı kayıtları blok kaynak dosyalarının yanında saklamak istemeyen projeler için storage: "storh" ekliyor.
return [
'storage' => 'storh',
'fields' => [
'title' => ['type' => 'string', 'required' => true],
'status' => ['type' => 'string'],
'count' => ['type' => 'integer'],
],
];
Storh kayıtları karşıya yüklemeler içinde saklanır:
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
Herkese açık API değişmeden kalır. bs.db(), REST ve Db::get() hâlâ tamsayı id değerleri döndürür. Dahili olarak Blockstudio bu kimlikleri Storh’ın UUIDv7 belge kimlikleriyle eşler; dolayısıyla mevcut istemci kodunu değiştirmeniz gerekmez.
Bildirilen her şema alanı eşitlik filtreleri için dizinlenir; sayısal ve tarih benzeri alanlar aralık dizinleri alır ve açık benzersizlik ipuçları aktarılır. JSONC tohum dosyalarıyla başlayan projeler için yeni CLI geçişi, kaynak dosyayı yerinde bırakıp eşdeğer bir Storh deposu yazar:
wp bs db migrate my-theme/app subscribers --to=storh
Böylece JSONC basit ve depoya eklenebilir bir tohum/yapılandırma biçimi olarak daha net bir rol üstlenirken Storh, yazılabilir üretim verileri için daha iyi bir varsayılan dosya arka ucu haline gelir.
Ayrıştırıcı ve bsui iyileştirmeleri
7.5 ayrıca proje dosya tabanlı şablonlara ve paketlenmiş UI öğelerine daha çok dayandığında öne çıkan küçük eksiklikleri de gideriyor.
Öğe eşleme artık sık karşılaşılan zengin metin paragrafı durumunu özel bir oluşturucu olmadan işleyebilir. <p>, content zengin metin özniteliğine sahip, kayıtlı ve çekirdek olmayan bir Blockstudio bloğuna eşlenirse basit iç metin bu özniteliğe kopyalanır. İç içe etiketler ve eşlenen alt öğeler iç bloklar olarak ayrıştırılmaya devam eder.
InnerBlocks, şablonlarda belirteçlere ayrılmış allowedBlocks kabul eder:
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
'core/paragraph',
'category:content',
'bsui/field',
])); ?>" />
Desteklenen belirteçler: namespace/*, category:<slug> ve @theme. Şablon düzenleyiciye ulaşmadan önce sunucuda genişletilirler; bu nedenle ön yüz görüntüleme yolu değişmez.
Programlı gömülü içerikler de daha öngörülebilir hale geldi. bs_render_block() ve bs_block(), başka bir bloğun düzenleyici önizlemesinin içinden çağrılsalar bile gömülü blokları artık ön yüzde çözümlenen HTML olarak görüntüler. Böylece iç içe bloklar, önizleme işaretlemesine ham <RichText /> veya <InnerBlocks /> sözde bileşenlerini sızdırmaz.
Paketlenmiş UI için bsui/button artık icon özniteliğini ve iconPosition özelliğini destekliyor. Paketlenmiş bsui/* satır içi stilleri artık bir @layer bsui kademeli katmanında yayımlanıyor; düğme varyantları ise mevcut blockstudio/blocks/attributes filtresine ek olarak blockstudio/ui/button/variants-style ile genişletilebiliyor.
Blok etiketleri daha da iyi birleştiriliyor. Bir önek başka bir önek üzerinden çözümlenebilir; dolayısıyla theme proje önekiyle ui ad alanı önekini kullanan <theme-ui-input />, bsui/input olarak çözümlenir. Kayıtlı önek ve takma ad etiketleri artık yalnızca sayfa içeriğinde değil, blok şablonu çıktısında da görüntülenir; böylece şablon doğrudan bu etiketleri üretebilir ve bs_render_block() çağrısı gerekmez.
blockstudio/block_tags/builders aracılığıyla kaydedilen özel blok oluşturucular da etiket ve eşlenen öğe ayrıştırmasına tutarlı biçimde katılır. Açık görüntüleyici filtreleri daha sonra çalışmaya devam eder ve oluşturucunun sonucunu geçersiz kılabilir.
Daha hızlı sıcak istekler ve dışa aktarımlar
Çalışma zamanı ve düzenleyici önbellekleri artık varsayılan olarak karşıya yüklemeler yerine wp-content/blockstudio/cache konumunda tutulur. Konum cache.path veya blockstudio/cache/dir ile değiştirilebilir; bu sayede karşıya yüklemeler altındaki PHP yüklerini engelleyen ana makinelerde kalıcı önbellekleme kullanılabilir. Çalışma zamanı, düzenleyici varlığı ve Tailwind önbellekleri de eski girdileri otomatik olarak temizler; böylece uzun süre çalışan projelerin diskinde sınırsız sayıda önbellek dosyası birikmez.
Ön yüzdeki sıcak istekler artık keşif kaynaklarını oluşturmadan önce geçerli bir çalışma zamanı kayıt defterini yükler. Böylece özyinelemeli kaynak keşfi, blok oluşturma, alan ayrıştırma ve önbellek anahtarı için ağaçları tekrar tekrar dolaşma işlemleri atlanır. Üretim ve hazırlık ortamlarındaki istekler varsayılan olarak doğrulanmış bir izleme anlık görüntüsüne 20 saniye boyunca güvenirken yerel ve geliştirme ortamlarında her istekte kontrol yapılmaya devam edilir.
Soğuk önbellek tek bir istekle oluşturulur. Bir istek yükü oluşturup atomik olarak yayımlarken eşzamanlı istekler tamamlanmasını bekler. Tailwind artık varsayılan olarak 30 gün boyunca en fazla 1,000 derlenmiş girdi tutar ve sıcak derleyici oluşturma durumunu yeniden kullanır; böylece site boyutundaki bir rota kümesi küçük bir önbelleği durmadan yenilemez.
Uzun süre çalışan dışa aktarıcılar belgeler arasında Blockstudio\Batch_Render::reset() çağrısını yapabilir. Bu, keşfi yeniden oluşturmadan istek kapsamlı sayaçları, varlıkları, adacıkları, düzenleri ve Tailwind oluşturmayı temizler. blockstudio/render/dependencies filtresi, bağımlılık grafikleri için görüntülenen her blokta kullanılan şablon ve varlık yollarını sunar.
Güvenilirlik ve uyumluluk
Sürümü tamamlayan birkaç düzeltme:
blockstudio/blocks/attributesüzerinden değiştirilen alan tanımları artık düzenleyici şemasının yanı sıra görüntüleme sırasında seçenek doğrulamasını da yönlendiriyor. Türü belirlenmiş sayısal ve boole seçenek değerleri de tutarlı biçimde çözümleniyor.- Düzenleyici blok sarmalayıcıları ön yüzdeki görüntülemelerle aynı oluşturulan sınıfları kullanır; Canvas ise yeni
blockstudio/editor/canvas/body_classfiltresiyle yapılandırılmış ön yüz gövde sınıflarını kopyalayabilir. - İçerik Eşitleme, yıkıcı yazma işlemlerinden önce tüm kaynak planını doğrular, temizleme işlemlerini yapılandırılmış içerik kümesinin içinde tutar ve dosya yazma hatalarını bildirirken ilgili varlığın eşitleme durumunu ilerletmez.
- Sembolik bağlantılı etkin temalarda veya üst temalarda paketlenmiş Composer, düzenleyici varlıklarını herkese açık tema URL konumundan çözümler.
- Anahtarlı dosya sayfaları, düzenleyicinin sahip olduğu Blockstudio alan değerlerini korur; eşitleme sırasında eski iç içe anahtar biçimini geçirir ve sıfır sayısal değeri geçerli anahtar olarak kabul eder.
- Dinamik adacıklar istek öznitelik filtrelerinden önce imzaları doğrular, imzasız istek bağlamını yok sayar, aynı kaynaklı oturum açmış ziyaretçileri geri yükler ve anonim kullanıcı başına önbellek çakışmalarını önler.
- Ham Markdown sayfa uç noktaları artık yazı görünürlüğüne ve parola korumasına uyar.
- Düzenleyici denetimleri artık boş koşulları, tümünü aç/kapat onay kutusu değerlerini, eşzamansız seçenek yenilemelerini, dinamik görüntüleme sıralamasını ve tekrarlayıcı RichText veya WYSIWYG durumunu daha güvenilir biçimde işler.
Özel alan türleri
Yukarıda tanıtılan özel alan türleri hakkında daha fazla bilgi.
Özel alan türleri neden gerekli?
Blockstudio kutudan çıktığı haliyle kullanışlı olmalı; ancak gerçek projelerde genellikle aralık belirteci seçicileri, tasarım sistemi renk rolleri, duyarlı boyutlar, simge kaynakları, ürün seçicileri veya yapılandırılmış bir değere eşlenen editoryal denetimler gibi alana özgü denetimler gerekir.
7.5 öncesinde bu projeler ya birkaç yerleşik alanı birleştirebiliyor ya da düzenleyiciyi çatallıyordu. 7.5 desteklenen bir orta yol sunuyor: alan yaşam döngüsünün sahipliği Blockstudio’da, denetimin sahipliği ise projede.
add_action('init', function () {
wp_register_script(
'acme-field-dimensions',
get_stylesheet_directory_uri() . '/fields/dimensions.js',
['blockstudio-blocks', 'wp-components', 'wp-element'],
'1.0.0',
true
);
bs_register_field_type('acme/dimensions', [
'attribute' => 'object',
'default' => [],
'editor_script' => 'acme-field-dimensions',
'storage' => [
'type' => 'object',
'rest_schema' => [
'type' => 'object',
'additionalProperties' => ['type' => 'string'],
],
],
]);
});
const { createElement: el } = wp.element;
const { TextControl } = wp.components;
window.blockstudio.registerFieldType('acme/dimensions', {
component(props) {
const value =
props.value &&
typeof props.value === 'object' &&
!Array.isArray(props.value)
? props.value
: {};
const sides = props.sides || ['top', 'right', 'bottom', 'left'];
return el(
'div',
{},
sides.map((side) =>
el(TextControl, {
key: side,
label: side,
value: value[side] || '',
onChange(nextValue) {
props.onChange({
...value,
[side]: nextValue,
});
},
}),
),
);
},
});
Ardından alan, yerel bir alan gibi block.json içinde kullanılabilir:
{
"blockstudio": {
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"label": "Margin",
"sides": ["top", "bottom"],
"default": {
"top": "md",
"bottom": "md"
}
}
]
}
}
Normal şablon değerleri
Kaydedilen değere, diğer tüm Blockstudio öznitelikleri gibi PHP, Twig ve Blade içinde erişilebilir.
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
<?php echo esc_html($a['title'] ?? ''); ?>
</div>
Aynı nesne yolları uzantı şablonlarında da çalışır:
{
"blockstudio": {
"extend": "core/group",
"attributes": [
{
"id": "margin",
"type": "acme/dimensions",
"set": [
{
"attribute": "class",
"value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
}
]
}
]
}
}
Uyumluluk notları
Mevcut yerleşik alan türleri değişmez. Mevcut custom/{name} yeniden kullanılabilir alan grupları da değişmez. Özel alan türü adları küçük harfli ve ad alanlı olmalıdır; örneğin acme/dimensions. custom/ ve blockstudio/ ad alanları ayrılmıştır.
PHP bir alan türü kaydeder ancak düzenleyici betiği eşleşen denetimi kaydetmezse Blockstudio kaydedilmiş değeri korur ve düzenleyicide düzenlenemeyen bir bildirim gösterir. Bir alan türü PHP içinde kayıtlı değilse Blockstudio onu oluşturulan WordPress özniteliklerine dahil etmez.
7.5.1 bakım güncellemesi
7.5.1, birden fazla seçim değerini görüntülemeye hazırlarken oluşan dizi-dize dönüştürme uyarısını kaldırır. Kaydedilen ve görüntülenen değerler zaten doğruydu ancak hata ayıklama günlüklerine her alan görüntülemesinde bir uyarı yazılabiliyordu.
blockstudio/phpstan v0.1.7 güncellemesi ayrıca PHP, Twig, Blade boyunca anonim grupların içine yerleştirilmiş alanları ve çıkarımla elde edilen şablon öznitelik yapılarını da tanır. Mevcut projeler bu paket düzeltmesini composer update blockstudio/phpstan ile alabilir.