İçeriğe geç

Dennis · 27 Temmuz 2026

Blockstudio 7.6

Blockstudio 7.6, projeyi PHP üzerinden okunabilir ve görüntülenebilir hale getiriyor, ön yüz üretim varsayılanlarını da blockstudio.json içine taşıyor: envanter API, bağımsız görüntüleme, medya ve Tailwind için şablon yardımcıları, performans profilleri, tek bir önbellek dizini, erken sunumla statik önceden görüntüleme, daha sıkı analiz hazır ayarları ve kodlama aracıları için oluşturulan proje araçları.

Sürümün büyük bölümünü iki çağrı oluşturuyor. Canvas::inventory(), projenin kaydettiği tüm sayfaları, blokları, desenleri, Site Editor şablonlarını, şablon parçalarını ve paketlenmiş UI örneklerini döndürür. Render::document(), her biri için tamamlanmış HTML ve görüntülemede kullanılan varlıkların tam listesini döndürür.

7.6.2 güncellemesi: Dosya tabanlı sayfalar artık normal WordPress istekleri sırasında uzlaştırılmıyor. Kaynak değişikliklerini uygulamak için wp bs pages sync komutunu çalıştırın veya Blockstudio\Pages::reconcile() çağrısını yapın. Koleksiyon yönlendirmesi ve templateFor varsayılanları, kalıcı çalışma zamanı yapılandırmasını kullanıyor; açık uzlaştırma ise önceki büyük çok dilli OR-meta sorgusunu önlüyor. Sayfa eşitlemesi artık istek kancalarından çalışmadığı için kısa ömürlü themeDefaults.syncPagesInDevelopment seçeneği kaldırıldı. Pages::init() artık yalnızca başlatma içindir; force ileten entegrasyonlar Pages::reconcile() veya CLI kullanmalıdır. Canvas’ı açmak, yazarlık envanteri için hâlâ bir kez açık ve kimliği doğrulanmış uzlaştırma yapar.

7.6.12 güncellemesi: Editör stil sayfaları artık her varlık için ayrı bir SASS derlemesi yerine tek bir yeniden yazma geçişiyle önekleniyor; bu sayede çok sayıda bloğu olan bir sitede soğuk editör derlemesi artık mütevazı bir bellek sınırını aşma riski taşımıyor. İçerik karmalı Tailwind stil sayfası önbellekten çıkarılmış önceden oluşturulmuş bir sayfa, hem PHP önbelleği hem de Early Serve drop-in’i üzerinden stilsiz sunulmak yerine yeniden oluşturuluyor. Üst düzeyde yazılan blok öznitelikleri artık atılmak yerine oluşturma sırasında okunuyor; böylece WP_Block_Type üzerindeki şema Blockstudio programatik yazıcılar tarafından dikkate alınıyor.

7.6.11 güncellemesi: Grafik yapıtı kurulumu artık depo kopyası aynı anahtar altında değiştiğinde bir rotanın belgesini atomik olarak değiştiriyor, aynı belgeleri olduğu gibi bırakıyor ve yükseltilen, değiştirilen, atlanan ve korunan rotaları Static_Prerender_Early_Serve::last_promotion() üzerinden bildiriyor.

7.6.10 güncellemesi: Çalışma zamanı önbellek isabetleri artık izleme gecikmesi sırasında bile kaldırılmış derlenmiş varlıkları algılıyor; 7.6 öncesi düz çalışma zamanı önbellekleri ise atomik olarak karantinaya alınıp sınırlı cron grupları halinde siliniyor. Paketlenmiş UI global’leri her sayfada bir kez çıktılanıyor. Grafik modundaki Early Serve, dağıtılan rota haritasının dışındaki canlı oluşturulmuş rotaları kimlik önbelleğinden sunabiliyor. Tailwind, içerik karmalı önbellek dosyasını isteğe bağlı olarak tailwind.output: "link" ile çıktılabilir; varsayılan olarak satır içi çıktı kullanılır.

