v7 sürümüne geçiş
Bu kılavuz, Blockstudio 6’dan 7’ye yükseltirken yapmanız gereken değişiklikleri kapsar.
ES Modülü İçe Aktarımları
Yeni npm: Öneki (Önerilen)
Blockstudio 7, ES modülü içe aktarımları için yeni bir npm: öneki sunarak Deno’nin npm belirticisi kuralıyla uyum sağlar.
Önce (v6):
import { h, render } from "blockstudio/preact@10.15.1";
import htm from "blockstudio/htm@3.1.1";
import confetti from "blockstudio/canvas-confetti@1.6.0";
Sonra (v7):
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";
CSS İçe Aktarımları
Aynı değişiklik CSS içe aktarımları için de geçerlidir:
Önce (v6):
import "blockstudio/swiper@11.0.0/swiper.min.css";
Sonra (v7):
import "npm:swiper@11.0.0/swiper.min.css";
Geriye Dönük Uyumluluk
blockstudio/ öneki geriye dönük uyumluluk için desteklenmeye devam eder. Mevcut kodunuz değişiklik yapmadan çalışmaya devam eder. Ancak daha geniş JavaScript ekosistemiyle tutarlılık için npm: önekine geçmenizi öneririz.
npm: öneki çeşitli avantajlar sunar:
- Ekosistem uyumu – Deno’nin yerleşik kuralıyla eşleşir
- Açıklık – npm üzerinden içe aktarım yaptığınız hemen anlaşılır
- Geleceğe hazırlık –
blockstudio/öneki gelecekteki bir ana sürümde kullanımdan kaldırılabilir
Hook Adları
Blockstudio 7, tüm PHP hook adlarını camelCase yerine snake_case kullanacak şekilde standartlaştırarak WordPress çekirdek kurallarıyla uyum sağlar.
Değişen Hook Adları
| Eski Ad (v6) | Yeni Ad (v7) |
|---|---|
blockstudio/blocks/components/useblockprops/render |
blockstudio/blocks/components/use_block_props/render |
blockstudio/blocks/components/innerblocks/render |
blockstudio/blocks/components/inner_blocks/render |
blockstudio/blocks/components/innerblocks/frontend/wrap |
blockstudio/blocks/components/inner_blocks/frontend/wrap |
blockstudio/blocks/components/richtext/render |
blockstudio/blocks/components/rich_text/render |
blockstudio/assets/process/scss/importPaths |
blockstudio/assets/process/scss/import_paths |
blockstudio/settings/assets/process/scssFiles |
blockstudio/settings/assets/process/scss_files |
blockstudio/settings/editor/formatOnSave |
blockstudio/settings/editor/format_on_save |
blockstudio/settings/blockEditor/disableLoading |
blockstudio/settings/block_editor/disable_loading |
blockstudio/settings/blockEditor/cssClasses |
blockstudio/settings/block_editor/css_classes |
blockstudio/settings/blockEditor/cssVariables |
blockstudio/settings/block_editor/css_variables |
blockstudio/settings/ai/enableContextGeneration |
blockstudio/settings/ai/enable_context_generation |
Geriye Dönük Uyumluluk
Eski camelCase hook adları geriye dönük uyumluluk için desteklenmeye devam eder. Mevcut kodunuz değişiklik yapmadan çalışmayı sürdürür. Ancak tutarlılık için yeni snake_case adlarına geçmenizi öneririz.
Örnek geçiş:
// 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'];
});
Kanonik Blok Etiketleri
Blockstudio 7.6, proje öneklerini ve tam takma adları çalışma zamanında genişletme noktaları olarak korur; ancak örneklerde, katalog çıktısında, oluşturma bildirimlerinde ve tanılama mesajlarında kanonik yazım olarak <bs:namespace-slug> kullanır. Kanonik etiketler gerçek kayıtlı blok adını taşır ve ana makineye özgü bir filtreye bağlı değildir.
brand => ["theme-components"] ve ui => ["bsui"] içeren bir proje için:
<!-- Legacy project shorthand -->
<brand-card>
<ui-input />
</brand-card>
<!-- Canonical output -->
<bs:theme-components-card>
<bs:bsui-input />
</bs:theme-components-card>
Bağımsız bir geçiş komutu mevcut projeyi envanterler ve kısa adları kanonik yazıma dönüştürür. Önce rapor sunar, çözümlenmemiş durumlarda işlemi durdurur ve yalnızca etiket adlarını değiştirir. Komut, girdileri ve güvenlik davranışı için Blok Etiketi Geçişi bölümüne bakın.
Varlık Dosyalarını Adlandırma
Blockstudio 7, önerilen kural olarak eski tireli yazımın yerini alan, varlık dosyası sonekleri için noktalı gösterimi sunar.
Değişen Dosya Adları
| Eski Ad (v6) | Yeni Ad (v7) |
|---|---|
*-inline.(s)css |
*.inline.(s)css |
*-inline.js |
*.inline.js |
*-editor.(s)css |
*.editor.(s)css |
*-editor.js |
*.editor.js |
*-scoped.(s)css |
*.scoped.(s)css |
*-view.js |
*.view.js |
Geriye Dönük Uyumluluk
Eski tireli yazım geriye dönük uyumluluk için desteklenmeye devam eder. Mevcut dosyalarınız yeniden adlandırılmadan çalışmayı sürdürür. Ancak yeni bloklarda noktalı gösterime geçmenizi öneririz.
Örnek geçiş:
my-block/
├── block.json
├── index.php
├── style.css
├── style-inline.css → style.inline.css
├── style-scoped.css → style.scoped.css
├── style-editor.css → style.editor.css
├── script.js
├── script-inline.js → script.inline.js
├── script-editor.js → script.editor.js
└── script-view.js → script.view.js
Alan Anahtarı
switch özelliğinin varsayılanı artık true yerine false. v6 sürümünde her alanda sol kenarda varsayılan olarak etkin, 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.
Neler Değişti
- Varsayılan artık
false:"switch": truedeğerini açıkça ayarlamadığınız sürece alanlarda artık anahtar bulunmaz - Görünür göz simgesi: gizli sol tıklama alanı yerine etiket bölümünde göz simgeli bir düğme görünür
- Devre dışı kaplaması: bir alan devre dışı bırakıldığında yalnızca opaklığı azaltmak yerine, "Bu alan devre dışı" metnini içeren bulanık bir kaplama gösterilir
Geçiş
v6 sürümündeki varsayılan anahtar davranışına bağlı kaldıysanız, anahtarı açıkça etkinleştirmeniz gerekir:
{
"id": "title",
"type": "text",
"label": "Title",
"switch": true
}
Geçişi devre dışı bırakmak için daha önce "switch": false ayarını kullandıysanız, artık varsayılan false olduğundan bu ayarı kaldırabilirsiniz.
Tailwind CSS
Blockstudio 7, v6 Tailwind yaklaşımının yerini tamamen alır. v6 sürümünde Tailwind CSS, editördeki CDN aracılığıyla istemci tarafında derlenir ve yazı kaydedildiğinde diske kaydedilirdi. v7 sürümünde Tailwind CSS, her ön yüz isteğinde TailwindPHP aracılığıyla sunucu tarafında derlenir ve dosya tabanlı önbelleğe alma otomatik olarak yapılır.
Yeni sistemle ilgili tüm ayrıntılar için Tailwind CSS belgelerine bakın.
Her Zaman Sunucu Tarafında Derleme
tailwind.enabled değeri true olduğunda her ön yüz isteği sunucu tarafında derlenir. Derleme akışı:
- WordPress tam sayfayı HTML çıktı arabelleğine işler
- HTML içinden CSS sınıf adayları çıkarılır (hızlı regex, derleme yapılmaz)
- Adaylar sıralanır ve önbellek anahtarı oluşturmak için CSS yapılandırmasıyla hash’lenir
- Önbellek isabetinde: önbelleğe alınmış CSS dosyası okunur ve eklenir
- Önbellek kaçırıldığında: TailwindPHP, CSS öğesini derler,
tailwindkapsamındaki Blockstudio’in paylaşılan çalışma zamanı önbelleğine yazar ve ekler
Derlenmiş CSS, </head> öncesinde satır içi bir <style id="blockstudio-tailwind"> etiketi olarak eklenir. Buna Tailwind’in preflight’i ve eşleşen tüm yardımcı sınıflar dahildir.
CDN betiği düzenleyicide yalnızca canlı önizleme için etkin kalır. Ön yüzde hiçbir zaman sunulmaz.
config Biçimi Değişti
config özelliği, JSON nesnesinden (Tailwind v3) CSS dizgesine (Tailwind v4 CSS-öncelikli söz dizimi) dönüştü.
Önce (v6):
{
"tailwind": {
"config": {
"theme": {
"extend": {
"colors": {
"primary": "pink"
}
}
}
}
}
}
Sonra (v7):
{
"tailwind": {
"config": "@theme { --color-primary: pink; }"
}
}
customClasses Ayarı Kaldırıldı
customClasses dizi ayarı kaldırıldı. Tailwind v4’nin CSS-öncelikli yaklaşımında, özel yardımcı sınıflar doğrudan config dizgesinde @layer utilities kullanılarak tanımlanır.
Önce (v6):
{
"tailwind": {
"customClasses": [
{ "className": "btn", "value": "px-4 py-2 rounded-lg font-medium" },
{ "className": "card", "value": "bg-white rounded-xl shadow-lg p-6" }
]
}
}
Sonra (v7):
{
"tailwind": {
"config": "@layer utilities { .btn { @apply px-4 py-2 rounded-lg font-medium; } .card { @apply bg-white rounded-xl shadow-lg p-6; } }"
}
}
Çok satırlı yapılandırmalar için filtre aracılığıyla da:
add_filter('blockstudio/settings/tailwind/config', function () {
return <<<CSS
@layer utilities {
.btn { @apply px-4 py-2 rounded-lg font-medium; }
.card { @apply bg-white rounded-xl shadow-lg p-6; }
}
CSS;
});
blockstudio/settings/tailwind/custom_classes filtresi de kaldırıldı. Özel CSS kuralları eklemek için bunun yerine blockstudio/tailwind/css filtresini kullanın.
REST Uç Noktası Kaldırıldı
POST /blockstudio/v1/editor/tailwind/save uç noktası kaldırıldı. Derlenmiş CSS artık düzenleyiciden kaydedilmez. Bu uç noktayı çağıran özel kodunuz varsa güvenle kaldırabilirsiniz.
Önbelleğe Alma
Blockstudio, aday tabanlı bir önbelleğe alma stratejisi kullanır. Sayfanın tamamındaki HTML hash’lenmek yerine (nonce’lar ve zaman damgaları nedeniyle her istekte önbellek geçersiz kılınırdı), yalnızca CSS sınıf adayları hash’lenir. Bunun anlamı:
- CSS sınıfları aynı olan iki sayfa aynı önbellek dosyasını paylaşır
- Dinamik içerik (nonce’lar, yönetici çubukları, zaman damgaları) önbelleği geçersiz kılmaz
- Önbellek yalnızca CSS sınıflarının kümesi veya yapılandırma değiştiğinde geçersiz kılınır
Önbellek dosyaları, yapılandırılmış Blockstudio çalışma zamanı kökünü sites/{network-blog}/{runtime-identity}/tailwind/ altında kullanır. Yeniden derlemeyi zorlamak için Blockstudio\Runtime_Cache::purge('tailwind') çağrısını yapın.
Filtre Değişiklikleri
| Eski Ad (v6) | Yeni Ad (v7) |
|---|---|
blockstudio/tailwind/on_demand/css |
blockstudio/tailwind/css |
blockstudio/tailwind/assets/dir |
Kaldırıldı |
blockstudio/settings/tailwind/custom_classes |
Kaldırıldı |
Kaldırılan Dosyalar ve Yüklemeler
v6 sürümünde Tailwind CSS harici stil sayfaları olarak yüklenirdi (blockstudio-tailwind, blockstudio-tailwind-preflight). v7 sürümünde tüm CSS bir çıktı arabelleği aracılığıyla satır içi eklenir. Ön yüzde Tailwind için bağlantı etiketi veya yüklenen stil sayfası yoktur.
Blok Kitaplığı
Yerleşik “Blockstudio Öğeleri” kitaplığı kaldırıldı. blockstudio.json içindeki library ayarının ve blockstudio/settings/library filtresinin artık hiçbir etkisi yoktur.
Kitaplık bloklarını (Galeri, Kaydırıcı, Görüntü Karşılaştırma, Kod, Simge) kullanıyorsanız, blok klasörlerini v6 kurulumunuzdaki includes/library/blockstudio-element/ dizininden temanızın blockstudio dizinine kopyalayın ve block.json dosyalarını yeni adlar ve kategorilerle güncelleyin.