Фільтрування атрибутів
Blockstudio надає два методи для фільтрування атрибутів блока.
Визначення атрибутів
blockstudio/blocks/attributes фільтрує визначення кожного поля, а Blockstudio створює та реєструє блок. Використовуйте його, щоб налаштувати елементи керування редактора, значення за замовчуванням, умови, параметри та визначення, яке використовується для перевірки значень під час відтворення.
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);
Наведений вище код задає для lineNumbers значення за замовчуванням true і приховує поле, якщо для language не встановлено значення css.
Під час кожного виклику зворотний виклик отримує визначення одного поля, зокрема вкладених полів групи та повторюваних полів. Він виконується під час реєстрації блока, а не під час кожного відтворення на зовнішній частині сайту.
Відфільтровані визначення параметрів також використовуються в мапі атрибутів відтворення. Наприклад, параметр, доданий до поля select, radio або checkbox, доступний у редакторі й залишається допустимим, коли Blockstudio визначає збережене значення для шаблону:
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);
Відтворені значення
blockstudio/blocks/attributes/render фільтрує розв’язане значення одного поля
безпосередньо перед передаванням у шаблон блоку. Він запускається для кожного поля, тому
зворотний виклик отримує значення, ключ поля та дані блоку.
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);
Наведений вище приклад замінює будь-яке значення, збережене в редакторі для lineNumbers.
Зареєструйте зворотний виклик із трьома прийнятими аргументами (останній аргумент
add_filter), інакше WordPress передає лише значення.
$value: розв’язане значення поля у форматі, який шаблон отримує як$a[$key]. Поверніть значення, яке має отримати шаблон.$key: ключ поля, як використовується в$a. Усередині рядка повторювача це ID поля в рядку.$block: масив даних блоку, який шаблони отримують як$blockабо$b, разом ізid,name,postId,postType,index,indexTotal,contextта прапорцями island. Для розширень Додаток, застосованих до блоку, який не є блоком Blockstudio,$blockмістить лише записblockstudio(attributesтаdisabled) і не маєname.
Фільтр також запускається для атрибутів, які не є полями Blockstudio, наприклад
className та anchor, а також для супутнього елемента <id>__size поля файлів,
тому перш ніж змінювати значення, порівняйте $key. Повернене значення замінює лише значення
$key; фільтр не може додавати нові ключі до $a.
Використовуйте фільтр визначення, щоб змінювати конфігурацію поля, а фільтр відображення — щоб обчислювати значення шаблону або перевизначати їх для запиту.
Коли значення читаються через bs_block_values(),
а не відображаються, цей фільтр отримує лише назву блоку в $block.
Лічильники та інші метадані, призначені лише для відображення, цей допоміжний засіб не створює.