Kısaca:

  • Proje envanteri: Canvas::inventory(), tüm kayıtlı kayıtları kaynakları ve sabit bir görüntüleme sırasıyla döndürür.
  • Hedefli seçim: Blok ve sayfa adlarını belirtmek; keşif, eşitleme, oluşturma ve derlemeyi bu kayıtlarla sınırlar.
  • Bağımsız oluşturma: Blockstudio\Render, bir blok, bileşim veya eksiksiz belge için tamamlanmış HTML döndürür.
  • UI bileşen aileleri: Blockstudio\Ui, paketlenmiş kütüphaneyi bileşen başına bir genel ailede ve her biri için bir örnekle gruplandırır.
  • Sabit görüntü boyutları: bs_media_image(), tema varlıklarını oluşturulmuş bir assets/media.json dosyasındaki gerçek boyutlarla işler.
  • Tailwind sınıf yardımcıları: bs_tw_merge() ve bs_tw_variants(), çakışma duyarlı birleştirmeyle PHP içinde sınıfları bir araya getirir.
  • Performans profilleri: performance.profile, üretim ön yüzü varsayılanlarını tek seferde etkinleştirir; alt değerler bunları geçersiz kılar.
  • Türlenmiş ayarlara erişim: Settings::get_bool() ve benzerleri, blockstudio.json dosyasını gerçek türlerle okur ve ayrıştırma hatalarını gösterir.
  • Tek önbellek dizini: Oluşturulan her dosya, çalışma zamanı kimliğine göre anahtarlanan cache.path dizininin altında bulunur.
  • Statik önceden oluşturma: Anonim HTML önbelleğe alınabilir, bağımlılık grafiği üzerinden geçersiz kılınabilir ve WordPress başlatılmadan önce sunulabilir.
  • Analiz hazır ayarları: theme, extreme-theme ve wordpress-render, blockstudio/phpstan kapsamını blok şablonlarının ötesine taşır.
  • Yönetilen commit kancası: blockstudio-githooks sync, yapılandırılmış hazır ayarı çalıştıran bir pre-commit kancası yazar ve yönetir.
  • Proje sözleşmesi: blockstudio-agents; bir projenin neler ürettiğini, hangi özellikleri etkinleştirdiğini ve hazır ayarının neleri zorunlu kıldığını açıklayan bir AGENTS.md dosyası yazar.
  • Dokümantasyon dizini: Yapay zekâ bağlam dosyası artık her belgenin, amacının ve sahip olduğu tanımlayıcıların dizinidir.
  • Kanonik blok etiketleri: Bağımsız bir komut, önek ve takma ad kısaltmalarını <bs:namespace-slug> biçimine dönüştürür; deneme çalıştırması da yapabilir.
  • Varsayılan olarak uyumluluk: Yukarıdakilerin hiçbiri, blockstudio.json içinde adı belirtilene kadar bir siteyi değiştirmez.

Projeyi okuma ve oluşturma

Proje envanteri

Canvas::inventory(), proje tarafından kaydedilen her şeyi oluşturma yapmadan tek bir yalın dizi olarak döndürür.

PHP
use Blockstudio\Canvas;

$result = Canvas::inventory();

foreach ($result['inventory']['blocks'] as $block) {
    echo $block['name'] . "\n";
}

Kayıtlar türe göre gruplandırılır: pages, blocks, patterns, templates, parts ve ui. order, tüm türlerdeki sabit görüntüleme sırasıdır; sources her kaydı kaynak yollarına eşler; warnings ve errors ise sorunları yapılandırılmış girdiler halinde toplar.

Blok kayıtları id, name, title, source, path, provenance ve oluşturulmaya hazır bir declaration taşır. Sayfa kayıtları, sabit kimlik olarak source değerini ve sayfayı oluşturan şablon olarak path değerini korur.

Hedefli seçim

Kayıtları adlandırmak, sonradan filtrelemek yerine yapılacak işi en baştan sınırlar.

PHP
$changed = Canvas::inventory([
    'blocks' => ['mytheme/hero'],
    'pages' => ['about'],
]);

