İçeriğe geç

Öznitelikleri Filtreleme

Blockstudio, blok özniteliklerini filtrelemek için iki yöntem sunar.

Öznitelik Tanımları

blockstudio/blocks/attributes her alan tanımını filtrelerken Blockstudio bir blok oluşturup kaydeder. Bunu düzenleyici kontrollerini, varsayılanları, koşulları, seçenekleri ve oluşturma sırasında değerleri doğrulamak için kullanılan tanımı ayarlamak üzere kullanın.

PHP
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
  if (
    ($block['name'] ?? '') === 'my-theme/code-block' &&
    ($attribute['id'] ?? '') === 'lineNumbers'
  ) {
    $attribute['default'] = true;
    $attribute['conditions'] = [
      [
        [
          'id' => 'language',
          'operator' => '==',
          'value' => 'css'
        ]
      ]
    ];
  }

  return $attribute;
}, 10, 2);

Yukarıdaki kod, lineNumbers için varsayılan değeri true olarak ayarlar ve language, css olarak ayarlanmadığı sürece alanı gizler.

Geri çağırım, iç içe grup ve tekrarlayıcı alanları da dahil olmak üzere her çağrıda bir alan tanımı alır. Blok kaydı sırasında çalışır; her ön yüz oluşturmasında bir kez çalışmaz.

Filtrelenmiş seçenek tanımları, oluşturma öznitelik eşlemesinde de kullanılır. Örneğin, select, radio veya checkbox alanına eklenen bir seçenek düzenleyicide kullanılabilir ve Blockstudio bir şablon için kaydedilmiş değeri çözümlerken geçerliliğini korur:

PHP
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
  if (
    ($block['name'] ?? '') === 'bsui/button' &&
    ($attribute['id'] ?? '') === 'variant'
  ) {
    $attribute['options'][] = [
      'label' => 'Brand',
      'value' => 'brand',
    ];
  }

  return $attribute;
}, 10, 2);

Oluşturulan Değerler

blockstudio/blocks/attributes/render, tek bir alanın çözümlenmiş değerini blok şablonuna aktarılmadan hemen önce filtreler. Her alan için bir kez çalışır; bu nedenle geri çağırım bir değeri, alan anahtarını ve blok verilerini alır.

PHP
add_filter('blockstudio/blocks/attributes/render', function($value, $key, $block) {
  if (($block['name'] ?? '') === 'my-theme/code-block' && 'lineNumbers' === $key) {
    return true;
  }
  return $value;
}, 10, 3);

Yukarıdaki örnek, lineNumbers için düzenleyicide kaydedilmiş tüm değerleri geçersiz kılar. Geri çağırımı, add_filter öğesinin son bağımsız değişkeni olmak üzere, kabul edilen üç bağımsız değişkenle kaydedin; aksi takdirde WordPress yalnızca değeri aktarır.

  • $value: Şablonun $a[$key] olarak aldığı biçimde, alanın çözümlenmiş değeri. Şablona verilmesi gereken değeri döndürün.
  • $key: $a içinde kullanıldığı biçimiyle alanın anahtarı. Yinelenen bir satır içindeyse bu, satırdaki alanın kimliğidir.
  • $block: Şablonların $block veya $b olarak aldığı blok verisi dizisi; id, name, postId, postType, index, indexTotal, context ve ada bayraklarıyla birlikte. uzantıları, Blockstudio bloğu olmayan bir bloğa uygulandığında $block yalnızca blockstudio girdisini (attributes ve disabled) içerir ve name içermez.

Filtre, Blockstudio alanı olmayan özniteliklerde (örneğin className ve anchor) ve dosyalar alanının <id>__size eşlikçisinde de çalışır; bu nedenle bir değeri değiştirmeden önce $key değerini karşılaştırın. Döndürülen değer yalnızca $key değerini değiştirir; filtre, $a içine yeni anahtarlar ekleyemez.

Alan yapılandırmasını değiştirmek için tanım filtresini; bir istek için şablon değerlerini hesaplamak veya geçersiz kılmak için oluşturma filtresini kullanın.

Değerler, oluşturulmak yerine bs_block_values() üzerinden okunduğunda bu filtre, $block içinde yalnızca blok adını alır. Bu yardımcı tarafından oluşturma sayaçları ve yalnızca oluşturmaya özgü diğer meta veriler oluşturulmaz.