Ö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.
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:
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.
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:$aiçinde kullanıldığı biçimiyle alanın anahtarı. Yinelenen bir satır içindeyse bu, satırdaki alanın kimliğidir.$block: Şablonların$blockveya$bolarak aldığı blok verisi dizisi;id,name,postId,postType,index,indexTotal,contextve ada bayraklarıyla birlikte. uzantıları, Blockstudio bloğu olmayan bir bloğa uygulandığında$blockyalnızcablockstudiogirdisini (attributesvedisabled) içerir venameiç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.