İçeriğe geç

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.

PHP
add_filter('blockstudio/path', function() {
  $path = get_stylesheet_directory() . '/blocks';
  return $path;
});

Init

global

Bu eylem, eklenti tüm blokları kaydettikten sonra tetiklenir.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

PHP
add_filter('blockstudio/block_tags/tag_aliases', function($aliases) {
  $aliases['theme-button'] = 'bsui/button';
  $aliases['theme-card'] = 'theme/card';

  return $aliases;
});
HTML
<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.

PHP
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});
HTML
<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.

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

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

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

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

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

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

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

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

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

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

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

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

PHP
add_filter('blockstudio/settings/cache/enabled', function() {
  return false;
});

cache/path

Bu filtre, Blockstudio dosya tabanlı önbellek dizinini değiştirmenizi sağlar.

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

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

PHP
add_filter('blockstudio/settings/githooks/commit', function() {
  return true;
});

content/enabled

Bu filtre, İçerik Senkronizasyonunu etkinleştirmenizi/devre dışı bırakmanızı sağlar.

PHP
add_filter('blockstudio/settings/content/enabled', function() {
  return true;
});

content/id

Bu filtre, İçerik Senkronizasyonu sahiplik ad alanını ayarlamanızı sağlar.

PHP
add_filter('blockstudio/settings/content/id', function() {
  return 'docs';
});

content/path

Bu filtre, İçerik Senkronizasyonu dosya dizinini ayarlamanızı sağlar.

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

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

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

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

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

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

PHP
add_filter('blockstudio/settings/tailwind/enabled', function() {
  return true;
});

tailwind/config

Bu filtre, özel bir Tailwind CSS yapılandırması eklemenizi sağlar.

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

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

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

PHP
add_filter('blockstudio/settings/editor/format_on_save', function() {
  return true;
});

editor/assets

Bu filtre, düzenleyiciye ek varlıklar eklemenizi sağlar.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

PHP
add_filter('blockstudio/settings/dev/perf', function() {
  return false;
});

dev/canvas/enabled

Bu filtre, tuvali etkinleştirmenizi/devre dışı bırakmanızı sağlar.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

PHP
add_filter('blockstudio/render', function($content) {
  return $content;
});

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().

PHP
add_filter('blockstudio/render/head', function($content) {
  return $content . '<meta name="custom" content="value">';
});

Bu filtre, işlenmeden önce </body> çıktısını düzenlemenizi sağlar.

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

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

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

PHP
add_action('blockstudio/db/before_create', function($params) {
  // $params: block, schema, data, storage
});

db/after_create

Bir kayıt oluşturulduktan sonra tetiklenen eylem.

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

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

PHP
add_action('blockstudio/db/after_update', function($params) {
  // $params: block, schema, id, record, storage
});

db/before_delete

Bir kayıt silinmeden önce tetiklenen eylem.

PHP
add_action('blockstudio/db/before_delete', function($params) {
  // $params: block, schema, id, storage
});

db/after_delete

Bir kayıt silindikten sonra tetiklenen eylem.

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

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

PHP
add_action('blockstudio/rpc/after_call', function($params) {
  // $params: block, function, params, result
});