İçeriğe geç

Ayarlar

Blockstudio, tema klasörünüzdeki bir blockstudio.json dosyası ve/veya filtreler aracılığıyla seçenekleri ayarlamanıza olanak tanıyan güçlü bir ayar API içerir. Ayrıca, izin verilen kullanıcılar yönetici alanında ayarları görsel olarak değiştirebilir.

JSON aracılığıyla

Tema klasörünüzde bir blockstudio.json dosyası varsa, geçerli site için varsayılan seçenekleri belirlemek üzere kullanılır. Dosyayı doğrulamak ve bir IDE’de otomatik tamamlama desteği sağlamak için JSON şeması mevcuttur.

Dosya isteğe bağlıdır. Dosya yoksa Blockstudio, yerleşik varsayılan ayarlarına ek olarak yönetici alanına kaydedilmiş ayarları kullanır. Dosyanın eklenmesi, değiştirilmesi veya kaldırılması otomatik olarak algılanır; önbelleği temizlemek ya da sayfayı elle yeniden yüklemek gerekmez.

Kullanılabilir özellikler şunlardır:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "users": {
    "ids": [],
    "roles": []
  },
  "assets": {
    "enqueue": true,
    "reset": {
      "enabled": false,
      "fullWidth": []
    },
    "minify": {
      "css": false,
      "js": false
    },
    "process": {
      "scss": false
    }
  },
  "cache": {
    "enabled": true,
    "path": "blockstudio/cache"
  },
  "themeDefaults": {
    "titleTag": false,
    "suppressDirectoryUpdates": false
  },
  "performance": {
    "profile": "compat",
    "wordpress": {
      "headNoise": false,
      "embeds": false,
      "xmlrpc": false,
      "editor": false,
      "frontendAssets": false,
      "media": false,
      "heartbeat": false
    },
    "preload": {
      "links": "off"
    },
    "media": {
      "lazy": false,
      "skeleton": false,
      "metadata": false,
      "rootMargin": "300px"
    },
    "measurement": {
      "enabled": false,
      "queryMonitor": false,
      "headers": false,
      "timings": false
    }
  },
  "content": {
    "enabled": false,
    "id": "default",
    "path": "content",
    "includePageSyncManaged": false,
    "authors": "ignore",
    "postTypes": [],
    "meta": {
      "include": [],
      "exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
      "references": {}
    },
    "taxonomies": [],
    "media": "manifest"
  },
  "editor": {
    "formatOnSave": false,
    "assets": [],
    "markup": false
  },
  "tailwind": {
    "enabled": false,
    "config": "",
    "output": "inline"
  },
  "blockTags": {
    "enabled": false,
    "allow": [],
    "deny": [],
    "prefixes": {}
  },
  "ui": {
    "enabled": false
  },
  "blockEditor": {
    "disableLoading": false,
    "enhance": false,
    "cssClasses": [],
    "cssVariables": [],
    "blocks": {
      "allow": [],
      "deny": [],
      "directory": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      },
      "styles": {
        "deny": {}
      },
      "legacyWidgets": {
        "hide": []
      }
    },
    "patterns": {
      "core": true,
      "remote": true,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      }
    },
    "media": {
      "openverse": true,
      "imageSizes": {
        "allow": [],
        "deny": []
      }
    }
  },
  "dev": {
    "grab": {
      "enabled": false
    },
    "perf": false,
    "canvas": {
      "enabled": false,
      "adminBar": true
    }
  },
  "githooks": {
    "commit": false
  },
  "phpstan": {
    "preset": "base",
    "configuration": "",
    "roots": ["."],
    "excludePaths": [],
    "maxFiles": 10000
  },
  "ai": {
    "enableContextGeneration": false
  }
}

Filtreler aracılığıyla

Alternatif olarak daha fazla esneklik için seçenekleri PHP üzerinden ayarlamak üzere blockstudio/settings/${setting} filtresini kullanabilirsiniz.

