İçeriğe geç

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ı

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):

JavaScript
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):

JavaScript
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):

JavaScript
import "blockstudio/swiper@11.0.0/swiper.min.css";

Sonra (v7):

JavaScript
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ş:

PHP
// 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:

HTML
<!-- 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ş:

Kod
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": true değ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:

JSON
{
  "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ışı:

  1. WordPress tam sayfayı HTML çıktı arabelleğine işler
  2. HTML içinden CSS sınıf adayları çıkarılır (hızlı regex, derleme yapılmaz)
  3. Adaylar sıralanır ve önbellek anahtarı oluşturmak için CSS yapılandırmasıyla hash’lenir
  4. Önbellek isabetinde: önbelleğe alınmış CSS dosyası okunur ve eklenir
  5. Önbellek kaçırıldığında: TailwindPHP, CSS öğesini derler, tailwind kapsamı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):

JSON
{
  "tailwind": {
    "config": {
      "theme": {
        "extend": {
          "colors": {
            "primary": "pink"
          }
        }
      }
    }
  }
}

Sonra (v7):

JSON
{
  "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):

JSON
{
  "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):

JSON
{
  "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:

PHP
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.