PHP Kancaları
Aşağıda, eklentinin işlevselliğini genişletmek veya uyarlamak için kullanabileceğiniz tüm PHP kancalarının listesini bulabilirsiniz.
Yol
Bu filtre, blok klasörünün yolunu ayarlamanızı sağlar. Varsayılan olarak bu yol, şu anda etkin olan temanın içinde blockstudio olur. Alternatif olarak birden fazla kaynak dizini için yeni bir örnek oluşturabilirsiniz.
add_filter('blockstudio/path', function() {
$path = get_stylesheet_directory() . '/blocks';
return $path;
});
Init
global
Bu eylem, eklenti tüm blokları kaydettikten sonra tetiklenir.
add_action('blockstudio/init', function($blocks) {
// All blocks have been registered
});
instance
Bu eylem, eklenti belirli bir örneğin tüm bloklarını kaydettikten sonra tetiklenir. $instance bölümü, wp-content konumuna göreli örnek yoludur.
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/$instance", function() {
// All blocks of this instance have been registered
});
global/before
Bu eylem, eklenti tüm blokları kaydetmeden önce tetiklenir.
add_action('blockstudio/init/before', function() {
// Before blocks are registered
});
global/before/$instance
Bu eylem, eklenti belirli bir örneğin tüm bloklarını kaydetmeden önce tetiklenir.
$instance = 'themes/my-theme/client-blocks';
add_action("blockstudio/init/before/$instance", function() {
// Before blocks of this instance are registered
});
Bloklar
render
Bu filtre, blok görüntülenmeden önce çıktısını ayarlamanızı sağlar.
add_filter('blockstudio/blocks/render', function($content, $block, $attributes) {
// Modify the block content
return $content;
}, 10, 3);
meta
Bu filtre, block.json dosyasının verilerini kaydedilmeden önce ayarlamanızı sağlar.
add_filter('blockstudio/blocks/meta', function($meta, $block) {
if (str_starts_with($block['name'], 'marketing')) {
$meta['icon'] = 'megaphone';
}
return $meta;
}, 10, 2);
Yukarıdaki kod, marketing ile başlayan tüm blokların simgesini değiştirir.
conditions
Bu filtre, bloklarda kullanılabilecek özel koşullar eklemenizi sağlar. Her koşul türü, düzenleyicinin koşulun value değeriyle karşılaştırdığı bir değere karşılık gelir. Bkz. Özel Koşullar.
add_filter('blockstudio/blocks/conditions', function($conditions) {
$conditions['myCustomCondition'] = 'expected';
return $conditions;
});
attributes
Bu filtre, blok kaydedilmeden önce tek bir alan tanımını ayarlar. Filtrelenmiş tanım, düzenleyici denetimini ve görüntüleme zamanındaki değer doğrulamasını belirler. Daha fazla bilgi için Filtreleme bölümüne bakın.
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
// Modify this field definition before registration.
return $attribute;
}, 10, 2);
attributes/render
Bu filtre, blok şablonuna iletilmeden önce bir alanın değerini ayarlar. Her alan için bir kez çalışır ve üç bağımsız değişken alır: $value (çözümlenen değer), $key ($a içinde kullanılan alan anahtarı) ve $block (şablonların $block veya $b olarak aldığı blok veri dizisi). Filtreyi üç kabul edilen bağımsız değişkenle kaydedin. Daha fazla bilgi için Filtreleme bölümüne bakın.
add_filter('blockstudio/blocks/attributes/render', function($value, $key, $block) {
// Modify the value of one field before rendering.
return $value;
}, 10, 3);
attributes/files/sizes
files alanı, her görseli sizes dizisiyle birlikte döndürür; bu dizi, full öğesinin ve kayıtlı her görsel boyutunun URL değerini, genişliğini ve yüksekliğini içerir; örneğin $image['sizes']['thumbnail'] ve $image['sizes']['thumbnail-width']. Her boyut, görsel başına bir wp_get_attachment_image_src() çağrısıdır; dolayısıyla filtreleri uygulanmaya devam eder. sizes değerini hiç okumayan şablonlar listeyi kaldırabilir veya kısaltabilir.
add_filter('blockstudio/blocks/attributes/files/sizes', function($sizes, $id, $size) {
// Keep only two sizes. Return an empty array to skip them, `sizes` is then null.
return ['full', 'large'];
}, 10, 3);
$sizes boyut adlarının listesidir; ilk sırada full bulunur (ara boyut kaydı yoksa liste boştur). $id ek dosya kimliğidir; $size ise değerin url için istenen boyuttur. Filtre, istekteki her files değerinin sizes dizisini değiştirir. Filtre kullanılmazsa dizi değişmeden kalır.
Boyut adlarını dizeler olarak döndürün. Geçersiz girdiler yok sayılır, yinelenen adlar bir kez çözümlenir ve dizi olmayan bir dönüş değeri boyutları atlar. İstenen url ve diğer ek özellikleri değişmeden kalır. Boyut eşlemesi oluşturmayan returnFormat: "url" içeren bir files alanı için bu kanca çalışmaz.
attributes/validate
Açık bs_validate_block() çağrılarının bulgularını ayarlayın; örneğin özel bir render filtresi depolanmış başvuruları çözümlerken. Bu, kaydetme veya render sırasında otomatik doğrulamayı etkinleştirmez.
add_filter('blockstudio/blocks/attributes/validate', function($findings, $name, $attrs) {
return $findings;
}, 10, 3);
Bir bulgu listesi döndürün. Blokta Blockstudio alanı veya eşleşen uzantılar (null) yoksa filtre çağrılmaz.
attributes/schema
Örneğin özel bir render filtresi kaydedilmiş referansları çözümlüyorsa, bs_block_schema() tarafından döndürülen JSON Şemasını ayarlayın.
add_filter('blockstudio/blocks/attributes/schema', function($schema, $name) {
return $schema;
}, 10, 2);
Şema dizisini döndürün. Blokta Blockstudio alanları veya eşleşen uzantılar (null) yoksa filtre çağrılmaz.
attributes/populate
Bu filtre, checkbox, select veya radio alanının seçeneklerine özel veriler eklemenizi sağlar. Daha fazla bilgi için Seçenekleri doldurma bölümüne bakın.
Filtre tek bir bağımsız değişken alır: "populate": {"type": "custom", "custom": "myCustomOptions"} içinde kullanılan ada göre anahtarlanmış tüm özel veri kümelerinin dizisi.
add_filter('blockstudio/blocks/attributes/populate', function($options) {
$options['myCustomOptions'] = [
['value' => '1', 'label' => 'Option 1'],
['value' => '2', 'label' => 'Option 2'],
];
return $options;
});
components/use_block_props/render
Bu filtre, useBlockProps içeriğinin çıktısını ayarlamanızı sağlar.
Tüm bileşen filtreleri (use_block_props, inner_blocks ve rich_text), son bağımsız değişkenleri olarak bloğu alır. $block, render edilen blok için kayıtlı WP_Block_Type olduğundan $block->name blok adıdır; örneğin acme/hero.
$props bir HTML öznitelikleri dizisidir, dizi değildir. Ön yüzde bu, get_block_wrapper_attributes() sonucudur; örneğin class="wp-block-acme-hero my-class". Düzenleyicide öğenin class özniteliğidir. Bir dize döndürün. Düzenleyicide döndürülen dizenin yalnızca class özniteliği uygulanır.
add_filter('blockstudio/blocks/components/use_block_props/render', function($props, $block) {
if ($block->name !== 'acme/hero') {
return $props;
}
return str_replace('class="', 'class="my-custom-class ', $props);
}, 10, 2);
components/inner_blocks/render
Bu filtre, <InnerBlocks /> içeriğinin çıktısını ayarlamanızı sağlar.
add_filter('blockstudio/blocks/components/inner_blocks/render', function($content, $block) {
return '<div class="inner-wrapper">' . $content . '</div>';
}, 10, 2);
components/inner_blocks/frontend/wrap
Bu filtre, <InnerBlocks /> sarmalayıcısını önyüzden kaldırmanızı sağlar.
add_filter('blockstudio/blocks/components/inner_blocks/frontend/wrap', function($wrap, $block) {
return false; // Remove wrapper
}, 10, 2);
components/rich_text/render
Bu filtre, <RichText /> içeriğinin çıktısını ayarlamanızı sağlar. Özniteliğin değerini ve bloğu alır.
add_filter('blockstudio/blocks/components/rich_text/render', function($content, $block) {
return wp_kses_post($content);
}, 10, 2);
Blok Etiketleri
blockstudio/block_tags/builders
Bu filtre, blok etiketleri ve blockstudio/parser/element_mapping aracılığıyla seçilen özel bloklar tarafından kullanılan blok dizisi oluşturucularını kaydeder. Her oluşturucu, ayrıştırılmış öznitelikleri ve ham içeriği alır.
add_filter('blockstudio/block_tags/builders', function($builders, $parser) {
$builders['theme/paragraph'] = function(array $attributes, string $inner) {
$attributes['content'] = trim($inner);
return [
'blockName' => 'theme/paragraph',
'attrs' => [
'blockstudio' => [
'attributes' => $attributes,
],
],
'innerBlocks' => [],
'innerHTML' => '',
'innerContent' => [],
];
};
return $builders;
}, 10, 2);
Uyumlu blockstudio/block_tags/renderers ve blockstudio/parser/renderers filtreleri bu kancadan sonra çalışır ve aynı blok adını geçersiz kılabilir.
blockstudio/block_tags/tag_aliases
Bu filtre, ham HTML yedeğine geçilmeden önce gerçek blok adlarına çözümlenen özel tireli yazım etiketlerini kaydetmenizi sağlar. Bir tema, standart Blockstudio veya çekirdek blokları işlerken projeye özgü kısa etiketler sunmak istediğinde kullanışlıdır.
add_filter('blockstudio/block_tags/tag_aliases', function($aliases) {
$aliases['theme-button'] = 'bsui/button';
$aliases['theme-card'] = 'theme/card';
return $aliases;
});
<theme-button href="/download" label="Download" />
<theme-card title="Fast authoring">
<p>Children are parsed as nested blocks.</p>
</theme-card>
blockstudio/block_tags/prefixes
Bu filtre, önek kısaltmalarını bir veya daha fazla blok ad alanına eşlemenizi sağlar. Her anahtar, tire içermeyen küçük harfli bir önektir. Her değer, bir ad alanı dizesi veya sıralı bir ad alanı listesi olabilir.
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
<theme-card title="Homepage" />
<theme-button label="Get started" />
<theme-ui-feature-matrix />
<theme-card>, theme-components/card olarak çözümlenir. <theme-button> önce theme-components/button için dener, ardından bsui/button yedeğine geçer. Aynı etiket için açık blockstudio/block_tags/tag_aliases girdileri önceliklidir ve çözümlenemeyen önekli etiketler değiştirilmeden bırakılır.
Önekler birleştirilebilir: Önekli bir etiket doğrudan çözümlenemez ve etiketteki kısa adın kendisi kayıtlı bir önek etiketi olursa çözümleme yinelemeli olarak sürer. theme => ['theme-components'] ve ui => ['bsui'] ile <theme-ui-input>, ui önekine düşer ve bsui/input olarak çözümlenir. Kayıtlı önek ve takma ad etiketleri yalnızca sayfa içeriğinde değil, blok şablonu çıktısında da işlenir.
Ayarlar
path
Bu filtre, blockstudio.json dosyasının yolunu ayarlamanıza olanak tanır. Varsayılan olarak bu, o anda etkin olan temanın içindeki blockstudio.json konumudur.
add_filter('blockstudio/settings/path', function() {
return get_stylesheet_directory() . '/config/blockstudio.json';
});
users/ids
Bu filtre, düzenleyiciyi belirli kullanıcı kimlikleri için etkinleştirmenizi sağlar.
add_filter('blockstudio/settings/users/ids', function() {
return [1];
});
users/roles
Bu filtre, düzenleyiciyi belirli kullanıcı rolleri için etkinleştirmenizi sağlar.
add_filter('blockstudio/settings/users/roles', function() {
return ['administrator', 'editor'];
});
assets/enqueue
Bu filtre, ön uçta ve düzenleyicide varlıkların kuyruğa eklenmesini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/assets/enqueue', function() {
return false;
});
assets/reset/enabled
Bu filtre, WordPress çekirdek blok stillerinin ve düzenleyici yardımcı düzen sıfırlamasının kaldırılmasını etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/assets/reset/enabled', function() {
return true;
});
assets/reset/full_width
Bu filtre, tam genişlikte düzenleme kullanan yazı türlerini belirlemenizi sağlar.
add_filter('blockstudio/settings/assets/reset/full_width', function() {
return ['page'];
});
assets/minify/css
Bu filtre, CSS küçültmesini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
assets/minify/js
Bu filtre, JS küçültmesini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
assets/process/scss
Bu filtre, .css dosyalarındaki SCSS işlemesini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
assets/process/scss_files
Bu filtre, .scss dosyalarının CSS biçiminde işlenmesini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/assets/process/scss_files', function() {
return true;
});
assets/output
Bu filtre, derlenmiş blok varlıklarının yazılacağı konumu belirlemenizi sağlar.
add_filter('blockstudio/settings/assets/output', function() {
return 'cache';
});
assets/inline_limit
Bu filtre, harici blok CSS verilerinin sayfa başına kaç baytının satır içine ekleneceğini denetlemenizi sağlar.
add_filter('blockstudio/settings/assets/inline_limit', function() {
return 40000;
});
cache/enabled
Bu filtre, dosya tabanlı tüm Blockstudio çalışma zamanı ve düzenleyici varlık önbelleklerini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/cache/enabled', function() {
return false;
});
cache/path
Bu filtre, Blockstudio dosya tabanlı önbellek dizinini değiştirmenizi sağlar.
add_filter('blockstudio/settings/cache/path', function() {
return 'cache/blockstudio';
});
cache/namespace_grace
Bu filtre, kullanımdan kaldırılmış bir önbellek ad alanının temizlenmeden önce ne kadar süre tutulacağını değiştirmenizi sağlar.
add_filter('blockstudio/settings/cache/namespace_grace', function() {
return 777600;
});
githooks/commit
Bu filtre, Blockstudio tarafından sahip olunan PHPStan kayıt kancasının etkin olup olmadığını bildirir.
add_filter('blockstudio/settings/githooks/commit', function() {
return true;
});
content/enabled
Bu filtre, İçerik Senkronizasyonunu etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/content/enabled', function() {
return true;
});
content/id
Bu filtre, İçerik Senkronizasyonu sahiplik ad alanını ayarlamanızı sağlar.
add_filter('blockstudio/settings/content/id', function() {
return 'docs';
});
content/path
Bu filtre, İçerik Senkronizasyonu dosya dizinini ayarlamanızı sağlar.
add_filter('blockstudio/settings/content/path', function() {
return 'content';
});
content/include_page_sync_managed
Bu filtre, Sayfa Senkronizasyonu tarafından yönetilen yazıları dahil etmenizi veya hariç tutmanızı sağlar.
add_filter('blockstudio/settings/content/include_page_sync_managed', function() {
return false;
});
content/authors
Bu filtre, İçerik Senkronizasyonu yazar işlemesini yapılandırmanızı sağlar.
add_filter('blockstudio/settings/content/authors', function() {
return 'ignore';
});
content/post_types
Bu filtre, İçerik Senkronizasyonu yazı türü izin listelerini yapılandırmanızı sağlar.
add_filter('blockstudio/settings/content/post_types', function() {
return ['team_member'];
});
content/taxonomies
Bu filtre, İçerik Senkronizasyonu taksonomi izin listelerini yapılandırmanızı sağlar.
add_filter('blockstudio/settings/content/taxonomies', function() {
return ['category', 'post_tag'];
});
content/media
Bu filtre, İçerik Senkronizasyonu medya işlemesini yapılandırmanızı sağlar.
add_filter('blockstudio/settings/content/media', function() {
return 'manifest';
});
tailwind/enabled
Bu filtre, Tailwind özelliğini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/tailwind/enabled', function() {
return true;
});
tailwind/config
Bu filtre, özel bir Tailwind CSS yapılandırması eklemenizi sağlar.
add_filter('blockstudio/settings/tailwind/config', function() {
return '@theme { --color-primary: pink; }';
});
tailwind/output
Bu filtre, Tailwind CSS çıktısının satır içi mi yoksa bağlantılı mı olacağını seçmenizi sağlar.
add_filter('blockstudio/settings/tailwind/output', function() {
return 'link';
});
ui/enabled
Bu filtre, paketlenmiş UI bileşenlerini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/ui/enabled', function() {
return true;
});
editor/format_on_save
Bu filtre, kaydetme sırasında kodun biçimlendirilmesini etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/editor/format_on_save', function() {
return true;
});
editor/assets
Bu filtre, düzenleyiciye ek varlıklar eklemenizi sağlar.
add_filter('blockstudio/settings/editor/assets', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
editor/markup
Bu filtre, düzenleyicinin sonuna ek biçimlendirme işaretlemesi eklemenizi sağlar.
add_filter('blockstudio/settings/editor/markup', function() {
return '<style>body { background: black; }</style>';
});
block_editor/disable_loading
Bu filtre, Blok Düzenleyici içindeki blokların yüklenmesini devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/block_editor/disable_loading', function() {
return true;
});
block_editor/enhance
Bu filtre, daha temiz odak stilleri ve üzerine gelme/seçim ana hatları gibi Blockstudio düzenleyici kullanım kolaylığı özelliklerini etkinleştirmenizi sağlar.
add_filter('blockstudio/settings/block_editor/enhance', function() {
return true;
});
block_editor/css_classes
Bu filtre, sınıf alanında seçilebilecek sınıfları içeren stil sayfalarını eklemenizi sağlar.
add_filter('blockstudio/settings/block_editor/css_classes', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
block_editor/css_variables
Bu filtre, kod alanında otomatik tamamlama için kullanılabilir CSS değişkenlerini içeren stil sayfalarını eklemenizi sağlar.
add_filter('blockstudio/settings/block_editor/css_variables', function() {
return ['my-stylesheet', 'another-stylesheet'];
});
block_editor/blocks/allow
Bu filtre, ekleyicide izin verilen blok adlarını denetlemenizi sağlar.
add_filter('blockstudio/settings/block_editor/blocks/allow', function() {
return ['core/*', 'acf/*', 'my-theme/*'];
});
block_editor/blocks/deny
Bu filtre, ekleyiciden blok adlarını kaldırmanızı sağlar.
add_filter('blockstudio/settings/block_editor/blocks/deny', function() {
return ['core/embed', 'core/freeform'];
});
block_editor/blocks/directory
Bu filtre, düzenleyicide WordPress blok dizini varlıklarını etkinleştirmenizi veya devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/block_editor/blocks/directory', function() {
return false;
});
block_editor/blocks/categories/allow
Bu filtre, kullanılabilir kalacak blok kategorisi kısa adlarını belirlemenizi sağlar.
add_filter('blockstudio/settings/block_editor/blocks/categories/allow', function() {
return ['text', 'media', 'design'];
});
block_editor/blocks/categories/deny
Bu filtre, ekleyiciden blok kategorisi kısa adlarını kaldırmanızı sağlar.
add_filter('blockstudio/settings/block_editor/blocks/categories/deny', function() {
return ['embed'];
});
block_editor/blocks/categories/rename
Bu filtre, blok kategorisi etiketlerini kısa adlarına göre yeniden adlandırmanızı sağlar.
add_filter('blockstudio/settings/block_editor/blocks/categories/rename', function() {
return [
'text' => 'Writing',
'design' => 'Layout'
];
});
block_editor/blocks/categories/order
Bu filtre, ekleyicide blok kategorisi kısa adlarının sırasını belirlemenizi sağlar.
add_filter('blockstudio/settings/block_editor/blocks/categories/order', function() {
return ['my-theme', 'text', 'media'];
});
block_editor/blocks/styles/deny
Bu filtre, blok adına göre PHP tarafından kaydedilmiş blok stillerinin kaydını silmenizi sağlar.
add_filter('blockstudio/settings/block_editor/blocks/styles/deny', function() {
return [
'my-theme/card' => ['outline'],
'my-theme/media' => ['framed']
];
});
block_editor/blocks/legacy_widgets/hide
Bu filtre, eski bileşenler bloğundan ek eski bileşenleri gizlemenizi sağlar.
add_filter('blockstudio/settings/block_editor/blocks/legacy_widgets/hide', function() {
return ['archives', 'calendar'];
});
block_editor/patterns/core
Bu filtre, WordPress çekirdek blok desenlerini etkinleştirmenizi veya devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/block_editor/patterns/core', function() {
return false;
});
block_editor/patterns/remote
Bu filtre, WordPress desen dizinindeki uzak desenleri etkinleştirmenizi veya devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/block_editor/patterns/remote', function() {
return false;
});
block_editor/patterns/theme
Bu filtre, tema tarafından sağlanan blok desenlerini etkinleştirmenizi veya devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/block_editor/patterns/theme', function() {
return false;
});
block_editor/patterns/blockstudio
Bu filtre, Blockstudio dosya tabanlı desenleri etkinleştirmenizi veya devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/block_editor/patterns/blockstudio', function() {
return false;
});
block_editor/patterns/categories/allow
Bu filtre, kullanılabilir kalacak desen kategorisi kısa adlarını belirlemenizi sağlar.
add_filter('blockstudio/settings/block_editor/patterns/categories/allow', function() {
return ['featured', 'buttons', 'columns'];
});
block_editor/patterns/categories/deny
Bu filtre, desen ekleyicisinden desen kategorisi kısa adlarını kaldırmanızı sağlar.
add_filter('blockstudio/settings/block_editor/patterns/categories/deny', function() {
return ['gallery'];
});
block_editor/patterns/categories/rename
Bu filtre, desen kategorisi etiketlerini kısa adlarına göre yeniden adlandırmanızı sağlar.
add_filter('blockstudio/settings/block_editor/patterns/categories/rename', function() {
return [
'featured' => 'Featured Layouts'
];
});
block_editor/patterns/categories/order
Bu filtre, ekleyicide desen kategorisi kısa adlarının sırasını belirlemenizi sağlar.
add_filter('blockstudio/settings/block_editor/patterns/categories/order', function() {
return ['featured', 'buttons'];
});
block_editor/media/openverse
Bu filtre, blok düzenleyici medya ekleyicisindeki Openverse medya kategorisini etkinleştirmenizi veya devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/block_editor/media/openverse', function() {
return false;
});
block_editor/media/image_sizes/allow
Bu filtre, düzenleyicinin medya denetimlerinde kullanılabilir kalacak görsel boyutu adlarını belirlemenizi sağlar.
add_filter('blockstudio/settings/block_editor/media/image_sizes/allow', function() {
return ['thumbnail', 'large'];
});
block_editor/media/image_sizes/deny
Bu filtre, düzenleyicinin medya denetimlerinden görsel boyutu adlarını kaldırmanızı sağlar.
add_filter('blockstudio/settings/block_editor/media/image_sizes/deny', function() {
return ['medium_large'];
});
ai/enable_context_generation
Bu filtre, LLM araç entegrasyonu için bağlam dosyası oluşturmayı etkinleştirmenizi veya devre dışı bırakmanızı sağlar. Etkinleştirildiğinde bağlam dosyası, güncel blok verilerini, mevcut kurulumun Blockstudio ayarlarını, ilgili tüm şemaları ve Blockstudio belgelerini bir araya getirerek yapay zekâ geliştirme araçlarında kullanılacak tek bir kaynak oluşturur.
add_filter('blockstudio/settings/ai/enable_context_generation', function() {
return true;
});
block_tags/enabled
Bu filtre, sayfa düzeyinde blok etiketi oluşturmayı etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/block_tags/enabled', function() {
return true;
});
block_tags/prefixes
Bu filtre, blok etiketleri için önek-ad alanı kısaltmalarını kaydetmenizi sağlar.
add_filter('blockstudio/settings/block_tags/prefixes', function() {
return [
'theme' => ['theme-components', 'bsui']
];
});
dev/grab/enabled
Bu filtre, öğe yakalayıcıyı etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/dev/grab/enabled', function() {
return false;
});
dev/perf
Bu filtre, performans profil oluşturucuyu etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/dev/perf', function() {
return false;
});
dev/canvas/enabled
Bu filtre, tuvali etkinleştirmenizi/devre dışı bırakmanızı sağlar.
add_filter('blockstudio/settings/dev/canvas/enabled', function() {
return false;
});
dev/canvas/admin_bar
Bu filtre, tuvalde WordPress yönetici çubuğunu gösterip gizlemenizi sağlar.
add_filter('blockstudio/settings/dev/canvas/admin_bar', function() {
return true;
});
WPML
blockstudio/wpml/config/label
wp bs wpml config tarafından yazılan her anahtarın etiketini filtreler. Bağlam dizisi için Etiketleri değiştirme bölümüne bakın.
add_filter('blockstudio/wpml/config/label', function($label, $context) {
return str_replace(' (optional)', '', $label);
}, 10, 2);
Tuval
blockstudio/canvas/inventory
Bu filtre, bir seçim için Tuval’in bildirdiği envanteri düzenler. Geri çağırım, envanter DTO’sunu, özgün seçimi ve çağrıldığı seçenekleri alır.
add_filter('blockstudio/canvas/inventory', function(array $result, array $selection, array $options) {
return $result;
}, 10, 3);
blockstudio/canvas/documents
Bu filtre, Tuval’in döndürdüğü işlenmiş belgeleri düzenler; envanter filtresiyle aynı üç bağımsız değişkeni alır.
blockstudio/canvas/item_loaded
Bu eylem, yüklenen her envanter kaydı için bir kez tetiklenir ve envanter türünü, standart kayıt kimliğini ve normalleştirilmiş kaydı alır.
blockstudio/canvas/source_compiled
Bu eylem, Canvas için bir kaynak dosya derlendikten sonra tetiklenir ve seçilen kaynak yolunu ve standart kaynak kaydını alır.
Paketlenmiş UI
blockstudio/ui/directories
Bu filtre, paketlenmiş UI bileşenleri için taranan dizinleri düzenler.
blockstudio/ui/inventory
Bu filtre, herkese açık UI aile envanterini düzenler.
blockstudio/ui/examples
Bu filtre, örnekleri ve türetildikleri herkese açık UI envanterini alarak UI örnek kayıtlarını düzenler.
Topoloji
blockstudio/blocks/topology_refreshed
Bu eylem, blok topolojisi yeniden oluşturulduktan sonra tetiklenir.
blockstudio/pages/topology_refreshed
Bu eylem, sayfa topolojisi yeniden oluşturulduktan sonra tetiklenir.
blockstudio/pages/layout_error
Bu eylem, bir sayfa düzeni sessizce başarısız olmak yerine işlenemediğinde tetiklenir.
Çalışma Zamanı
blockstudio/runtime/initialized
Bu eylem, çalışma zamanı yapılandırmasını çözdükten sonra tetiklenir.
blockstudio/runtime/changed
Bu eylem, çözümlenmiş çalışma zamanı kimliği değiştiğinde tetiklenir; bu değişiklik önbellek ad alanlarını ve statik önceden işlenmiş durumu taşır.
blockstudio/performance/default_config
Bu filtre, bir projenin kendi blockstudio.json değerleri üzerine eklenmeden önce performans varsayılanlarını düzenler.
İçerik
blockstudio/content/orphan_action
Bu filtre, artık bir kaynağı olmayan kayıt için içerik senkronizasyonunun ne yapacağına karar verir.
Bootstrap
blockstudio/url
Bu filtre, Blockstudio düzenleyici ve yönetici varlıkları için kullanılan herkese açık URL değerini değiştirir. Composer entegrasyonları, Blockstudio otomatik yükleyici dosyasını yüklemeden önce bu değeri kaydetmelidir. İkinci bağımsız değişken fiziksel paket dizinidir.
add_filter(
'blockstudio/url',
function(string $url, string $directory) {
return get_stylesheet_directory_uri() . '/vendor/blockstudio/blockstudio/';
},
10,
2
);
Çalışma Zamanı Önbelleği
blockstudio/cache/dir
Bu filtre, çalışma zamanı, düzenleyici varlıkları veya başka bir önbellek kapsamı eklenmeden önce çözümlenmiş temel önbellek dizinini alır.
add_filter('blockstudio/cache/dir', function(string $directory) {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
blockstudio/cache/context
Bu filtre, önbellek kimliklerine serileştirilebilir bir çalışma zamanı varyantı ekler. Aynı keşif kaynağının farklı mantıksal envanterler seçebildiği durumlarda kullanın.
add_filter('blockstudio/cache/context', function($context, string $scope) {
return [
'preview' => get_query_var('preview_id'),
'site' => get_current_blog_id(),
];
}, 10, 2);
blockstudio/cache/site_key
Bu filtre, kendi kiracı sınırlarına sahip barındırma ortamları için ağ/blog dizini kimliğini değiştirir. Döndürülen değer kullanılmadan önce temizlenir.
add_filter(
'blockstudio/cache/site_key',
function(string $key, int $networkId, int $blogId) {
return sprintf('tenant-%d-%d', $networkId, $blogId);
},
10,
3
);
blockstudio/runtime/identity
Bu filtre, çalışma zamanı kapsamındaki her nesneyi etkileyen barındırma ortamı bilgilerini ekler. Öğeye özgü kaynak parmak izleri bunun yerine, sahibi olan API tarafından açık bağımlılıklar olarak geçirilmelidir.
add_filter(
'blockstudio/runtime/identity',
function(array $identity, string $scope) {
$identity['deployment'] = getenv('RELEASE_SHA') ?: 'local';
return $identity;
},
10,
2
);
blockstudio/cache/watch_debounce
Geçerli bir dosya izleme anlık görüntüsünün, başka bir dosya sistemi stat denetimi yapılmadan yeniden kullanılabileceği saniye sayısını filtreler. Varsayılan değer yerel ve geliştirme ortamlarında 0, diğer ortamlarda 20 olur.
add_filter('blockstudio/cache/watch_debounce', function() {
return 30;
});
blockstudio/cache/build_wait_budget
Bir isteğin, çalışma zamanı önbelleğini veya doldurulmuş seçenek yenilemesini yayımlayacak eşzamanlı oluşturucuyu bekleyip hizmet düzeyini düşürmesine kadar geçen süreyi milisaniye cinsinden filtreler. Yapısal yeniden oluşturmalarda varsayılan değer 5000, seçenek yenilemelerinde 4000 olur.
add_filter('blockstudio/cache/build_wait_budget', function() {
return 2000;
});
blockstudio/cache/populate_debounce
İçerik, terim, kullanıcı veya meta yazma işlemlerinin ani yoğunluğunun tek bir doldurulmuş seçenek yenilemesinde birleştirileceği saniye sayısını filtreler. Sakin bir dönemden sonraki ilk yazma işlemi hemen yenileme yapar; yoğunluğun son yazma işlemi ise süre dolduktan sonra yansıtılır. Varsayılan değer 30. Her yazma işleminde yenilemek için 0 döndürün.
add_filter('blockstudio/cache/populate_debounce', function() {
return 120;
});
blockstudio/cache/populate_ignored_meta_keys
Yazıldığında doldurulmuş seçenekleri hiçbir zaman yenilemeyen meta anahtarlarını filtreler. Varsayılan olarak bunlar, WordPress tarafından düzenleme ve oturum açma kayıtları için yazılan anahtarlardır: bir gönderi açıkken düzenleyici ve Heartbeat tarafından yenilenen _edit_lock, yenilemenin zaten yapıldığı gönderi kaydının yanında yazılan _edit_last ve oturum açma ile kapatma sırasında yazılan session_tokens. Sık değişen ancak doldurma sorgusunu hiçbir zaman etkilemeyen anahtarları ekleyin.
add_filter('blockstudio/cache/populate_ignored_meta_keys', function(array $keys) {
$keys[] = '_my_view_counter';
return $keys;
});
blockstudio/cache/max_files_per_scope
Her çalışma zamanı önbelleği kapsamının tutacağı yayımlanmış yük sayısını filtreler.
add_filter('blockstudio/cache/max_files_per_scope', function($maximum, $scope) {
return $scope === 'runtime' ? 50 : $maximum;
}, 10, 2);
blockstudio/cache/compress
Önbellek yükünün düz PHP dizisi yerine sıkıştırılmış serileştirilmiş veri kullanıp kullanmayacağını filtreler. Varsayılan olarak yalnızca 1 MiB’a kadar olan yükler düz biçimi kullanır ve bunu da yalnızca etkin OPcache paylaşılan belleği hedef dosyayı önbelleğe alabiliyorsa yapar. Diğer işlemler, hariç tutulan dosyalar ve daha büyük yükler sıkıştırma kullanır.
add_filter('blockstudio/cache/compress', function($compress, $scope) {
return $scope === 'runtime' ? false : $compress;
}, 10, 2);
false döndürmek boyut sınırını da geçersiz kılar. Bu, WP-CLI, opcache.enable_cli olmadan OPcache etkin web çalışanları için dosyaları önceden ısıttığında yararlı olabilir; ancak OPcache kullanmayan her okuyucu oluşturulan diziyi ayrıştırır. Bu ek bellek maliyeti kabul edilebilir değilse büyük paylaşılan yüklerde sıkıştırmayı kullanın. Varsayılan güvenlik önlemleri için önbellek yükü biçimleri bölümüne bakın.
blockstudio/cache/protected_paths
Önbellek yolu saklama temizliği bunları asla kaldırmamalıdır. Blockstudio, kurulu erken sunum eşlemesinin başvurduğu tüm dosyaları ekleyerek bu listeyi doldurur.
add_filter('blockstudio/cache/protected_paths', function(array $paths, string $scope, string $directory) {
if ('static-prerender' === $scope) {
$paths[] = $directory . '/pinned.html';
}
return $paths;
}, 10, 3);
blockstudio/cache/outcome
Bu eylem, hit, build, miss-stale, stale-last-good veya write-failure gibi ortak bir önbellek kapsamını ve sonucunu bildirir.
add_action('blockstudio/cache/outcome', function(string $scope, string $reason) {
my_metrics()->increment("blockstudio.cache.{$scope}.{$reason}");
}, 10, 2);
blockstudio/static_prerender/request_bypass
Bu filtre, anonim güvenlik kararını sunucu ve çerez girdileriyle birlikte alır. true döndürülmesi statik sunumu ve oluşturmayı her zaman atlar.
add_filter(
'blockstudio/static_prerender/request_bypass',
function(bool $bypass, array $server, array $cookies) {
return $bypass || isset($cookies['commerce_session']);
},
10,
3
);
blockstudio/static_prerender/public_urls
Bu filtre, zamanlanmış ısıtıcı ve açık grafik araçlarında kullanılan eksiksiz herkese açık URL envanterini sağlar veya düzenler.
add_filter('blockstudio/static_prerender/public_urls', function(array $urls) {
$urls[] = home_url('/custom-route/');
return array_values(array_unique($urls));
});
Filtrenin döndürdüğü değer nihai envanter değildir. Sonuç, yapılandırılmış dinamik bir yolla eşleşen veya varsayılan olarak atlanan tüm öğeleri çıkaran bir önbelleğe alınabilirlik denetiminden geçirilir: /wp-admin, /wp-json, /wp-login.php, /xmlrpc.php, /feed/ içeren tüm yollar ve sitenin ana yolundaki arama tabanının altındaki arama sonuçları (varsayılan olarak /search/). Bu nedenle eklediğiniz bir URL uyarı verilmeksizin elenebilir. Oluşturulan envanterde beklediğiniz bir yol yoksa filtrenin çalışmadığını varsaymadan önce bu kurallara göre kontrol edin.
blockstudio/static_prerender/render_internal
Bu filtre, isteğe bağlı işlem içi toplu aktarımı uygular. Normalleştirilmiş bir sonuç dizisi döndürün veya oluşturucunun yapılandırılmış HTTP yedeğini kullanmasına izin vermek için değeri değiştirmeden bırakın. Sonuç, html ve isteğe bağlı olarak status, dependencies, virtualHashes ve headers değerlerini taşır; performance.staticPrerender.replayHeaders içinde belirtilen başlıklar belgeyle birlikte saklanır.
add_filter(
'blockstudio/static_prerender/render_internal',
function($result, string $url, array $options) {
return my_static_renderer()->render($url, $options);
},
10,
3
);
blockstudio/static_prerender/cacheable_html
Bu filtre, Blockstudio çıktının önbelleğe alınmayan işaretçisi olmayan eksiksiz bir HTML belgesi olduğunu ve gözlemlenen yanıt durumunun başarılı olduğunu doğruladıktan sonra nihai kararı verir. Üçüncü bağımsız değişken, gözlemlenen durumdur veya durum belirtilmemişse null değeridir.
add_filter('blockstudio/static_prerender/cacheable_html', function(bool $cacheable, string $html, ?int $status) {
return $cacheable && !str_contains($html, 'data-personalized');
}, 10, 3);
blockstudio/static_prerender/outcome
Bu eylem; isabet, isabetsizlik, yazma, grafik yazma, eski kayıt ve hata gibi statik önceden işleme sonuçlarını bildirir.
add_action('blockstudio/static_prerender/outcome', function(string $reason) {
my_metrics()->increment("blockstudio.prerender.{$reason}");
});
blockstudio/tailwind/cache_max_files
Derlenmiş Tailwind CSS girdilerinin azami sayısını filtreler. Varsayılan değer 1000 olur.
add_filter('blockstudio/tailwind/cache_max_files', function() {
return 1500;
});
blockstudio/tailwind/cache_max_age
Derlenmiş Tailwind CSS girdilerinin saniye cinsinden azami yaşını filtreler. Varsayılan değer 30 gün, en düşük değer bir saattir.
add_filter('blockstudio/tailwind/cache_max_age', function() {
return 14 * DAY_IN_SECONDS;
});
Yönetici
enabled
Bu filtre, Araçlar > Blockstudio altındaki Blockstudio yönetici sayfasını etkinleştirmenizi veya devre dışı bırakmanızı sağlar.
add_filter('blockstudio/admin/enabled', function() {
return false;
});
Varlıklar
editor/canvas/body_class
Varlık sıfırlama etkin olduğunda bu filtre, blok düzenleyici tuvaline kopyalanan temizlenmiş ön uç gövde sınıflarını düzenler.
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});
enable
Bu filtre, belirli bir varlık türünün işlenmesini ve kuyruğa eklenmesini devre dışı bırakmanızı sağlar.
add_filter('blockstudio/assets/enable', function($enable, $type, $block) {
if ($type === 'css' && $block['name'] === 'my/block') {
return false;
}
return $enable;
}, 10, 3);
disable
Bu filtre, varlıkları kimliklerine göre devre dışı bırakmanızı sağlar. Döndürülen dizideki bir kimlikle eşleşen varlıklar ön yüzde işlenmez.
add_filter('blockstudio/assets/disable', function($disabled) {
$disabled[] = 'my-block-style';
return $disabled;
});
process/scss/import_paths
Bu filtre, SCSS derleyicisinin @import ifadesine ek yollar eklemenizi sağlar.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_stylesheet_directory() . '/scss';
return $paths;
});
process/scss/prelude
Bu filtre, her SCSS dosyası derlenmeden önce ortak Sass kodunu başa eklemenizi sağlar.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
process/css/content
Bu filtre, derlenmeden önce CSS dosyasının içeriğini düzenlemenizi sağlar.
add_filter('blockstudio/assets/process/css/content', function($content, $block) {
return str_replace('old-class', 'new-class', $content);
}, 10, 2);
process/js/content
Bu filtre, derlenmeden önce JS dosyasının içeriğini düzenlemenizi sağlar.
add_filter('blockstudio/assets/process/js/content', function($content, $block) {
return $content;
}, 10, 2);
Arabellek
enabled
Blockstudio, ön uç yanıtını arabelleğe alır; böylece gövde içinde işlenen blok stili ve betik etiketleri üst bilgiye ve alt bilgiye taşınabilir, ayrıca Tailwind belgenin tamamını tarayabilir. Arabelleğe alma, her ön uç isteğinde belgenin tamamını tutup taramak anlamına gelir; hiçbir Blockstudio blok varlığı oluşturmayan ve Tailwind kullanmayan bir site, her ikisini de atlamak için false döndürebilir.
add_filter('blockstudio/buffer/enabled', '__return_false');
Yönetici alanında ve Özelleştirici önizlemesinde de arabelleğe alma kapalıdır. Geçerli yanıtın arabelleğe alınıp alınmadığını öğrenmek için bs_is_buffering() işlevini wp_enqueue_scripts veya sonrasında çağırın. template_redirect noktasında karar verilmeden önce false değerini döndürür.
output
Bu filtre, gönderilmeden önce arabelleğe alınmış HTML belgesinin tamamını alır. Blockstudio kendi varlık taşıma işlemini 1000000 önceliğinde, Tailwind derlemesini ise 999999 önceliğinde çalıştırır. Bu işlemlerden önceki belgeyi görmek için daha erken, nihai çıktıyı görmek için daha geç çalıştırın.
add_filter('blockstudio/buffer/output', function(string $html) {
return $html;
}, 2000000);
İşleme
dependencies
Bu filtre, Blockstudio bir bloğu her işlediğinde seçilen şablonu ve varlık bağımlılıklarını bildirir. Statik dışa aktarıcılar ve işlem içi diğer bağımlılık toplayıcılar için kullanışlıdır.
add_filter(
'blockstudio/render/dependencies',
function($paths, $name, $block, $isEditor, $isPreview) {
my_dependency_graph()->add($name, $paths);
return $paths;
},
10,
5
);
global
Bu filtre, işlenmeden önce sayfanın çıktısını düzenlemenizi sağlar.
add_filter('blockstudio/render', function($content) {
return $content;
});
head
Bu filtre, <head> etiketinin render edilmeden önceki çıktısını ayarlamanızı sağlar. Yalnızca Blockstudio yanıtı arabelleğe aldığında çalışır; bkz. bs_is_buffering().
add_filter('blockstudio/render/head', function($content) {
return $content . '<meta name="custom" content="value">';
});
footer
Bu filtre, işlenmeden önce </body> çıktısını düzenlemenizi sağlar.
add_filter('blockstudio/render/footer', function($content) {
return $content . '<script>console.log("loaded")</script>';
});
Hata İşleme
error/logged
Bir hata günlüğe kaydedildikten sonra tetiklenen eylem. Hataları harici günlük kaydı hizmetlerine göndermek için kullanın.
add_action('blockstudio/error/logged', function($message, $level, $context) {
if ($level === 'error') {
my_external_logger($message, $context);
}
}, 10, 3);
error/exception
Bir istisna işlendikten sonra tetiklenen eylem.
add_action('blockstudio/error/exception', function($exception, $context) {
my_error_tracker($exception);
}, 10, 2);
Veritabanı
Tüm veritabanı kancaları tek bir $params dizisi alır.
db/before_create
Bir kayıt oluşturulmadan önce tetiklenen eylem.
add_action('blockstudio/db/before_create', function($params) {
// $params: block, schema, data, storage
});
db/after_create
Bir kayıt oluşturulduktan sonra tetiklenen eylem.
add_action('blockstudio/db/after_create', function($params) {
// $params: block, schema, record, storage
wp_mail($params['record']['email'], 'Welcome!', 'Thanks for subscribing.');
});
db/before_update
Bir kayıt güncellenmeden önce tetiklenen eylem.
add_action('blockstudio/db/before_update', function($params) {
// $params: block, schema, id, data, storage
});
db/after_update
Bir kayıt güncellendikten sonra tetiklenen eylem.
add_action('blockstudio/db/after_update', function($params) {
// $params: block, schema, id, record, storage
});
db/before_delete
Bir kayıt silinmeden önce tetiklenen eylem.
add_action('blockstudio/db/before_delete', function($params) {
// $params: block, schema, id, storage
});
db/after_delete
Bir kayıt silindikten sonra tetiklenen eylem.
add_action('blockstudio/db/after_delete', function($params) {
// $params: block, schema, id, storage
});
RPC
Tüm RPC kancaları tek bir $params dizisi alır.
rpc/before_call
Bir RPC işlevi çağrılmadan önce tetiklenen eylem.
add_action('blockstudio/rpc/before_call', function($params) {
// $params: block, function, params
});
rpc/after_call
Bir RPC işlevi çağrıldıktan sonra tetiklenen eylem.
add_action('blockstudio/rpc/after_call', function($params) {
// $params: block, function, params, result
});