Dennis · 7 Şubat 2026
Introducing Blockstudio 7
Blockstudio 7 çıktı. Bu, projenin tarihindeki en büyük sürüm: tüm kod tabanının baştan sona yeniden yazımı. Her sınıf, her kanca ve her kod satırı; modern PHP, WordPress kodlama standartlarına ve uzun vadeli sürdürülebilirliğe odaklanılarak sıfırdan yeniden oluşturuldu.
Ancak bu yalnızca bir yeniden düzenleme değil. Blockstudio 7; dosya tabanlı sayfalar ve desenler, yazı meta veri depolama sistemi, SEO entegrasyonu ve tüm bunları destekleyen yepyeni bir HTML-blok ayrıştırıcısı gibi önemli yeni özellikler sunuyor. Üstelik Blockstudio artık tamamen ücretsiz ve açık kaynak.
Yeniliklerin tümüne göz atalım.
Ücretsiz ve açık kaynak
Blockstudio üzerinde 2020 tarihinden beri çalışıyor, yıllar içinde onlarca sürüm yayımlıyorum. Kullananlar ürünü sevdi, ancak ticari bir WordPress blok çerçevesi için pazarda yer bulmak hep zordu.
Dengeyi değiştiren LLM’ler oldu. Yapay zekâ kodlama asistanları artık blok kodu yazabilecek kadar iyi, ancak çalışabilmeleri için temiz, dosya tabanlı yapılara ihtiyaçları var. WordPress blok işaretlemesi karmaşık: içine JSON öznitelikleri yerleştirilmiş serileştirilmiş HTML yorumları, DOM yapısıyla iç içe. İnsanların doğru yazması zor, LLM’ler içinse daha da zor.
Blockstudio dosya öncelikli yaklaşımı her zaman işleri basit tutmak için tasarlandı: bir klasörde bir block.json ve bir PHP şablonu. Veritabanı girdisi yok, React yok, derleme adımı yok. v7 ile bu yaklaşım daha da ileri gidiyor. HTML-blok ayrıştırıcısı, düz HTML yazmanıza ve bunun otomatik olarak geçerli blok işaretlemesine dönüştürülmesine olanak tanıyor. Her şey dosya sisteminde kalıyor. Veritabanına yalnızca PHP API veya CLI üzerinden açıkça istenen sayfa eşitlemeleri yazılıyor; bunlar da dosya şablonları tarafından yürütülüyor.
Blockstudio’ı açık kaynak yapmak doğal bir sonraki adım. LLM’ler Blockstudio koduyla ne kadar çok eğitilirse kod üretmede o kadar iyileşiyorlar. Açık bir kod tabanı, açık belgeler ve her aracın kullanabileceği önceden hazırlanmış bir yapay zekâ bağlam dosyası: yapay zekâ destekli WordPress geliştirme için en iyi ortam böyle oluşturulur.
Eklentinin tamamı, herkesin kullanması, çatallaması ve katkıda bulunması için GitHub üzerinde mevcut. Lisans anahtarı yok, ödeme duvarı yok, özellik kısıtlaması yok.
Yeni özellikler
Dosya tabanlı sayfalar
Bu, 7.0 sürümündeki en büyük yeniliklerden biri. Artık bütün WordPress sayfalarını, sayfa eşitleme API veya CLI komutunu çalıştırdığınızda yerel blok içeriği olarak veritabanıyla eşitlenen dosya şablonları biçiminde tanımlayabilirsiniz.
page.json ve bir şablon dosyası içeren bir klasör oluşturun:
{
"name": "about",
"title": "About Us",
"slug": "about",
"postStatus": "publish"
}
<div class="about-page">
<h1>About Us</h1>
<p>Welcome to our site.</p>
</div>
wp bs pages sync komutunu çalıştırarak Blockstudio aracının HTML dosyasını WordPress bloklarına ayrıştırmasını ve veritabanındaki sayfayı oluşturmasını ya da güncellemesini sağlayın.
Anahtarlı blok birleştirme
Şablonlar eşitlendiğinde kullanıcı düzenlemeleri normalde üzerine yazılırdı. key özniteliği, eşitlemeler boyunca kullanıcı içeriğini koruyarak bu sorunu çözer:
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
Eşleşen anahtarlara sahip bloklar, şablon güncellendiğinde kullanıcı tarafından düzenlenmiş içeriklerini korur. Anahtarı olmayan bloklar tamamen değiştirilir.
Blok bağlamaları
Anahtarlara alternatif olarak, blokları doğrudan yazı meta verilerine bağlamak için WordPress çekirdeğinin Blok Bağlamaları API özelliğini kullanabilirsiniz. Bu bir Blockstudio özelliği değil, yerel bir WordPress API özelliğidir. Blockstudio yalnızca metadata özniteliğini oluşturulan blok işaretlemesine aktarır. İçerik blok işaretlemesi yerine meta verilerde bulunur; böylece şablon eşitlemeleri kullanıcı düzenlemelerini asla silmez. Veriler ayrıca WP_Query üzerinden sorgulanabilir ve REST API aracılığıyla kullanılabilir.
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
Default Title
</h1>
Her iki yaklaşım da aynı şablonda kullanılabilir.
Düzenleme denetimleri
Sayfalar, kullanıcıların neleri değiştirebileceğini denetlemek için blockEditingMode ve templateLock destekler:
{
"name": "landing",
"title": "Landing Page",
"blockEditingMode": "contentOnly",
"templateLock": "all"
}
Bu özellik, kullanıcıların metin ve medyayı düzenlemesine izin verirken sayfa yapısını kilitler. Şablondaki blockEditingMode özniteliğiyle tek tek öğelerde sayfa düzeyindeki ayar geçersiz kılınabilir.
Yazı kimliklerine sabitleme
Bir sayfa şablonunu mevcut bir WordPress yazısına bağlamak, yinelenen sayfaları önlemek ve şablonun her zaman doğru yazıyı güncellemesini sağlamak için postId kullanın:
{
"name": "home",
"title": "Home",
"postId": 2
}
Ayrıntıların tamamı için Sayfalar belgelerine bakın.
Dosya tabanlı desenler
Sayfalara benzer şekilde artık blok desenlerini dosya şablonları olarak tanımlayabilirsiniz. Deseninizi HTML içinde yazın; Blockstudio bunu blok işaretlemesine dönüştürüp yerel bir WordPress blok deseni olarak kaydeder. Desenler blok ekleyicide görünür ve kullanıcılar tarafından istedikleri yere yerleştirilebilir.
{
"name": "hero-section",
"title": "Hero Section",
"categories": ["featured"],
"keywords": ["hero", "banner"]
}
<div class="hero">
<h1>Welcome</h1>
<p>Get started today.</p>
</div>
Sayfalardan farklı olarak desenler veritabanı girdisi oluşturmaz. Her sayfa yüklemesinde belleğe kaydedilirler. Desenler belgelerine bakın.
HTML-blok ayrıştırıcısı
Hem sayfalar hem de desenler, standart HTML şablonlarını WordPress blok işaretlemesine dönüştüren yeni bir HTML ayrıştırıcısıyla çalışır. Bu ayrıştırıcı kapsayıcı blokları (gruplar ve sütunlar gibi) ve yaprak blokları (paragraflar ve başlıklar gibi) otomatik olarak işler. Ayrıştırıcı, trait tabanlı bir oluşturucu mimarisi kullanır; böylece blockstudio/parser/renderers filtresi aracılığıyla ek blok türleri için destek eklemek kolaylaşır:
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
$renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
$content = $parser->get_inner_html( $element );
$html = '<div class="acme-hero">' . $content . '</div>';
return array(
'blockName' => 'acme/hero',
'attrs' => $attrs,
'innerBlocks' => array(),
'innerHTML' => $html,
'innerContent' => array( $html ),
);
};
return $renderers;
}, 10, 2 );
Kaydedildikten sonra bloğu herhangi bir sayfa veya desen şablonunda kullanabilirsiniz:
<block name="acme/hero" background="/hero.jpg">
<h1>Welcome to our site</h1>
</block>
Depolama
Alanlar artık blok özniteliklerine ek olarak değerlerini yazı meta verilerinde veya site seçeneklerinde saklayabiliyor. Bu önemli bir yenilik:
{
"id": "subtitle",
"type": "text",
"label": "Subtitle",
"storage": {
"type": "postMeta"
}
}
Yazı meta verilerindeki değerlerle şunları yapabilirsiniz:
WP_Queryvemeta_querykullanarak yazıları alan değerlerine göre sorgulama- Başsız kurulumlar için alan verilerine REST API üzerinden erişme
- SEO araçları ve önbellekleme katmanları gibi diğer eklentilerle veri paylaşma
Genel, site genelindeki ayarlar için değerleri seçenekler tablosunda da saklayabilirsiniz:
{
"id": "phone",
"type": "text",
"label": "Phone Number",
"storage": {
"type": "option",
"optionKey": "company_phone"
}
}
Ayrıntıların tamamı için Depolama belgelerine bakın: API.
Özel alanlar
Yeniden kullanılabilir alan tanımları artık birden fazla blok arasında paylaşılabilir. Bir alan kümesini bir kez tanımlayın, ardından herhangi bir blokta kullanın. Böylece birden fazla blok aynı alan yapısını paylaştığında tekrarların önüne geçilir.
blockstudio dizininizde bir field.json oluşturun:
{
"name": "hero",
"title": "Hero Section",
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
Ardından custom/ önekini kullanarak bunu herhangi bir blokta kullanın:
{
"blockstudio": {
"attributes": [
{ "type": "custom/hero", "idStructure": "hero_{id}" }
]
}
}
idStructure özelliği her alan kimliğinin başına eklenir; böylece heading, hero_heading haline gelir. Ayrıca overrides anahtarıyla tek tek alan özelliklerini örnek bazında geçersiz kılabilirsiniz.
Ayrıntılar için Özel Alanlar belgelerine bakın.
Tailwind CSS v4
Tailwind desteği v4 için baştan sona yeniden oluşturuldu. CDN aracılığıyla istemci tarafında derleyip yazı kaydedildiğinde diske kaydetmek (v6 yaklaşımı) yerine Blockstudio 7, her ön yüz isteğinde Tailwind’i TailwindPHP aracılığıyla sunucu tarafında derliyor. Node.js yok, CLI yok, derleme adımı gerekmiyor.
Derleme, aday tabanlı önbellekleme kullanır: Blockstudio son HTML içindeki tüm CSS sınıf adlarını çıkarır, bunları CSS yapılandırmanızla birlikte sıralayıp özetler ve önbellekte bir dosya olup olmadığını denetler. Çevresindeki HTML değişse bile (nonce’lar, zaman damgaları, dinamik içerik), aynı sınıflar önbellekte aynı sonucu verir.
Yapılandırmada Tailwind v4’ın CSS öncelikli sözdizimi kullanılır. Özel temaları ve yardımcı sınıfları doğrudan blockstudio.json içinde veya blockstudio/tailwind/css filtresi aracılığıyla tanımlayın:
add_filter('blockstudio/tailwind/css', function ($css) {
return $css . '
@theme {
--color-brand: #4f46e5;
}
@layer utilities {
.container-narrow {
max-width: 48rem;
margin-inline: auto;
}
}
';
});
Blok düzenleyicide, birlikte sunulan Tailwind CDN betiği siz yazarken canlı önizleme sağlar. classes alan türü, tüm Tailwind yardımcı sınıfları için otomatik tamamlama sunar. Ön yüz, satır içi stil etiketi olarak </head> öncesine eklenen, sunucuda derlenmiş CSS dosyasını kullanır.
Kurulumun tamamı için Tailwind belgelerine bakın.
Etkileşim API
Blockstudio artık WordPress Etkileşim API özelliğini destekliyor. block.json içinde etkinleştirin:
{
"blockstudio": {
"interactivity": true
}
}
Şablonunuza data-wp-* yönergelerini ekleyin:
<div useBlockProps
data-wp-interactive="myBlock"
data-wp-context='{ "isOpen": false }'>
<button data-wp-on--click="actions.toggle"
data-wp-bind--aria-expanded="context.isOpen">
Toggle
</button>
<div data-wp-bind--hidden="!context.isOpen">
This content is toggled by the button.
</div>
</div>
Ardından mağaza mantığınızı içeren bir script.js oluşturun:
import { store, getContext } from '@wordpress/interactivity';
store('myBlock', {
actions: {
toggle: () => {
const context = getContext();
context.isOpen = !context.isOpen;
},
},
});
Blockstudio, hem ön yüzde hem de blok düzenleyicide importmap’i, modül yüklemeyi ve yönerge işlemeyi yönetir. Yalnızca data-wp-context kullanan bildirimsel yönergelere sahip bloklar (data-wp-bind--hidden veya data-wp-text gibi), herhangi bir JavaScript olmadan çalışır. wp_interactivity_state() aracılığıyla sunucu tarafı durum desteği de ön yüzde kullanılabilir.
Kurulumun tamamı için Etkileşim belgelerine bakın.
SEO içerik analizi
Blockstudio blokları dinamiktir; bu nedenle alan içerikleri varsayılan olarak SEO eklentilerine görünmez. Blockstudio 7, Yoast SEO, Rank Math ve SEOPress için otomatik entegrasyonlarla bu sorunu çözüyor. text, textarea, richtext, wysiwyg ve link alanlarındaki metin değerleri (iç içe yineleyici satırları dahil) çıkarılıp her eklentinin içerik analizine aktarılır. SEO eklentileri artık blok içeriğinizi anahtar kelime yoğunluğu, okunabilirlik ve diğer ölçütler açısından doğru biçimde analiz edebilir. Yapılandırma gerekmez.
Yineleyici varsayılan satırları
Yineleyici alanları artık önceden doldurulmuş satırlardan oluşan bir dizi içeren default özelliğini destekliyor. Bir blok eklendiğinde yineleyici, hem düzenleyicide hem de ön yüzde belirtilen satırlarla ve değerleriyle doldurulur:
{
"id": "features",
"type": "repeater",
"label": "Features",
"default": [
{ "title": "Fast", "icon": "bolt" },
{ "title": "Secure", "icon": "shield" }
],
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "icon", "type": "text", "label": "Icon" }
]
}
min özelliği alan düzeyindeki varsayılanlarla da çalışır: bir yineleyicide min: 3 ve iç alanlarında default değerleri varsa, otomatik oluşturulan satırlar boş olmak yerine bu varsayılanlarla doldurulur.
İyileştirmeler ve düzeltmeler
- Alan varsayılanlarıyla yineleyici
min: otomatik oluşturulan minimum satırlar artık hem ön yüzde hem de düzenleyicide alan düzeyindeki varsayılan değerleri kullanıyor - Tailwind düzenleyici stilleri: derlenmiş Tailwind CSS artık CDN ile birlikte blok düzenleyici iframe’ine ekleniyor; böylece özel
@applykuralları ve tema yapılandırması düzenleyicide çalışıyor - Yapay zekâ bağlam dosyası:
blockstudio-llm.txt, v6 üzerinden dinamik oluşturma yerine tüm v7 belgelerinden ve yinelenenlerden arındırılmış JSON şemalarından (~48k belirteç) derlenen statik bir dosya olarak yeniden oluşturuldu - Kod alanı ayrı penceresi: kod alanı artık bağımsız geri al/yinele ve JavaScript sözdizimi vurgulamayla ayrı bir pencerede açılabiliyor
- Tailwind v4 sunucu tarafı derlemesi: yukarıdaki Tailwind bölümüne bakın
- API 3. sürüm: bloklar artık site düzenleyicisi ve duyarlı önizlemeler dahil iframe kullanılan düzenleyicide doğru görüntüleniyor
- Varlıklarda nokta gösterimi: varlık son ekleri için daha temiz dosya adlandırma düzeni (
*.inline.css,*.editor.js,*.scoped.css) useBlockPropskullanılırkenWP_Block_Supportskaynaklıbs_render_block()uyarısı düzeltildi- Koşullu alanların ilk yüklemede varsayılan değerleri dikkate almaması düzeltildi
- Ön yüzdeki
<RichText />içeriğinden dolar işaretlerinin silinmesi düzeltildi populateözelliğinin diğer eklentiler tarafından kaydedilen taksonomilerle çalışması sağlandı- WPML bağlamlarındaki
optionsPopulatenull hatası düzeltildi
Kaputun altında
Baştan sona yeniden yazım
Bu bir yeniden düzenleme veya temizlik değil. Her sınıf sıfırdan yeniden yazıldı. Sonuç, bakımı ve genişletilmesi daha kolay, daha temiz ve modüler bir kod tabanı.
Modern PHP
Blockstudio 7, PHP 8.2+ gerektiriyor ve genelinde modern tür bildirimleri kullanıyor.
Uyumluluğu bozan değişiklikler
Ana sürüm güncellemesi olarak 7.0, uyumluluğu bozan birkaç değişiklik içeriyor. Çoğunda geriye dönük uyumlu çözümler bulunsa da yükseltmeden önce bunları gözden geçirmelisiniz. Geçiş kılavuzunun tamamı için v7 geçiş belgelerine bakın.
Kanca adları artık snake_case kullanıyor
Tüm PHP kancalarının adları camelCase’ten snake_case’e değiştirildi; böylece WordPress çekirdek kurallarıyla uyum sağlandı:
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
return ['my-stylesheet'];
});
// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet'];
});
Eski camelCase adları çalışmaya devam ediyor, ancak güncellemenizi öneriyoruz.
Alan anahtarı varsayılan olarak kapalı
switch özelliği artık true yerine varsayılan olarak false değerini alıyor. v6 sürümünde her alanın sol kenarında varsayılan olarak etkinleştirilmiş görünmez bir anahtar vardı. v7 sürümünde anahtar isteğe bağlıdır ve alan etiketinde görünür bir göz simgesi kullanır. Varsayılan anahtar davranışına bağlıysanız alan tanımlarınıza "switch": true ekleyin.
Varlık dosyası adlarında nokta gösterimi
Varlık son eklerinde artık tire yerine nokta kullanılıyor (style.inline.css yerine style-inline.css). Eski tire gösterimi çalışmaya devam ediyor, ancak bundan sonra nokta gösterimi önerilen düzen.
npm içe aktarma öneki
ES modülü içe aktarımlarında artık blockstudio/ yerine npm: kullanılıyor:
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";
// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
blockstudio/ öneki geriye dönük uyumluluk için desteklenmeye devam ediyor.
Kaldırılan özellikler
Yönetim alanı ve kod düzenleyici. WordPress yönetici ayarları sayfası ve yerleşik blok kod düzenleyicisi kaldırıldı. Artık tüm yapılandırma blockstudio.json ve PHP filtreleri üzerinden yapılıyor; böylece kurulumunuz bloklarınızla birlikte sürüm denetiminde tutuluyor.
Kod düzenleyici önceki sürümlerde blokları önizlemek için kullanışlıydı, ancak gerçek bir geliştirme ortamının tüm özelliklerini hiçbir zaman sunamadı. Eklenti özelliklerinin bazıları, bağımsız düzenleyicide desteklenemedikleri için yıllarca geliştirilmedi. Ayrıca tam teşekküllü bir IDE’nin yerini alması da mümkün değildi. Kaldırılması, eklentinin taviz vermeden tamamen dosya tabanlı geliştirmeye odaklanmasını sağlıyor.
Lisans anahtarı. Artık gerekmiyor. Blockstudio ücretsiz ve açık kaynak.
Blok kütüphanesi. Yerleşik “Blockstudio Elements” kütüphanesi (Galeri, Kaydırıcı, Görüntü Karşılaştırma, Kod, Simge) kaldırıldı. Bunlar, eklentiyle birlikte gelen önceden oluşturulmuş örnek bloklardı. Bunları kullanıyorsanız blok klasörlerini v6 dizininden temanızın blockstudio dizinine kopyalayın.
Başlangıç
Blockstudio 7’yi yükleyin ve ilk bloğunuzu dakikalar içinde oluşturun. Adım adım anlatım için Başlangıç kılavuzuna göz atın, ya da v7 geçiş kılavuzuna göz atın; v6 kullanıyorsanız.
Kaynak kodunun tamamı GitHub üzerinde. Sorun bildirimleri, PR’lar ve geri bildirimler memnuniyetle karşılanır.