Bu, bir blok ve bir sayfa döndürür. patterns, templates, parts ve ui boş döner; bu kayıtların kaynakları okunmaz, eşitlenmez, oluşturulmaz veya derlenmez.

Kurallar nettir:

  • Hiç tür anahtarı belirtilmezse her tür yüklenir.
  • true, null veya "*" belirtilirse o türdeki her kayıt yüklenir.
  • Bir dize veya liste; kimlik, ad, kısa ad, yol ya da kaynak yolu ile tam eşleşir.
  • Boş bir dize, boş bir liste veya false, o türden hiçbir kayıt yüklemez.
  • Herhangi bir tür anahtarı belirtilirse belirtilmeyen türlere dokunulmaz.

Artık var olmayan tanımlayıcılar hata vermek yerine deleted altında döner; Canvas REST yenileme uç noktası da blocks ve pages parametrelerine aynı kuralı uygular.

Canvas::documents() aynı seçimi alır ve her kayıt için oluşturulmuş bir belge ekler. Seçilen sayfalar geri yüklenmiş bir ön yüz bağlamında oluşturulur; böylece sorgu koşulları, body sınıfları, kısa kodlar, düzenler, yönlendirmeler ve enqueue geri çağrıları, isteği yapan isteği değil o sayfayı görür.

Bağımsız oluşturma

Blockstudio\Render, ön yüzün kullandığı işlem hattı üzerinden oluşturulmuş HTML değerini bir dize olarak döndürür.

PHP
use Blockstudio\Render;

$html = Render::composition([
    'root' => 'mytheme/card',
    'data' => ['heading' => 'Example card'],
    'layers' => [
        ['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
    ],
]);

Bunun altında dört anahtarlı tek bir bildirim biçimi bulunur: name, attributes, content ve children. root, data, inner, innerBlocks, layers ve example, Render::normalize() tarafından bu biçime dönüştürülen girdi kolaylıklarıdır. Alt öğeler özyinelemeli olarak oluşturulur; hatalı girdilerde, sorunlu bloğun adını belirten bir istisna oluşur.

Render::document(), çıktıyı eksiksiz ve bağımsız bir HTML belgesine sarar.

PHP
$document = Render::document('mytheme/hero', [
    'title' => 'Hero preview',
]);

echo $document['html'];

body yalnızca blok çıktısıdır; html birleştirilmiş belgedir; blocks katkıda bulunan blok adlarıdır; assets ise işaretlemeyi head, footer, styles, scripts, modules, interactivity, ui ve tailwind olarak parçalara ayırır. Varlıklar yalnızca oluşturulan öğelerle sınırlıdır; bu nedenle yalnızca editörde kullanılan varlıklar çıktıda yer almaz.

Render::document_from_html(), başka yerde oluşturulmuş HTML öğesini sarar; Render::content() ise serileştirilmiş blok içeriğini belge olmadan oluşturur. Tek bir PHP işlemi içinde belgeler arasında Blockstudio\Batch_Render::reset() çağrısını yapın; Canvas::documents() bunu zaten yapar.

UI bileşen aileleri

Blockstudio\Ui, paketlenmiş UI kütüphanesini iç parçaların listesi yerine her genel bileşen için bir girdiyle sunar.

Ui::inventory(), kök bloğu, başlığı ve gereken uygulama bloklarıyla birlikte her aile için bir girdi döndürür. Ui::examples(), her aile için belirlenimci bir bildirim ekler: varsayılanlar korunur, gerekli alt katmanlar üst öğelerinin altına yerleştirilir ve boş kalacak alanlara sabit örnek metin eklenir. Bu bildirim kanoniktir ve doğrudan Render::document() içine konabilir.

Canvas da aynı şekilde gruplandırır. Paketlenmiş UI, ui türünde her aile için bir örnek olarak görünür; uygulama kayıtları blocks dışında kalır.

Aileler bir araya getirilmek üzere tasarlanmıştır: bir seçici, liste kutusu tetikleyicinin üstüne yerleşecek şekilde bir iletişim kutusunun içinde açılır; menüler ve birleşik kutular, kaydırmada da değişmeyen sabit görüntü alanı koordinatlarına tutunur; kalıcı pencereler üst üste açılır ve her Escape tuşu basışında birer birer kapanır; her alt bilgi, aynı kapatma denetimini bir varyantla birleştirir. Bu bağlantı noktalarının nasıl çalıştığı ve çalışır kalmalarını sağlayan değişmezler bileşim bölümünde açıklanır; /ui/examples bileşimleri çalışır halde gösterir.

Şablon yardımcıları

Sabit görüntü boyutları

bs_media_image(), tema varlıklarını gerçek genişlik ve yükseklikleriyle, ayrıca ayrılmış bir en-boy oranıyla işler; böylece ortam kitaplığının dışındaki görseller artık sayfa düzenini kaydırmaz.

PHP
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
]);

