تصفية السمات
يوفر 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. داخل صف مكرر، يكون هذا معرّف الحقل ضمن الصف.$block: مصفوفة بيانات الكتلة التي تتلقاها القوالب باعتبارها$blockأو$b، معidوnameوpostIdوpostTypeوindexوindexTotalوcontextوعلامات الجزيرة. بالنسبة إلى الامتدادات المطبّقة على كتلة ليست من نوع Blockstudio، لا يحتوي$blockإلا على إدخالblockstudio(attributesوdisabled)، ولا يتضمنname.
يُنفّذ المرشح أيضًا للسمات التي ليست حقول Blockstudio، مثل className وanchor، ولعنصر <id>__size المرافق لحقل الملفات، لذا تحقّق من $key قبل تغيير قيمة. وتستبدل القيمة المُعادة قيمة $key فقط؛ ولا يستطيع المرشح إضافة مفاتيح جديدة إلى $a.
استخدم مرشح التعريف عند تغيير إعدادات الحقل، ومرشح العرض عند حساب قيم القالب لطلب ما أو تجاوزها.
عند قراءة القيم عبر bs_block_values() بدلًا من عرضها، لا يتلقى هذا المرشح سوى اسم الكتلة في $block. لا تنشئ تلك الدالة المساعدة عدّادات العرض وغيرها من البيانات الوصفية الخاصة بالعرض فقط.