PHP
add_filter('blockstudio/settings/assets/enqueue', '__return_false');
add_filter('blockstudio/settings/editor/formatOnSave', '__return_true');
add_filter('blockstudio/settings/ui/enabled', '__return_true');
add_filter('blockstudio/settings/block_editor/patterns/remote', '__return_false');

blockstudio/settings/${setting} filtresiyle ayarlanan seçenekler, blockstudio.json dosyasıyla ayarlananları geçersiz kılar. Her iki yöntem birlikte kullanılabilir.

Çalışma zamanı değerleri ayrıca blockstudio/performance/${setting} filtrelerini ve bir son blockstudio/performance/config filtresini sunar. Sonuncusu geçerli bir yapılandırma nesnesi döndürmelidir.

Kaynaklar nasıl katmanlanır

Her kaynak yüklenir ve en düşük öncelikliden başlayarak birleştirilir:

  1. Yerleşik varsayılanlar
  2. Yönetici UI alanından kaydedilen ayarlar (blockstudio_settings seçeneği)
  3. Temadaki blockstudio.json
  4. blockstudio/settings/* filtreleri

blockstudio.json yalnızca tanımladığı anahtarları geçersiz kılar. Önceden kaydedilmiş ayarların tümünün yerini alıyordu; bu nedenle dosya ortaya çıktığında ilgisiz bir yönetici kaydıyla belirlenen değer artık uygulanmıyordu. Artık bu değerlerin üzerine ekleniyor. Bunun karşılığında, yönetici UI alanına kaydedilmiş eski bir değer, dosyada ilgili anahtar tanımlanana veya kayıtlı değer kaldırılana kadar uygulanmaya devam eder. Bir ayar dosyada belirtilenden farklı davranıyorsa wp bs settings veya Settings::get_raw() ile kaydedilmiş katmanı kontrol edin; bu yöntem, etkin JSON veya seçenek kaynağında açıkça tanımlanan değerleri döndürür.

Ayarları PHP üzerinden okuma

Blockstudio\Settings etkin kaynağı yükler, hatalı JSON bildiriminde bulunur ve blockstudio.json değiştiğinde otomatik olarak yeniden yüklenir:

PHP
use Blockstudio\Settings;

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

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

Bir entegrasyonun yalnızca etkin JSON veya seçenekler kaynağında açıkça tanımlanmış değerlere ihtiyacı varsa Settings::get_raw() kullanın. Settings::fingerprint(), etkili ayarların belirleyici bir kimliğini döndürür. Uzun süre çalışan süreçler, bir dosya değişikliğini hemen okumak için Settings::reload() öğesini açıkça çağırabilir. Normal erişimde dosya, aynı boyuttaki düzenlemeler de dahil olmak üzere, istek veya uzun süre çalışan PHP süreci başına saniyede en fazla bir kez denetlenir. Yapılandırılan yolun değiştirilmesi sonraki okumada etkili olur. Etkin bir JSON dosyası yoksa, veritabanına kaydedilen ayarlar bu bekleme süresinden etkilenmez.

Çözümlenen performans profiline Blockstudio\Runtime_Settings::current() üzerinden erişilebilir. Eğik çizgi veya nokta yollarını destekler:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

if ($runtime->enabled('measurement/queryMonitor')) {
    $hash = $runtime->hash();
}

Kullanılabilir Ayarlar

users

Seçenek Tür Varsayılan Açıklama
ids array [] Düzenleyici erişimi olan kullanıcı kimlikleri
roles array [] Düzenleyici erişimi olan kullanıcı rolleri

assets

Seçenek Tür Varsayılan Açıklama
enqueue boolean true Blok varlıklarını otomatik olarak kuyruğa al
reset.enabled boolean false Çekirdek blok stillerini kaldır ve düzenleyici yardımcı sınıflarının sıfırlamasını uygula
reset.fullWidth array [] Tam genişlikli düzenleyici düzenini kullanan gönderi türleri
minify.css boolean false CSS çıktısını küçült
minify.js boolean false JS çıktısını küçült
process.scss boolean false SCSS dosyalarını işle
output string source Derlenmiş varlıkların yazılacağı konum: source veya cache
inlineLimit integer 0 Sayfa başına satır içinde yazdırılan harici blok CSS bayt sayısı

output varsayılan olarak source değerini kullanır; bu da her bloğun yanına bir _dist dizini yazar. Derlenmiş varlıkları bunun yerine Blockstudio önbellek dizinine yazmak için cache olarak ayarlayın; böylece blok kaynak ağacı temiz kalır ve değiştirilemez bir ödeme üzerinden dağıtılabilir. Kaynak Blockstudio zaten yazma işlemlerini bu ayardan bağımsız olarak önbelleğe yönlendirir.

inlineLimit, 0 konumunda kapalıdır; bu nedenle her harici stil sayfası kendi <link> etiketini korur. Bunun yerine, bir sayfanın en küçük harici blok stil sayfalarını, toplam boyutları bu sayıyı aşmadığı sürece satır içine yazdırmak için bayt cinsinden bir sayı ayarlayın. 40000, aynı kural için WordPress çekirdeğinin kullandığı sınırdır. Satır İçi Küçük Stil Sayfaları bölümüne bakın.

reset.enabled etkinken Blockstudio, arındırılmış ön yüz body_class değerlerini düzenleyici tuvaline de kopyalar. Düzenleyiciye özel sınıf listesini ayarlamak için blockstudio/editor/canvas/body_class kullanın.

cache

Seçenek Tür Varsayılan Açıklama
enabled boolean true Blockstudio dosya tabanlı önbellekleri etkinleştir
path string "blockstudio/cache" WP_CONTENT_DIR konumuna göreli veya mutlak önbellek yolu
namespaceGrace integer 86400 Emekliye ayrılmış önbellek ad alanının temizlenmeden önce tutulacağı saniye sayısı

Önbellek dosyaları varsayılan olarak yüklemeler dizininin dışındaki wp-content/blockstudio/cache konumuna yazılır. Göreli bir path, WP_CONTENT_DIR konumuna göre çözümlenir; mutlak yol ise doğrudan kullanılır. Bu, özel ve yazılabilir bir önbellek birimi sağlayan barındırma hizmetlerini destekler.

Etkinleştirildiğinde Blockstudio; derleme yükleri, önceden oluşturulmuş blok kayıt verileri, çözümlenmiş düzenleyici varlıkları, Tailwind CSS, görüntüleme belgeleri, ada parçaları, statik ön işleme çıktıları, grafik dizinleri, kuyruklar ve tanılama verileri için bu tek kökü kullanır. Her nesne ağ, site, eksiksiz çalışma zamanı kimliği ve kapsam temelinde yalıtılır. Çalışma zamanı kimlikleri Blockstudio, ayarları, WordPress, PHP, etkin temayı, etkin eklentileri, mantıksal keşif kaynaklarını, ana makine bağlamını ve işlemi yürüten tarafın sağladığı açık bağımlılık karmalarını kapsar.

İçerik, terim, kullanıcı ve meta verilerdeki değişiklikler, doldurulmuş alan seçeneklerini geçersiz kılar; yapısal blok keşfini veya derlenmiş varlıkları etkilemez. Seçenekler, sabit bir derleme yolu kilidi altında ayrıca yenilenir. Çeviri eşitleme veya içe aktarma gibi toplu yazma işlemleri birleştirilir: sessiz bir dönemden sonraki ilk yazma hemen yenileme yapar, son yazma ise otuz saniye geçince yansıtılır; bu süre blockstudio/cache/populate_debounce ile ayarlanabilir. Muhasebe kaydı olarak WordPress tarafından yapılan, yazı düzenleme kilidi gibi meta yazma işlemleri değişiklik sayılmaz; blockstudio/cache/populate_ignored_meta_keys bu listeyi genişletir. Düzenleyici her zaman canlı seçenekleri sorgular; dolayısıyla bu süre yalnızca oluşturma anında okunan önbelleğe alınmış seçenekleri etkiler. Kaynak dosyalar ve derleme ayarları yapısal önbelleği normal şekilde geçersiz kılar. Seçeneklerin üzerine yazılması, her içerik değişikliğinde önbellek dizininin yeniden taranmasına yol açmaz; düzenli temizlik sahipsiz geçici dosyaları yine toplar. Dile özgü çalışma zamanı kimlikleri yalıtılmış kalır; çok dilli bir sitede birden fazla önbellek ad alanı dizininin bulunması tek başına önbellek kaçırmasına kanıt değildir.

Bir bloğun db veri dizinindeki SQLite günlük etkinliği, önbelleğe alınmış blok meta verilerini silmez. db.php üzerinde, izlenen kaynak dosyalarda veya veri dizininin kaynak dosya ve alt dizin yapısında yapılan değişiklikler yine de önbelleği geçersiz kılar.

Eşzamanlı çalışma zamanı yeniden derlemelerinde tek bir derleyici seçilir. Diğer istekler beş saniyeye kadar bekler; ardından kaynak dosyaları ve gerekli derlenmiş varlıkları hâlâ mevcutsa son iyi blok meta verilerini yeniden kullanır. Güvenli bir yükü olmayan soğuk bir istek, başka bir derleme başlatmak yerine Retry-After içeren HTTP 503 döndürür. blockstudio/cache/build_wait_budget filtresi, hem yapısal yeniden derlemeler hem de seçenek yenilemeleri için bekleme süresini milisaniye cinsinden ayarlar. Tavsiye niteliğinde dosya kilitlerini desteklemeyen bir ana makine, seçenekleri korumasız biçimde yenileyip yayımlamaya devam eder; böylece sonraki istek önbellek isabeti sağlar.

Önceki sürümlerin bıraktığı boşta duran anahtara özel .build.lock dosyaları, yükseltmeden beş dakika sonra başlayarak bu sitenin tüm önbellek ad alanlarında WP-Cron tarafından toplanır; on saniyelik süre içinde dakikada en fazla 10,000 kilit kaldırılır. wp bs cache status kalan sayıyı bildirir, wp bs cache cleanup birikmiş işleri hemen tamamlar ve wp bs cache clear çalışma zamanı önbelleğini temizler. cron çalışmadığı için zamanlanmış bir işlem on dakikadan fazla gecikirse, temizleme işleminin durmaması için istekler saatte bir sınırlı sayıda kilidi tarar. Yeni veya kullanımda olan kilitlere dokunulmaz; yeni sabit yollu kilitler de hiçbir zaman toplanmaz. Birikmiş işler tamamlandığında aynı işlem, namespaceGrace süresi dolmuş terk edilmiş önbellek ad alanlarını her site için saatte en fazla bir kez toplar ve bunun için günlük bir işleme de devam eder. Bekleme süresi, bir ad alanının kullanımdan kaldırıldığını bulan ilk taramadan itibaren hesaplanır; en yeni dosyasından itibaren değil. Kapsamlarından herhangi biri için hâlâ geçerli olan bir ad alanı hiçbir zaman toplanmaz. Dahili önbellek temizliği, WordPress ek silme filtrelerini çağırmaz. WP-Cron devre dışı olan ana makineler olağan zamanlanmış cron işçisini çalıştırmaya devam etmelidir; birikmiş işleri temizlemek için etkin kilit dosyalarını gelişigüzel silmeyin.

blockstudio/settings/cache/path ayar filtresi yapılandırılan değeri değiştirir. Dağıtıma özgü yol çözümlemesi için blockstudio/cache/dir çözümlenmiş temel dizini filtreler:

PHP
add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

Kiracı kimliği WordPress ağ/blog kimliklerinden farklı olan ana makineler blockstudio/cache/site_key değerini filtreleyebilir. Sonuç arındırılır ve yalnızca dizin segmenti olarak kullanılır. Serileştirilebilir bir çalışma zamanı değişkeninin nesne kimliklerini değiştirmesi gerekiyorsa doğru yer yine blockstudio/cache/context filtresidir.

themeDefaults

Seçenek Tür Varsayılan Açıklama
titleTag boolean false WordPress başlık etiketi tema desteğini etkinleştir
suppressDirectoryUpdates boolean false Etkin alt ve üst temaları dizin güncelleme sonuçlarından kaldır

Desenler mevcut Blockstudio\Patterns API kullanmaya devam eder; bu varsayılanlar alternatif sayfa veya desen arayüzleri sunmaz.

performance

compat profili genel WordPress davranışını değiştirmez. speed ve strict aynı isteğe bağlı ön yüz varsayılanlarını etkinleştirir; her alt ayar profilindeki değeri geçersiz kılabilir.

İsteğe bağlı ayarlar kayıt kapılarıdır. İsteğe bağlı bir özellik false olduğunda Blockstudio, bu özelliğin ön yüz, yönetici, düzenleyici, REST veya zamanlanmış geri çağırmalarını eklemez. Early Serve veya zamanlanmış ısıtma kullanıldıktan sonra devre dışı bırakılırsa ilgili temizlik bir kez yapılır; sonraki istekler etkisiz kalır.

Seçenek Tür Uyumluluk varsayılanı Hız/katılık varsayılanı Açıklama
profile string "compat" Uygulanamaz compat, speed veya strict
wordpress.headNoise boolean false true Genel head keşfini ve emoji çıktısını kaldırır
wordpress.embeds boolean false true oEmbed keşfini ve barındırıcı betiklerini kaldırır
wordpress.xmlrpc boolean false true XML-RPC ve pingback’leri devre dışı bırakır
wordpress.editor boolean false true Uzak düzenleyici keşif yüzeylerini devre dışı bırakır
wordpress.frontendAssets boolean false true Genel çekirdek ön yüz varlıklarını kaldırır
wordpress.media boolean false true Görüntü çıktısı varsayılanlarını uygular
wordpress.heartbeat boolean false true Düzenleyiciler dışında Heartbeat’i sınırlar
preload.links string "off" "intent" Kullanıcı isteğinden sonra aynı kaynaktaki belgeleri önceden getirir
media.lazy boolean false true Blockstudio görüntü yükleyicisini kullanır
media.skeleton boolean false true Yerleşik yükleme iskeletini gösterir
media.metadata boolean false true assets/media.json kullanımını beyan eder
media.rootMargin string "300px" "300px" Tembel yükleyici kesişim kenar boşluğu
measurement.enabled boolean false false Çalışma zamanı ölçüm API’lerini etkinleştirir
measurement.queryMonitor boolean false false En az 50ms süren sorguları içerir
measurement.headers boolean false false Profil ve yapılandırma özeti üstbilgilerini gönderir
measurement.timings boolean false false Geçen çalışma süresi üstbilgisini gönderir
staticPrerender.enabled boolean false false Anonim kullanım için güvenli HTML önbelleğe almayı etkinleştirir
staticPrerender.ttl integer 86400 86400 Saniye cinsinden en uzun önbelleğe alınmış belge yaşı
staticPrerender.invalidate string "signature" "signature" signature veya artımlı graph kimliğini kullanır
staticPrerender.earlyServe boolean false false WordPress başlatılmadan önce güvenli isabetleri sunar
staticPrerender.serveLoggedIn boolean false false Kullanıcıların önbellek isabetlerini tüketmesine izin verir, içerik üretmesine değil
staticPrerender.dynamicPaths array [] [] Dinamik kalması gereken yol önekleri
staticPrerender.replayHeaders array ["Link"] ["Link"] Önbellek isabetleriyle saklanan ve gönderilen yanıt üstbilgileri
staticPrerender.warm.enabled boolean false false Kalıcı zamanlanmış ısıtma kuyruğunu etkinleştirir
staticPrerender.warm.interval integer 3600 3600 Saniye cinsinden ısıtma aralığı
staticPrerender.warm.concurrency integer 2 2 Tek bir ısıtma geçişinde işlenen en fazla iş sayısı
staticPrerender.warm.transport string "http" "http" http veya barındırıcı tarafından sağlanan internal oluşturucuyu kullanır

Statik ön oluşturma, açıkça etkinleştirilmediği sürece devre dışı kalır. Ana anahtar devre dışıyken hiçbir ön oluşturma isteği kancası kaydedilmez; earlyServe ve warm.enabled anahtarları devre dışıyken hiçbir yönetici veya cron kancası kaydedilmez. İmza modu, sıradan isteklerde düşük maliyetli etkinleştirilmiş bir kimlik kullanır. Grafik modu açık derlemeler için tasarlanmıştır: sayfa başına kaynak bağımlılıklarını kaydeder, böylece bir sayfanın değiştirilmesi ilgisiz belgeleri geçersiz kılmaz. Isıtma, yayınlama, erken sunum ve güvenlik ayrıntıları için Statik Ön Oluşturma bölümüne bakın.

Ölçümlere programatik olarak erişilebilir:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Başlıklar etkinleştirildiğinde Blockstudio şunları gönderir: X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config ve isteğe bağlı olarak X-Blockstudio-Performance-Time. blockstudio/performance/measurement_enabled eylemi, çözümlenmiş çalışma zamanı ayarlarını alır.

media seçenekleri bs_media_image(), assets/media.json bildirimini ve ön yüz tembel yükleyicisini yönlendirir. Yardımcı, bildirim oluşturucu ve yükleyicinin davranışı için Medya bölümüne bakın.

content

Seçenek Tür Varsayılan Açıklama
enabled boolean false Content Sync yapılandırmasını etkinleştirir
id string "default" Senkronize varlıklarda saklanan içerik kümesi ad alanı
path string "content" Temaya göreli içerik dosyası dizini
includePageSyncManaged boolean false Gövdesinin sahibi olmadan Page Sync tarafından yönetilen gönderileri dahil eder
authors string "ignore" Yazar işleme yöntemi (ignore veya mevcut kullanıcı login)
postTypes array [] İzin verilen gönderi türleri
meta.include array [] Senkronize edilecek meta anahtarları için glob kalıpları
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Hariç tutulacak meta anahtarları için glob kalıpları
meta.references object {} Bildirilen meta referanslarını kimlikler ve UID’ler arasında yeniden yazar
taxonomies array [] Terimler ve ilişkiler için izin verilen kayıtlı taksonomiler
media string "manifest" Ek dosya referansı davranışı (manifest veya none)

Content Sync, wp bs content üzerinden yönetilir ve izin verilen gönderileri, gönderi metalarını ve bildirilen referansları taşınabilir dosyalara aktarır. İş akışı ve dosya biçimi için Content Sync bölümüne bakın.

editor

Seçenek Tür Varsayılan Açıklama
formatOnSave boolean false Kaydederken block.json biçimlendirir
assets array [] Düzenleyicide yüklenecek ek varlıklar
markup boolean false Biçimlendirme dili düzenlemesini etkinleştirir

tailwind

Seçenek Tür Varsayılan Açıklama
enabled boolean false Tailwind CSS derlemesini etkinleştirir
config string "" Tailwind v4 CSS öncelikli yapılandırma

Derleme davranışı ve CSS öncelikli yapılandırma biçimi için Tailwind CSS bölümüne bakın.

blockTags

Seçenek Tür Varsayılan Açıklama
enabled boolean false Gönderi içeriğinde ve bileşen alanlarında sayfa düzeyinde bs: etiketi oluşturmayı etkinleştirir
allow array [] Blok adı kalıpları izin listesi; fnmatch() joker karakterlerini destekler
deny array [] Blok adı kalıpları ret listesi; allow üzerinde önceliklidir
prefixes object {} Kısa adları ad alanına yerleştiren önek; her değer bir ad alanı veya sıralı dizidir

Şablon düzeyinde etiket oluşturma her zaman etkindir; bu seçenekler sayfa düzeyindeki değiştirmeyi kontrol eder. Etiket sözdizimi ve çözümleme kuralları için Oluşturma bölümüne bakın.

ui

Seçenek Tür Varsayılan Açıklama
enabled boolean false Paketle gelen bsui/* UI bileşenlerini ve app/* demo uygulamalarını kaydeder

blockEditor

Seçenek Tür Varsayılan Açıklama
disableLoading boolean false Düzenleyicide blok yüklemeyi devre dışı bırakır
enhance boolean false Blockstudio düzenleyicide üzerine gelme ve seçme kontrollerini etkinleştirir
cssClasses array [] Sınıf alanı otomatik tamamlaması için CSS sınıflarını çıkarılacak stil sayfası URL’leri
cssVariables array [] Kod alanı otomatik tamamlaması için CSS değişkenleri çıkarılacak stil sayfası URL’leri

blockEditor.blocks

Proje genelinde blok ekleyici politikasını blockEditor.blocks ile belirleyin. allow ve deny, blok adlarını ve core/* gibi joker karakterli kalıpları kabul eder.

JSON
{
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      },
      "legacyWidgets": {
        "hide": ["archives", "calendar"]
      }
    }
  }
}

blocks.styles.deny, WordPress blok stili kayıt defteri üzerinden kaydedilen stillerin kaydını siler: PHP

JSON
{
  "blockEditor": {
    "blocks": {
      "styles": {
        "deny": {
          "my-theme/card": ["outline"],
          "my-theme/media": ["framed"]
        }
      }
    }
  }
}

blockEditor.patterns

Genel kalıp kaynaklarını devre dışı bırakmak ve kalıp kategorilerini filtrelemek için blockEditor.patterns kullanın.

JSON
{
  "blockEditor": {
    "patterns": {
      "core": false,
      "remote": false,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "deny": ["gallery"],
        "rename": {
          "featured": "Featured Layouts"
        },
        "order": ["featured", "buttons"]
      }
    }
  }
}

blockEditor.media

Genel medya ekleyici politikasını blockEditor.media ile belirleyin.

JSON
{
  "blockEditor": {
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"],
        "deny": ["medium_large"]
      }
    }
  }
}

dev

Seçenek Tür Varsayılan Açıklama
grab.enabled boolean false Ön yüzde öğe yakalayıcıyı etkinleştirir
perf boolean false performans profilleyiciyi her sayfa yüklemesinde etkinleştirir
canvas.enabled boolean false tuvali etkinleştirir
canvas.adminBar boolean true Tuvali görüntülerken WordPress yönetim çubuğunu gösterir

githooks

Seçenek Tür Varsayılan Açıklama
commit boolean false blockstudio-githooks sync çalıştığında yalnızca analiz yapan bir ön işleme kancası oluşturur

Oluşturulan kancanın ne yaptığını ve nasıl güncel kaldığını öğrenmek için yönetilen commit kancası bölümüne bakın.

phpstan

Seçenek Tür Varsayılan Açıklama
preset string "base" Komut satırından seçilmemişse analiz ön ayarı: base, theme, extreme-theme veya wordpress-render
configuration string "" Ön ayarla birlikte dahil edilen, blockstudio.json konumundan çözümlenen proje PHPStan yapılandırması
roots array ["."] Kanonik komutun analiz ettiği tema kökleri
excludePaths array [] Yapılandırılmış her köke göre ek tarayıcı hariç tutmaları
maxFiles integer 10000 Tema tarayıcısının inceleyeceği azami dosya sayısı
blockTags object {} blok etiketi kuralı için öğe eşlemeleri, etiket takma adları ve scanPhp

Bu ayarlar kanonik blockstudio-phpstan komutunu yönlendirir. Ön ayarlar, katmanlar ve benimseme için PHPStan bölümüne bakın.

ai

Seçenek Tür Varsayılan Açıklama
enableContextGeneration boolean false LLM araçları için blokların, ayarların, şemaların ve belgelerin birleştirilmiş bağlam dosyasını oluşturur

Belge dizini ve oluşturulan metnin tamamı için AI Entegrasyonu bölümüne bakın.

UI Bileşenleri

7.3 sürümünde sunulan, paketle gelen başsız UI bileşenlerini etkinleştirin ve bir araya getirin. Blockstudio