Çıktı, img taşıyan bir figure.blockstudio-media ve bunun çevresindeki satır içi aspect-ratio öğesidir; bu öğede gerçek width, height, loading ve decoding bulunur. Boyutlar, derleme adımında Blockstudio\Media_Metadata_Builder tarafından veya elle yazılan, oluşturulmuş bir assets/media.json dosyasından alınır.

src, temaya göreli bir yol, mutlak bir yol veya tam bir URL alır; ortam kitaplığı görselleri için attachmentId kullanılır. eager, sayfanın üst kısmında geç yüklemeyi devre dışı bırakır; sources ise bir <picture> çıktılar.

performance.media.lazy etkin olduğunda gerçek URL, doğru boyutlandırılmış bir yer tutucunun arkasındaki data-src konumuna taşınır.

Tailwind sınıf yardımcıları

bs_tw_merge() ve bs_tw_variants(), PHP şablonlarında Tailwind sınıflarını birleştirir; bunun için Blockstudio tarafından zaten paketlenmiş motoru kullanır.

bs_tw_merge('px-2 text-sm', 'px-4'), text-sm px-4 değerini döndürür: çakışan px-2 kaldırılır ve sonraki değer kazanır. İç içe geçmiş sınıf değerleri dizileri kabul edilir.

bs_tw_variants(), bileşen varyantları için çağrılabilir küçük bir işlev döndürür:

PHP
$button = bs_tw_variants([
    'base' => 'inline-flex items-center',
    'variants' => [
        'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
    ],
    'defaultVariants' => ['size' => 'sm'],
]);

echo $button(['size' => 'lg', 'class' => 'rounded']);

Bu, inline-flex items-center h-12 px-6 rounded çıktısını verir. Temel sınıflar, varyantlar, varsayılan varyantlar, birleşik varyantlar ve her çağrıya özel bir class veya className desteklenir.

Üretim yapılandırması

Performans profilleri

performance.profile, üretim ön yüzü varsayılanlarını tek bir yerden etkinleştirir.

JSON
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

Varsayılan değer olan compat hiçbir şeyi değiştirmez. speed ve strict aynı kümeyi etkinleştirir: head bölümünden generator, emoji, feed, discovery ve bitişik gönderi çıktıları kaldırılır; oEmbed discovery ve host betikleri çıkarılır; XML-RPC, pingback’ler ve uzak editör keşfi devre dışı bırakılır; genel core ön yüz varlıkları kaldırılır; görsel çıktısı varsayılanları uygulanır; Heartbeat editörlerin dışında yavaşlatılır; aynı kaynaktan belgeler üzerine gelme veya odaklanma niyetiyle önceden getirilir ve Blockstudio görsel yükleyicisi kullanılır.

Her alt değer, yukarıdaki preload.links gibi profili geçersiz kılar. Core ön yüz varlıklarını kaldırmayı önce test edin; çünkü bunlara bağlı bir sayfa görünür biçimde bozulur. Runtime_Settings::current() çözümlenen profili gösterir.

themeDefaults, temaların aksi halde elle oluşturacağı iki şeyi kapsar: titleTag ve etkin alt temayı ve üst temayı güncelleme sonuçlarından gizlemek için suppressDirectoryUpdates.

