Dennis · 14 Ekim 2026
Blockstudio 7.7
Blockstudio 7.7, WordPress gönderisi olmayan belgeler için sanal rotalar ekler, hedefli ön oluşturma derlemelerini iyileştirir ve mevcut blokların düzenlenip işlenmesini daha güvenilir hâle getirir. Ayrıca PHPStan blok etiketi denetimlerini genişletir ve birlikte gelen UI bileşenlerinde erişilebilirliği iyileştirir.
Dosya öncelikli iş akışı aynı kalır. Bloklar şablonlarından işlenir; dosya tabanlı sayfalar açıkça başlatılan bir CLI veya API eşitlemesiyle değiştirilir. Bu sürüm, ziyaretçi veya yönetici isteklerinde otomatik sayfa eşitlemesi getirmez.
Kısaca:
- Sanal rotalar: gönderi oluşturmadan veya özel bir yönlendirme işleyicisi yazmadan bileşen galerisi, katalog ya da başka bir tam belge sunun.
- Hedefli ön oluşturma derlemeleri: HTTP derlemeleri her sayfanın kullandığı kaynak dosyaları kaydeder; böylece sonraki bir derleme yalnızca etkilenen rotaları işleyebilir.
- Önbellek saklama: önbelleğe alınmış sayfalar için kullanımdan kaldırılmış stil sayfalarını kullanılabilir durumda tutun ve erken sunum eşlemesi girdilerini inceleyin veya temizleyin.
- Düzenleyici güvenilirliği: birden çok seçili blok kendi değerlerini korur; RichText ile kenar çubuğu alanlarında geri alma ve yineleme çalışır; devralınan bağlam doğru blokta kalır.
- Dosya içeriği doğruluğu: iç içe listeler, bölümleme öğeleri, satır içi HTML, kısa kodlar ve kaçış karakterli öznitelikler ayrıştırma ve işleme sırasında korunur.
- PHPStan iyileştirmeleri: önek etiketleri, takma adlar, eşlenmiş sayfa öğeleri ve şablon değişkenleri projenin kendi tanımlarına göre denetlenir.
- Erişilebilir UI: denetimler durumlarını doğru biçimde gösterir, etiketler doğru girdiyi açıp kapatır ve liste ile tablo bileşenleri geçerli HTML yapısını kullanır.
- Çeviriler: yüklenmiş JavaScript çevirileri düzenleyicide ve yönetici genel bakışında yüklenir; daha önce çevrilmemiş alan denetimleri de buna dâhildir.
Sanal rotalar
Bazı sayfalar, düzenleyicinin yönettiği bir gönderi yerine verilerden oluşturulur. Örneğin bir bileşen referansının kendine ait bir URL ve belge başlığı gerekebilir, ancak wp_posts içinde bir kayıt gerekmez.
Bu belgeyi Blockstudio\Virtual_Routes ile kaydedin:
add_action('init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function () {
get_header();
echo bs_block([
'name' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
]);
get_footer();
},
['title' => 'Component gallery']
);
});
Rota /components/ sunar. Geri çağırımı Blockstudio çıktı tamponu içinde çalıştığından, işlenen bloklar normal işlem hattı üzerinden stillerini, betiklerini, birlikte gelen UI varlıklarını ve Tailwind çıktısını alır. WordPress, eşleşen rotayı bir 404 hâline getirmez veya bir gönderiye yönlendirmez.
Bir URL ailesi için prefix değerini true olarak ayarlayın ve bir match geri çağırımı sağlayın. Geri çağırım rotanın altındaki yolu alır ve işleyicinizin ihtiyaç duyduğu değeri döndürür. null veya false döndürülürse istek WordPress tarafından işlenir. Statik ön oluşturma derlemesinin hangi yolları içermesi gerektiğini listelemek için urls kullanın. Tek ve öneksiz bir rota varsayılan olarak kendi yolunu içerir.
Virtual_Routes::urls(), site haritası oluşturan entegrasyonlar için mutlak URL’ler döndürür. Sanal belgeleri WordPress gönderi site haritasına otomatik olarak eklemez.
Tam API ve seçenekler için Sanal Rotalar bölümüne bakın.
Daha isabetli ön oluşturma derlemeleri
HTTP üzerinden oluşturulan grafik kipindeki derlemeler artık her rotanın kullandığı dosyaları kaydeder: WordPress şablonu, işlenen blok şablonları ve varlıkları, dosya sayfası tanımları ve yerleşimleri ile blockstudio/render/dependencies aracılığıyla eklenen bağımlılıklar.
Sonraki derlemede build_plan() bu bağımlılıkları karşılaştırır. Bir blok şablonunu değiştirmek, tüm ilgisiz sayfaları yeniden derlemek yerine bu şablona bağlı rotaların işlenmesini sağlar. Paylaşılan yapılandırma değişiklikleri derlemenin tamamını etkilemeye devam eder; yeni veya süresi dolmuş rotalar da önceki gibi işlenir.
Yalnızca veritabanında yapılan değişiklikler dosya bağımlılığı sayılmaz. Bir seçeneği, gönderiyi veya başka bir veritabanı değerini almak için dağıtım sırasında derlemeyi zorlayın ya da etkilenen URL’leri açıkça işleyin.
Sürüm ayrıca ilk işleme sırasında derleme kimliklerinin değişmesi, güncelliğini yitirmiş opcode önbelleğindeki erken sunum eşlemeleri ve yolu search veya preview içerdiği için geçerli URL’lerin kapsam dışında kalması sorunlarını da düzeltir. Accept: text/markdown kullanan Markdown istekleri önbelleğe alınmış HTML öğesini atlar ve ilgili yanıtlar Vary: Accept gönderir.
Statik ön oluşturma, kancalarını ekleyip eklemeyeceğine karar verirken artık etkin tema tarafından kaydedilen filtrelere uyar. Tema bu özelliği devre dışı bırakabilir; önceki bir ayar araması özelliğin etkin kalmasına neden olmaz.
Bkz. Statik Ön Oluşturma.
Önbellek saklama ve bakım
Önbelleğe alınmış bir HTML sayfası, stil sayfasını derleyen çalışma zamanı kimliğinden daha uzun süre var olabilir. cache.namespaceGrace, temizlik işlemi kullanımdan kaldırılmayı ilk kez saptadıktan sonra kullanımdan kaldırılmış ad alanlarının ne kadar süre kullanılabilir kalacağını belirler:
{
"cache": {
"namespaceGrace": 777600
}
}
Bu örnek, kullanımdan kaldırılmış dosyaları dokuz gün boyunca saklar. Varsayılan süre bir gündür. Etkin ad alanları ve dağıtılmış ön oluşturma çıktıları sunan ad alanları, kullanımdan kaldırılanları temizleme işleminden korunur.
Erken sunum eşlemesinin inceleme ve temizleme komutları da bulunur:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
Silinmiş sitelere veya eksik dizinlere ait girdileri bildirir ve kaldırırlar. Çoklu site kurulumunda bir sitenin silinmesi, o sitenin girdilerini de kaldırır. Eksik rota belgeleri ayrı olarak bildirilir; geçerli bir site girdisinin tamamının kaldırılmasına neden olmaz.
Saklama yönergeleri için Önbelleğe alma, komutlar için eşleme bakımı bölümüne bakın.
Daha güvenilir bir düzenleyici
Birden çok seçili bloğu düzenlemek artık yalnızca o bloğu günceller. Kaydetme işlemi, öznitelikleri seçili bloklar arasında kopyalamak yerine her bloğun kendi içeriğini, anahtarlarını, meta verilerini ve kilitlerini korur.
RichText değerleri doğrudan blok özniteliklerinde tutulur; böylece Gutenberg bunları geri alma ve yineleme geçmişine ekleyebilir. Kenar çubuğu alanları da aynı geçmişe katılır. InnerBlocks templateLock="false" gerçek bir boolean olarak iletilir ve dıştaki bir alan kilitli olsa bile içeriğin kilidini açar.
İlk ön yüklemelere düzenlenen gönderinin kimliği ve türü iletilir; böylece şablonlar ilk işlemede doğru meta verileri okuyabilir. Farklı üst blokların altındaki aynı alt bloklar, ön yüklemelerde ve işleme önbelleklerinde ayrı devralınan bağlamlarını korur. İlk istek sırasında öznitelik veya bağlam değişiklikleri artık ön izlemenin geride kalmasına yol açmaz.
Blockstudio artık blok kökleri arasına gizli işleme işaretleyicisi öğeleri eklenmesini de önler. .card + .card gibi bitişik kardeş seçicileri, artık düzenleyicide ön uçtakiyle aynı öğe ilişkilerini görür; düzenleyici ve blok ekleyici ön izlemeleri ise ayrı kalır.
Site genelindeki seçeneklerin daha güvenli depolanması
Seçenek destekli alanlar hâlâ site genelinde geçerli değerler sağlar; ancak gönderi kaydedilirken bu alanların kaydedilmiş her kopyası artık olduğu gibi yazılmaz:
- Taslak, beklemede, özel ve zamanlanmış kayıtlar canlı site seçeneklerini yazmaz.
- Yayımlanmış kayıtlar, bu düzenlemede değişen ve gönderilen alanları yazar.
- Yalnızca başlığı değiştiren bir kayıt, eski bir kopyadaki daha yeni site genelindeki değeri geri almaz.
- Eksik alanlar ve kaldırılan bloklar mevcut seçenekleri silmez.
- Açık bir
nullseçeneği kaldırır. Boş dizeler,false, sıfır ve boş diziler geçerli değerler olarak kalır.
Yükseltirken kontrol edilmesi gereken temel davranış değişikliği budur. Bir entegrasyon canlı bir seçeneği güncellemek için özel veya taslak bir gönderi kullandıysa, bu seçeneği açıkça yazın ya da bunun yerine yayımlanmış bir yapılandırma gönderisi kullanın. Gönderi meta verisi depolaması yalnızca yayımlanmış gönderilere uygulanan kısıtlamadan etkilenmez.
Tam kayıt kuralları için Depolama bölümüne bakın.
Dosya içeriği olduğu gibi korunur
HTML-blok işlem hattı, yazdığınız yapının daha büyük bir bölümünü korur:
- İç içe listeler, üst öğelerinin iç liste bloklarına dönüşür. Liste ve öğe sınıfları korunur; sıradan düz listelerin önceki çıktısı değişmez.
main,header,footer,articleveaside, blok işleme sürecini atlayan ham HTML yerine, öğelerini koruyan grup bloklarına dönüşür.- Eşlenmiş richtext paragrafları satır içi işaretlemeyi korur, yalnızca görsel içeren paragraflar eşlenmiş görsel bloğuna çözülür ve kısa kod etiketleri içeriklerini korur.
- Kaçış karakterli öznitelikler çözülüp bir kez kaçırılır; buna
InnerBlocks,RichTextveuseBlockPropsöğesindeki öznitelikler de dâhildir. - Kendi kendini kapatan etiket özniteliklerinde tırnak içine alınmış büyük eşittir işaretleri kabul edilir.
- Genel HTML öznitelikleri, blok bunları alan olarak tanımlamadığında bir Blockstudio bloğunun köküne ulaşır.
wp bs pages sync, depolanan ancak işlenmeyen öznitelikleri bildirir.
Blade destekli sayfalar, desenler ve Site Editor şablonları artık Blockstudio\Blade_Renderer üzerinden işlenir ve illuminate/view 8 ile 12 arasındaki sürümleri destekler. Aynı bloğu hedefleyen uzantı dosyalarının tümü kaydedilir; öncelikleri, grup alanları ve hedef listeleri belgelenen şemaya uyar.
İç içe SCSS bağımlılıkları da izlenir. Başka bir kısmi şablon tarafından içe aktarılan bir kısmi şablonu düzenlemek, bağımlı stil sayfasının sürümünü değiştirir ve yeniden derlemeyi tetikler.
PHPStan iyileştirmeleri
Ayrı olarak yüklenen blockstudio/phpstan paketi; blok etiketi doğrulamasını önek ve takma ad etiketlerini, eşlenmiş sayfa öğelerini, yerleşimleri, birlikte gelen UI bloklarını ve isteğe bağlı olarak projedeki diğer PHP kaynaklarını kapsayacak şekilde genişletir. Ad alanı çözümlemesi, kısa çizgi içeren ad alanları da dâhil olmak üzere çalışma zamanıyla eşleşir ve iletilen genel HTML öznitelikleri kabul edilir.
$a, $block ve $context gibi blok şablonu değişkenleri, Blockstudio tarafından tanımlanmış kabul edilir. PHPStan 2.3 altında alan türleri null birleştirme ve isset() işlemlerinde korunur; şablon kendi $a değerini atarsa atanan tür korunur.
Bu değişiklikler blockstudio/phpstan 0.1.9 sürümünde yayımlanır. Paketi eklentiden ayrı güncelleyin; bunun için PHPStan 2.1.47 veya üzeri gerekir:
composer require --dev blockstudio/phpstan:^0.1.9
Yapılandırma ve analiz ön ayarları için PHPStan bölümüne bakın.
Erişilebilirlik ve çeviriler
Birlikte gelen UI tetikleyicileri, genişletilmiş durumlarını gerçek düğmede gösterir. Onay kutusu, anahtar ve radyo düğmesi etiketleri ilgili denetimleri adlandırır ve açıp kapatır. İçerik haritaları, sayfalama, gezinme menüleri ve tablolar artık listeler, tablolar ve bunların alt öğeleri arasına geçersiz sarmalayıcı öğeler eklemez.
Parola görünürlüğü anahtarları basılı durumlarını gösterir ve daha geniş tıklama alanına sahiptir. Girdiler autocomplete kabul eder; parola girdileri açıkça belirtilen bir kimliği ve erişilebilir etiketi destekler. Döngü alanları klavyeyle odaklanabilir; dönen yükleyici ve iskelet animasyonları azaltılmış hareket tercihine uyar.
Düzenleyici ve yönetici genel bakışı, blockstudio metin alanı için yüklenmiş JavaScript çevirilerini kullanır. Öznitelik menüleri ve yer tutucular, kod açılır penceresindeki eylemler ve görsel ile dosya rozetleri artık çevrilebilir. Çevirisi olmayan dizeler İngilizce kalır.
UI kitaplığı ve çeviri kurulumuna bakın.
Dokümantasyon ve yükseltme
Belgeler; dokümantasyon siteleri, Content Sync, Site Editor şablonları, blok etiketleri, adalar, özel alan türleri, dağıtım, önceden oluşturma, kayıt defteri kurulumu, analiz araçları ve UI uygulama ekranları için kılavuzlar ekliyor. ACF geçiş kılavuzu, güncel ACF kaydı ve Block Bindings konularını yansıtıyor.
Özel populate örnekleri artık desteklenen tek bağımsız değişkenli, adlandırılmış veri kümesi filtresini kullanıyor. Varlık belgeleri, ön yüz stil sayfası sırasını ve tema geçersiz kılmalarının blok CSS sonrasında nasıl yükleneceğini açıklıyor. Katılımcı kurulumları, kayıt defteri kimlik bilgileri olmadan herkese açık Font Awesome paketini kullanıyor.
PHP 8.2 ve WordPress 6.7 minimum gereksinimler olmaya devam ediyor. Sanal rotalar ve yeni bakım komutları, mevcut sayfa koleksiyonlarını değiştirmeden kullanılabilir. Yukarıdaki seçenek depolama kaydetme kurallarını inceleyin, kullanıyorsanız ayrı PHPStan paketini güncelleyin ve daha önce olduğu gibi sayfa eşitlemesini açıkça çalıştırmaya devam edin.
7.7.1 Takip
7.7.1 yaması, eşitleme sonuçlarını daha açık ve güvenli hâle getirir. Anahtarlı bir birleştirme gönderiyi değiştirmediğinde artık yeni bir sürüm oluşturmaz veya değiştirilme zaman damgasını güncellemez. Mevcut yayın durumları korunur, dosyanın yönettiği başlık ve kısa ad değişiklikleri raporlanır, kilitli veya kaldırılmış sayfalar CLI raporunda belirtilir. Content Sync, Page Sync’in yönettiği gövdeleri işaretler ve mevcut inceleme kopyalarını korur. Yama ayrıca WordPress tarafından yönetilen öznitelikleri çakışan alan kimliklerine karşı korur ve diğer filtrelerin eklediği düzenleyici sınıflarını muhafaza eder.