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:
{
"$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.
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:
- Yerleşik varsayılanlar
- Yönetici UI alanından kaydedilen ayarlar (
blockstudio_settingsseçeneği) - Temadaki
blockstudio.json 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:
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:
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:
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:
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.
{
"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
{
"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.
{
"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.
{
"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.
7.3 sürümünde sunulan, paketle gelen başsız UI bileşenlerini etkinleştirin ve bir araya getirin. Blockstudio