Türlenmiş ayarlara erişim

Blockstudio\Settings, JSON içinde ne varsa onu döndürmek yerine yapılandırmayı gerçek türlerle okur.

PHP
use Blockstudio\Settings;

$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');

foreach (Settings::errors() as $error) {
    error_log($error);
}

Bozuk JSON, varsayılanlara çözümlenmek yerine Settings::errors() üzerinden bildirilir. Settings::get_raw() yalnızca etkin kaynağın bildirdiği değerleri döndürür; bu sayede false olarak ayarlanmış bir değerle hiç ayarlanmamış bir değer birbirinden ayrılır.

Settings::fingerprint(), etkin ayarlar için sabit bir kimlik döndürür; blockstudio.json değiştiğinde erişim ayarları yeniden yükler.

Tek önbellek dizini

Oluşturulan tüm dosyalar artık varsayılanı wp-content/blockstudio/cache olan cache.path dizininin altında bulunur.

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

Derleme yükleri, blok kayıt verileri, editör varlıkları, derlenmiş Tailwind CSS, oluşturma belgeleri, ada parçaları, statik HTML, grafik dizinleri, ısıtma kuyrukları ve tanılama verilerinin tümü bu kök dizinin altında bulunur. Göreli bir yol WP_CONTENT_DIR konumundan çözümlenir; mutlak bir yol ise verileri özel bir birime yönlendirir.

Nesneler önce geçerli ağ ve site altında, ardından çalışma zamanı kimliğine göre kaydedilir: bu kimlik; Blockstudio, WordPress ve PHP sürümlerinin parmak izini, etkin ayarları, etkin temayı ve eklentileri, keşif kaynaklarını ve ilgili kaynak dosyalarını içerir. Bir girdi değiştiğinde etkilenen nesneler yenileriyle değiştirilir; eskiler temizlenir.

Soğuk derlemeler tek uçuşludur: bir istek derlemeyi yapıp sonucu atomik olarak yayımlar, diğerleri ise bekler. Yenileme başarısız olursa hata görünür kalırken son sağlam nesne sunulmaya devam eder; Blockstudio\Runtime_Cache::purge('tailwind') ise tek bir kapsamı temizler.

Statik önceden oluşturma

Statik önceden oluşturma, anonim HTML belgelerinin tamamını önbelleğe alır ve bunları WordPress başlatılmadan önce sunabilir. Varsayılan olarak kapalıdır.

JSON
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

Uygunluk

Yalnızca anonim HTML belgelerinin tamamı uygundur. GET dışındaki istekler, sorgu dizeleri, yönetim sayfaları, REST, Ajax, cron, feed’ler, arama, önizlemeler, nonce içeren istekler, kişiselleştirilmiş çerezler ve dynamicPaths altındaki tüm yollar kapsam dışı bırakılır. Bir yanıt, <!-- blockstudio:no-cache --> işaretleyicisiyle özelliği tamamen devre dışı bırakabilir.

Yol eşleştirme sınırları dikkate alır; bu nedenle /account, /account/orders yolunu kapsar ancak /accounting yolunu kapsamaz.

İmza ve grafik modları

invalidate, girdilerin nasıl sona ereceğini belirler. Varsayılan signature modu, anonim bir önbellek kaçırmasında kimliğe göre anahtarlanan bir yanıtı doldurur ve site düzeyindeki değişikliklerden sonra kimliği yeniler; sıradan bir site için uygundur.

graph modu, açık derleme ve dağıtım araçları içindir. Her sayfanın kendi kaynak bağımlılıklarını kaydeder; böylece bir plan yalnızca etkilenen URL’leri yeniden oluşturur.

PHP
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
    $result = render_with_dependencies($url);

    Static_Prerender_Runtime::persist_built_response(
        $url,
        $result['html'],
        $result['files'],
        $result['virtualHashes']
    );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));

Erken sunum

