Dennis · 10 Nisan 2026
Blockstudio 7.2
Blockstudio 7.2, çerçeveyi aynı anda iki yönde genişletiyor.
İlki, tek bir projedeki görünürlük ve iş akışı: yeni bir yönetici genel bakışı, veritabanı tarayıcısı, yönetici kayıt defteri tarayıcısı ve paylaşılan Sass kurulumu için SCSS ön yapılandırmaları.
İkincisi, Blockstudio çevresindeki ekosistem: blokları dağıtmak için bir kayıt defteri CLI (WordPress için shadcn gibi) ve şablonlara, blok etiketlerine, db.php, rpc.php, cron.php ve ilgili şema dosyalarına TypeScript tarzı tür güvenliği getiren bir PHPStan uzantısı.
Her iki yönün de amacı aynı: büyük Blockstudio projelerini anlamayı, geliştirmeyi ve paylaşmayı kolaylaştırmak.
Yönetici deneyimi
İki ekleme, büyük bir projede wp-admin içinde gezinmeyi kolaylaştırıyor.
Yönetici genel bakışı
Blockstudio artık Araçlar > Blockstudio altında bir yönetici ekranıyla geliyor. Sistemin dosya sisteminden neleri kaydettiğini tek bir yerden incelemenizi sağlar.
Genel bakışta şu öğeler için özel sekmeler bulunur:
- Bloklar
- Uzantılar
- Alanlar
- Sayfalar
- Şemalar
Genel bakışın yanı sıra yönetici alanına özel bir Veritabanları bölümü de eklendi. Bu bölüm, kaydedilmiş her Blockstudio\Db şemasını listeler ve gerçek kayıtları doğrudan wp-admin içinde incelemenizi sağlar.
Özel panellerden oluşan bir ızgara oluşturmak yerine, ekranda yerel WordPress DataViews tabloları kullanılır. Böylece UI wp-admin ile uyumlu kalır ve bir projede onlarca ya da yüzlerce kayıt olduğunda da kullanışlı olur.
Küçük bir kurulumda çalışma zamanı durumunu aklınızda tutabilirsiniz. Kod tabanı büyüdükçe bu işe yaramaz. Şu tür sorular sormaya başlarsınız:
- Şu anda gerçekten hangi bloklar kayıtlı?
- Hangi uzantılar
core/*öğesini, hangileri tek tek blokları hedefliyor? - Hangi sayfalar eşitlenmiş ve hangi yazı türlerine aitler?
- Bu projede hangi yeniden kullanılabilir alanlar var?
- Hangi şemalar kayıtlı ve hangi depolama arka ucunu kullanıyorlar?
Şimdiye dek yanıtı bulmak için klasörleri okumak, JSON dosyalarını açmak ve PHP adımlarını izlemek gerekiyordu. Genel bakış, bunları gerçek bir yönetici ekranına dönüştürüyor.
Her sekme farklı soruları yanıtlayacak şekilde tasarlanmıştır:
- Bloklar: Kayıtlı blok türlerini, işleme modunu, API sürümünü ve öznitelik sayısını gösterir
- Uzantılar: Hedefledikleri blokları, öncelik ve işleme ayrıntılarıyla birlikte gösterir
- Alanlar: Yeniden kullanılabilir özel alan tanımlarının hızlı bir envanterini sunar
- Sayfalar: Yazı türü, durum, şablon motoru ve eşitleme durumuyla eşitlenmiş dosya tabanlı sayfaları gösterir
- Şemalar: Kayıtlı depolama şemalarını; arka uç, alan sayısı ve yetenek kapsamıyla birlikte gösterir
Veritabanı tarayıcısı, ilk genel bakış yükünden bilerek ayrı tutulur. Sayfa yüklenirken her satırı serileştirmek yerine, başlangıçta yalnızca kullanılabilir şemaları yerelleştirir ve bir veritabanı sekmesini açtığınızda kayıtları isteğe bağlı olarak getirir. Böylece bir projenin arkasında db.php daha büyük veri kümeleri olsa bile yönetim alanı kullanışlı kalır.
Bu ilk sürüm, bilerek şemaya dayalı kayıtlarla sınırlandırılmıştır. Bu bir ayarlar sayfası değil. Bir inceleme sayfası.
Hiç istemiyorsanız tamamen devre dışı bırakın:
add_filter('blockstudio/admin/enabled', '__return_false');
Yönetim kayıt defteri tarayıcısı
Genel bakışın yanında ikinci bir sekme bulunur: Kayıt Defteri. Bu sekme, temanızın blocks.json içinde yapılandırılan uzak blok kayıt defterlerini görüntülemenizi sağlar ve blokları bir CLI dosyasına dokunmadan doğrudan WordPress yönetim panelinden içe aktarmanıza olanak tanır.
{
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json",
"private": {
"url": "https://api.example.com/registry.json",
"headers": {
"Authorization": "Bearer ${REGISTRY_TOKEN}"
}
}
}
}
Tarayıcı, yapılandırılmış her kayıt defterinden veri alır, kullanılabilir tüm blokları listeler ve bunların yerel olarak zaten kurulu mu yoksa içe aktarılabilir mi olduğunu gösterir. Her satırda, blok dosyalarını temanızın yapılandırılmış dizinine indiren bir İçe Aktar düğmesi bulunur. Zaten kurulu bloklarda bunun yerine Yeniden İçe Aktar düğmesi görünür.
Kimlik doğrulamalı kayıt defterleri, headers içeren nesne biçimiyle desteklenir; buna ${ENV_VAR} enterpolasyonu da dahildir, böylece belirteçler sürüm denetimine asla girmez.
Böylece kayıt defterlerini görüntülemek ve kullanmak, yalnızca bir CLI iş akışı olmaktan çıkar ve yönetim panelinin temel bir parçası hâline gelir.
Kayıt Defteri CLI
Kayıt defteri hikâyesinin diğer yarısı, bağımsız bir CLI: blockstudio/registry.
WordPress blokları için shadcn tarzı bir araçtır. npm paketi yok, derleme adımı yok. Bir komut çalıştırırsınız, blok kaynak kodu projenize kopyalanır ve tümüyle sizin olur.
npx blockstudio init
npx blockstudio add ui/tabs
CLI her tür blokla çalışır: Blockstudio blokları, @wordpress/create-block çıktısı, düz PHP blokları. Kayıt defteri, klasörün içinde ne olduğuyla ilgilenmez. Dosya bildirimini registry.json üzerinden okur ve tam olarak bu dosyaları kopyalar.
Blok yazarları, kullanılabilir bloklarını meta veriler, bağımlılıklar ve dosya listeleriyle açıklayan bir registry.json dosyasını herhangi bir URL üzerinde yayımlar (GitHub ham içerik, S3 veya özel bir sunucu). Kullanıcılar URL öğesini blocks.json dosyalarına ekler ve blokları adlarına göre alır.
CLI şunları destekler:
- Bağımlılık çözümleme: Bloklar başka bloklara bağımlılık tanımlayabilir; bunlar döngü algılamasıyla otomatik olarak çözümlenir.
- Çoklu kayıt defteri çakışma yönetimi: Aynı blok adı birden fazla kayıt defterinde varsa CLI seçim yapmanızı ister.
- Kimlik doğrulamalı kayıt defterleri: Ortam değişkeni enterpolasyonuyla taşıyıcı belirteçler, temel kimlik doğrulama ve özel başlıklar
- Etkileşimli TUI: Döndürücüler, seçim istemleri ve ilerleme göstergeleriyle Ink kullanılarak oluşturulmuştur.
- Etkileşimsiz kip:
--yesişareti ve otomatik CI/boru hattı geri dönüşü - Arama ve listeleme: Komut satırından kayıt defterlerine göz atın
Paket; şemaları, bağımlılık çözümlemeyi, HTTP getirmeyi, dosya yazmayı, tüm komut akışlarını ve etkileşimli Ink UI öğesini kapsayan 130 test içerir.
Tam dokümantasyon: Kayıt Defteriblockstudio.dev/registry.
PHPStan uzantısı
Diğer büyük yenilik blockstudio/phpstan: PHPStan geliştiricilerin beklediği tür güvenliğini Blockstudio kullanıcılarına sunan bir TypeScript uzantısı.
composer require --dev blockstudio/phpstan
Uzantı, analiz sırasında projenizin gerçek şemalarını okur ve elde edilen türleri PHPStan içine aktarır. Artık PHP şablonlarını, Twig, Blade, blok etiketlerini, türlendirilmiş veritabanı kayıtlarını, ayar yollarını, kanca adlarını ve şema doğrulamasını kapsar; bunların tümü block.json, field.json, uzantı JSON, page.json, db.php, rpc.php, cron.php ve blockstudio.json genelinde geçerlidir.
Tür güvenli blok şablonları
$a üzerindeki alan erişimleri, eşlik eden block.json şemasına göre doğrulanır:
<?php
/** @var array<string, mixed> $a */
echo $a['title']; // OK
echo $a['cta']['href']; // OK
echo $a['typo']; // ERROR: Field "typo" does not exist in block.json (block: hero). Did you mean "title"?
Tür güvenli veritabanı kayıtları
Db::get(), db.php şemanıza dayalı türlendirilmiş bir örnek döndürür. Kayıt yapısı gerçek alanlardan oluşturulur:
return [
'storage' => 'table',
'fields' => [
'email' => ['type' => 'string', 'required' => true],
'name' => ['type' => 'string'],
],
];
$db = Db::get('mytheme/subscribers');
$record = $db->create(['email' => 'a@b.com']);
echo $record['email']; // PHPStan: string
echo $record['name']; // PHPStan: string|null
echo $record['typo']; // ERROR: Offset 'typo' does not exist on array{id: int, email: string, name: string|null}
Şema doğrulama
Geçersiz şema dosyaları analiz sırasında yakalanır: block.json, field.json, uzantı JSON, page.json, db.php, rpc.php, cron.php ve blockstudio.json. Eksik adlar, yanlış alan türleri, hatalı tanımlar ve kullanımdan kaldırılmış kısa gösterimli boole değerleri (iç içe nesne yerine "tailwind": true) kaynak dosyadaki tam satır numarasıyla birlikte bildirilir.
Ayar yolu doğrulama
Settings::get() çağrıları bilinen ayar şemasına göre doğrulanır:
Settings::get('tailwind/enabled'); // OK, returns bool
Settings::get('tailwind/enabld'); // ERROR: Settings path "tailwind/enabld" is not a known Blockstudio setting. Did you mean "tailwind/enabled"?
Kanca adı doğrulama
Filtre ve eylem kancası adları için de aynı şey geçerlidir:
add_filter('blockstudio/render', $cb); // OK
add_filter('blockstudio/rendrr', $cb); // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?
Eklenti ayrıca Blockstudio genel API arayüzünün tamamı için Db, Settings, Field_Registry, Build ve genel yardımcı işlevler için tanım dosyaları da içerir. Geliştirme makinenizde eklenti kaynak koduna ihtiyaç duymadan tüm Blockstudio API’leri için otomatik tamamlama ve tür denetimi elde edersiniz.
Geliştirme kolaylıkları
Sürümdeki iki küçük geliştirme kolaylığı da yenilikleri tamamlıyor.
Genel SCSS ön ekleri
Blockstudio zaten SCSS derlemesini destekliyordu, ancak can sıkıcı bir sürtüşme noktası vardı: ortak Sass kurulumu.
Ortak bir değişken, işlev veya mixin kümesine erişmek istiyorsanız bunları her SCSS dosyasına eklemeniz gerekiyordu. Bu, özellikle daha büyük tasarım sistemlerinde veya Bootstrap gibi Sass araç takımlarında kısa sürede tekrara dönüşüyordu.
7.2 tam da bunun için bir ön ek kancası ekliyor:
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Mevcut blockstudio/assets/process/scss/import_paths filtresiyle birlikte, ortak bir Sass arayüzünü bir kez tanımlarsınız ve bu, derlenen her dosyada kullanılabilir olur.
Bir blok stil sayfası, ihtiyaç duyduğu gerçek stillere odaklanabilir:
.hero {
@include media-breakpoint-up(lg) {
padding: 4rem;
}
}
Her blok varlığına yinelenen içe aktarmalar eklemeye gerek yok. Bu, özel bir kipte “Bootstrap desteği” değildir. İster Bootstrap ister kendi kurum içi araç takımınızdan gelsin, proje genelinde paylaşılan Sass için genel amaçlı bir kancadır.
PHP yerel blok API tanımları
7.2, tam kapsamlı blok API’leri için isteğe bağlı, PHP yerel bir sözdizimi de ekliyor. Diziler varsayılan olmaya ve tam olarak desteklenmeye devam ediyor. Hiçbir şeyin yerini almadı. Ancak iç içe yapılandırma dizileri yerine adlandırılmış bağımsız değişkenleri, enum’ları ve nitelikleri tercih ediyorsanız artık bu tarzı seçebilirsiniz.
rpc.php için nitelik eklenmiş yöntemlere sahip bir nesne döndürün:
<?php
use Blockstudio\Attributes\Rpc;
use Blockstudio\Rpc\Access;
use Blockstudio\Rpc\Method;
return new class {
#[Rpc(access: Access::Session)]
public function subscribe(array $params): array {
return ['success' => true];
}
#[Rpc(name: 'status', methods: [Method::Get, Method::Post])]
public function getStatus(array $params): array {
return ['status' => 'ok'];
}
};
cron.php için aynı yaklaşım #[Cron] ile çalışır:
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;
return new class {
#[Cron(schedule: Schedule::Hourly)]
public function heartbeat(): void {
}
};
db.php için artık küçük bir oluşturucu katmanı var:
<?php
use Blockstudio\Db\Field;
use Blockstudio\Db\Schema;
use Blockstudio\Db\Storage;
return Schema::make(
storage: Storage::Table,
fields: [
'email' => Field::string(required: true, format: 'email'),
'active' => Field::boolean(default: false),
],
);
Bu, daha büyük kod tabanları için daha iyi bir denge sağlar. İstediğinizde dizi biçiminin basitliğini korur, bir blok birkaç alanı veya uç noktayı aştığında ise daha kolay keşfedilebilir bir PHP arayüzüne geçebilirsiniz.
Bu özellikler neden birlikte sunuluyor
Yönetim paneline genel bakış, kayıt defteri tarayıcısı, kayıt defteri CLI ve PHPStan uzantısı aynı soruya yanıt veriyor: Bir Blockstudio projesi büyüdükçe nasıl anlaşılır kalır?
Yönetim araçları bu soruyu proje düzeyinde yanıtlıyor: nelerin kaydedildiğini görme, kayıt defterlerinden blokları içe aktarma ve daha az tahmin yürütme olanağı.
CLI bu soruyu ekosistem düzeyinde yanıtlıyor: Blokları npm paketlerine eklemeden veya derleme sistemleriyle uğraşmadan projeler ve ekipler arasında paylaşmanın bir yolu.
PHPStan uzantısı bu soruyu kod düzeyinde yanıtlıyor: Yanlış alan erişimlerini, şema yazım hatalarını ve bozuk kanca geri çağrılarını çalışma zamanına ulaşmadan yakalayın.
Genel olarak 7.2’nin yönü bu: daha az tahmin, daha az tekrar, daha iyi görünürlük ve artık gerçek tür güvenliği.
Hata düzeltmeleri
- Sınıflar alanı: Kullanıcının yazdığı özel sınıf adları, doğrulayıcı yalnızca önceden tanımlanmış Tailwind/ayar listesindeki sınıfları kabul ettiği için odaktan çıkıldığında sessizce siliniyordu. Artık boş olmayan tüm dizeler kabul ediliyor.
- Nitelikler alanı: Bir nitelik çiftini kaldırmak, kaydedilen veride
nullgirdileri bırakıyordu. Dizi öğelerini null yapan lodashunset()yerine bunları kaldıransplice()kullanıldı. - CSS küçültücüsü: TailwindPHP küçültücüsü,
calc()veclamp()içindeki+çevresindeki boşlukları kaldırarakcalc(1rem+0.5vw)gibi geçersiz CSS çıktılar üretiyordu. Sorun, yalnızca parantez derinliği 0’da seçici birleştiricilerinin çevresindeki boşlukları kaldıran, derinliği izleyen bir karakter taramasıyla TailwindPHP v1.3.1 içinde yukarı akışta düzeltildi. - Blok Ekleyici önizlemesi: İşleme kipi karma anahtarına eklenmediği için Blok Ekleyici önizlemesinde
$isPreviewher zamanfalseoluyordu. Düzenleyici ve önizleme işlemeleri artık ayrı önbellek girdileri oluşturuyor. - InnerBlocks iç içe şablonu:
<InnerBlocks template="..."/>bileşeni,['core/group', {}, [['core/paragraph']]]gibi şablon demetlerinden 3. öğeyi (alt öğeleri) çıkarıyordu ve bunun sonucunda kapsayıcı bloklar boş kalıyordu. Artık iç içe alt öğeler korunuyor.