earlyServe etkin olduğunda Blockstudio, site başına küçük bir rota haritasını ve uygun bir önbellek isabetini WordPress, eklentiler veya tema başlatılmadan önce akış olarak sunan bir advanced-cache.php drop-in’ini yönetir.

Hiçbir zaman başka bir tarafa ait haritanın, drop-in’in veya WP_CACHE bildiriminin üzerine yazmaz. Bir grafik yapıtı, harita değiştirilmeden önce başvurulan her HTML dosyasını doğrular; böylece yarım kalmış bir dağıtımda önceki grafik etkin kalır. Multisite girdileri ana makineye, ana yola ve site kimliğine göre birbirinden ayrı tutulur.

Isıtma ve durum

Günlük kullanımı üç WP-CLI komutu kapsar:

Kabuk
wp bs prerender warm
wp bs prerender status
wp bs prerender purge

status; etkin kimliği, dosya ve bayt sayılarını, grafik kayıtlarını, kuyruk durumunu ve kapsam başına isabet, kaçırma, derleme ve hata sayaçlarını bildirir.

Analiz ve aracı araçları

Analiz hazır ayarları

blockstudio/phpstan, blok analizinin üzerine üç katman ve projenin seçtiği katmanı çalıştıran bir komut ekler.

Hazır ayar Ekledikleri
base Mevcut şema, şablon, kanca, ayar ve API analizi.
theme Tema kökleri, stil başlıkları, varlıklar, seçici kapsamı, alan varsayılanları ve yineleyici sınırları.
extreme-theme PHPStan max, güvenli olmayan PHP, kaçışlama, Tailwind, JavaScript ve Interactivity denetimleri.
wordpress-render extreme-theme üzerine çağıranın sağladığı canlı oluşturma yoklaması.

Varsayılanlar blockstudio.json kaynağından gelir; böylece etkileşimli çalıştırmalar, CI ve commit kancaları aynı yapılandırmayı paylaşır:

JSON
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
Kabuk
vendor/bin/blockstudio-phpstan --root . -- --no-progress

Çıkış kodları başarılı durumda 0, tanılamalar için 1 ve geçersiz kullanım için 2 değeridir. Sarmalayıcı, yapılandırmasını sistemin geçici dizininde oluşturduğundan projeye oluşturulmuş bir yapılandırma, temel çizgi veya önbellek bırakmaz; ayrıca PHPStan bellek sınırını 1G değerine yükseltir.

Ayrıca bir BC Math sağlayıcısını da paketler; böylece JavaScript denetimleri artık ext-bcmath gerektirmez.

Yönetilen commit kancası

Tek bir ayar ve tek bir komut, yapılandırılmış hazır ayarı commit koşuluna dönüştürür.

JSON
{
  "githooks": {
    "commit": true
  }
}
Kabuk
vendor/bin/blockstudio-githooks sync

Eşitleme, kancayı ve sahiplik kaydını Git ortak dizinine yazar, core.hooksPath yolunu yönetilen dizine yönlendirir ve önceden yapılandırılmış pre-commit kancasını zincire ekler. Kanca, commit sırasında depo ve proje kökünü çözümler; böylece bağlantılı çalışma kopyaları ve boşluk içeren yollar sorunsuz çalışır.

Kanca yalnızca vendor/bin/blockstudio-phpstan komutunu çalıştırır; dosyaları hiçbir zaman biçimlendirmez veya yeniden yazmaz. commit değerini false olarak ayarlayıp yeniden eşitlemek veya blockstudio-githooks remove komutunu çalıştırmak, kayıtlı kanca yolunu geri yükler ve yalnızca Blockstudio tarafından yönetilen dosyaları siler.

Proje sözleşmesi

blockstudio-agents; blokların nerede bulunduğunu, bu projede sayfanın ne olduğunu, hangi özelliklerin etkinleştirildiğini ve analiz aracının neleri reddedeceğini belirten bir AGENTS.md yazar.

Kabuk
vendor/bin/blockstudio-agents

Belge şablondan değil, proje yapısından türetilir. style.css başlığı, blokları ve dosya tabanlı sayfaları olan bir tema; yalnızca blok kaydeden bir eklentiden farklı bir sözleşme alır. Sözleşme, tarayıcının bulduğu sayıları, dizinleri, ad alanlarını ve şablon dillerini içerir. Hangi özelliklerin görüneceğini blockstudio.json belirler; dolayısıyla statik önceden oluşturma kullanmayan bir projede bundan hiç söz edilmez.

Doğruluk bölümü, seçilen hazır ayarın kendi kural dosyalarından katman katman okunur; bu nedenle yeni bir kural eklenen hazır ayar, oluşturulan her sözleşmeyi değiştirir.

Sahiplik, commit kancasındaki gibi işler. Oluşturulmuş işaretleyicisi olmayan bir dosya, --force aksini belirtmedikçe değiştirilmek yerine reddedilir; sondaki notlar bölgesi yeniden oluşturma sırasında korunur; sözleşme güncel değilse --check, 1 koduyla çıkar; --stdout ise dosya sistemine dokunmadan sözleşmeyi yazdırır.

Dokümantasyon dizini

blockstudio-llm.txt artık birleştirilmiş bir metin değil, bir dizindir. Yayımlanan her belge; bölüm ve alt bölümünde, rotası, kaynak dosyası, tek satırlık amacı ve sahip olduğu tanımlayıcılarla birlikte bir kez yer alır: ayar yolları, kanca adları, PHP işlevleri ve sınıfları ile komutlar.

Text
## Docs / Dev / Inspection Tools

### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()

Bir aracı, dizini okur, ilgilendiği tanımlayıcıya sahip tek belgeyi bulur ve o belgeyi açar. Önceki yarım megabaytlık birleştirilmiş dosya hâlâ /blockstudio-llm-full.txt adresinde oluşturulup yayımlanıyor; artık kullanıcılara verilen ilk şey değil.

Kanonik blok etiketleri

Tek başına çalışan bir komut, önek ve takma ad kısaltmalarını kanonik <bs:namespace-slug> yazımına dönüştürür; bu yazım gerçek blok adını kaydeder ve proje filtresi yüklenmeden de çözümlenir.

brand öneki theme-components üzerinde ve ui öneki bsui üzerinde olduğunda, bu kısaltma:

HTML
<brand-card>
  <ui-input />
</brand-card>

şununla aynı anlama gelir:

HTML
<bs:theme-components-card>
  <bs:bsui-input />
</bs:theme-components-card>

Önekler ve tam takma adlar hâlâ çalışır ve kullanımdan kaldırılmamıştır. Komut WordPress yüklemez ve --apply olmadan hiçbir şey yazmaz:

Kabuk
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
  --root="$PWD" \
  --prefix-map=/tmp/prefixes.json \
  --known-blocks=/tmp/blocks.json \
  --report=/tmp/tag-migration.json \
  --dry-run

--prefix-map her öneki ad alanlarıyla eşleştirir ve --known-blocks kayıtlı blok adlarını listeler. Rapor; eski adlardan kanonik adlara eşlemeleri, kullanım sayılarını, dosya başına özetleri ve bilinmeyen etiketler, belirsiz takma adlar ile dinamik etiketler için ayrı listeleri kaydeder. Bunlardan herhangi biri kaldığında --apply yazmayı reddeder; bunu aşmak için --allow-unresolved seçeneği gerekir.

PHP dizelerindeki gerçek etiketler de dâhil olmak üzere eşleştirilmiş, iç içe ve kendi kendini kapatan işaretlemeler işlenir. Yalnızca etiket adları değiştirilir; ikinci çalıştırma değişiklik yapmaz. Yorumlardaki, kod bloklarındaki, <pre> veya <code> içindeki örnekler yalnızca raporlanır.

Varsayılan davranış

7.6’yı yüklemek tek başına hiçbir şeyi değiştirmez.

Performans profili varsayılan olarak compat olur. Head çıktısı, oEmbed, XML-RPC, Heartbeat, görsel varsayılanları, bağlantı ön yüklemesi, tembel yükleme ve ön uç <title>, WordPress ile temanın belirlediği şekilde kalır.

Etkinleştirilmedikçe bunlar kapalı kalır: her performance.staticPrerender, performance.measurement, performance.media ve themeDefaults anahtarı ile githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled ve blockTags.enabled. Devre dışıyken statik ön oluşturma hiçbir dosya yazmaz ve ek bir bileşen yüklemez.

Canvas ve Render pasiftir. Mevcut kayıtları okur ve yalnızca çağıranın istediği içeriği işler; hiçbiri ön uç çıktısına kanca eklemez veya rota kaydetmez. Canvas yönetici ekranı için hâlâ dev.canvas.enabled ve edit_posts gerekir.

Daha sıkı analiz için açıkça adlandırma gerekir. blockstudio/phpstan yüklemek yalnızca temel uzantıyı etkinleştirir ve proje bir ön ayar belirtmediği sürece kanonik komut base çalıştırır.

Oluşturulan dosyalar için ilgili komutun çalıştırılması gerekir. githooks.commit, blockstudio-githooks sync çalışana kadar hiçbir şey yapmaz; AGENTS.md de blockstudio-agents çalışana kadar işlem yapmaz.

7.5’ten yükseltme

Gereksinimler değişmedi: PHP 8.2 veya üzeri, WordPress 6.7 veya üzeri.

Kabuk
composer require blockstudio/blockstudio

Önbellekler bir kez yeniden oluşturulur. Çalışma zamanı kimliği Blockstudio sürümünü içerir; bu nedenle yükseltmeden sonraki ilk istek soğuk başlar ve eski nesneler temizlenir. wp-content/uploads/blockstudio/tailwind/cache altındaki eski Tailwind önbelleği silinebilir; bunu glob ile arayan bir kod parçacığı bunun yerine Blockstudio\Runtime_Cache::purge('tailwind') çağırmalıdır.

7.6 öncesindeki düz wp-content/blockstudio/cache/runtime dizini etkin yolun dışına otomatik olarak taşınır ve sınırlı WP-Cron geçişleriyle kaldırılır. Bu nedenle büyük eski kilit dosyası ağaçlarının dağıtım isteği sırasında silinmesi gerekmez.

Oluşturulan dosyaların sahipleri bellidir. assets/media.json sürüm kontrolünde veya derleme adımında yer almalıdır. Rota eşlemesi, advanced-cache.php ek bileşeni ve WP_CACHE bildirimi yalnızca earlyServe etkin olduğunda, commit öncesi kanca ise yalnızca eşitlenmişken bulunur. Oluşturulan diğer her şey cache.path altında yer alır ve güvenle silinebilir.

Hiçbir şey kaldırılmadı veya yeniden adlandırılmadı. bs_render_block(), bs_block(), Blockstudio\Pages ve Blockstudio\Patterns kanonik, dosya tabanlı içerik yüzeyleri olmaya devam eder.

Geri alma özellik bazında yapılır. performance.profile yeniden compat sürümüne, staticPrerender.enabled yeniden false sürümüne, githooks.commit yeniden false sürümüne ve bir sync ile cache.enabled yeniden false sürümüne alınarak her biri bir katman geri alınır.

Uygulamaya başlamak için makul bir sıra:

  1. performance.profile değerini speed olarak ayarlayın; ardından head çıktısını, akışları ve oEmbed veya XML-RPC kullanan eklentileri kontrol edin.
  2. assets/media.json oluşturun, şablonları bs_media_image() konumuna taşıyın, ardından performance.media.lazy özelliğini etkinleştirin.
  3. earlyServe kapalıyken performance.staticPrerender özelliğini etkinleştirin, istekleri wp bs prerender status ile doğrulayın, ardından earlyServe özelliğini açın.
  4. Herhangi bir ön ayarı githooks.commit arkasına almadan önce blockstudio-phpstan --preset theme temiz sonuç verene kadar çalıştırın.

Ayrıntılar nerede bulunur