نقاط التوسعة
المرشحات والإجراءات المتاحة لتخصيص الصفحات والأنماط وقوالب الموقع ومحلّل HTML.
المحلّل
blockstudio/block_tags/builders
سجّل أدوات إنشاء مصفوفات الكتل التي تستخدمها وسوم الكتل والكتل المخصصة المعيّنة حسب العناصر. تتلقى دالة الاستدعاء لكل كتلة مصفوفة السمات والمحتوى الداخلي الخام.
add_filter( 'blockstudio/block_tags/builders', function( $builders, $parser ) {
$builders['acf/hero'] = function( array $attrs, string $inner_content ) {
$inner_blocks = Blockstudio\Block_Tags::parse_inner_blocks( $inner_content );
return array(
'blockName' => 'acf/hero',
'attrs' => $attrs,
'innerBlocks' => $inner_blocks,
'innerHTML' => '',
'innerContent' => array_fill( 0, count( $inner_blocks ), null ),
);
};
return $builders;
}, 10, 2 );
يتلقى blockstudio/block_tags/renderers وblockstudio/parser/renderers السجل نفسه. ويعملان بعد blockstudio/block_tags/builders، بهذا الترتيب، ويمكنهما استبدال أداة إنشاء سابقة للكتلة نفسها.
blockstudio/parser/element_mapping
تجاوز التعيين الافتراضي للعناصر HTML إلى الكتل. افتراضيًا، تُعيّن عناصر HTML القياسية مثل <h1> و<p> و<img> إلى كتل WordPress الأساسية. استخدم هذا المرشح لتوجيه أي عنصر إلى كتلة مختلفة.
add_filter( 'blockstudio/parser/element_mapping', function( $mapping ) {
$mapping['h1'] = 'custom/heading';
$mapping['h2'] = 'custom/heading';
$mapping['p'] = 'custom/paragraph';
$mapping['img'] = 'custom/image';
return $mapping;
}, 10, 2 );
إذا عيّن <p> عنصرًا إلى كتلة Blockstudio غير أساسية ومسجلة ولها سمة نص منسق content، يُنسخ محتواها الداخلي HTML إلى تلك السمة، بما في ذلك الوسوم المضمنة مثل code وimg التي عُيّنت أيضًا حسب العناصر. تصبح الفقرة التي لا تحتوي إلا على صورة هي الكتلة التي يعيّن إليها <img>. أما وسوم الكتل المتداخلة أو عناصر HTML على مستوى الكتلة فتحافظ على سلوك تحليل الكتل الداخلية المعتاد.
الصفحات
blockstudio/pages/paths
تصفية الأدلة التي تُفحص بحثًا عن قوالب الصفحات.
add_filter( 'blockstudio/pages/paths', function( $paths ) {
$paths[] = get_template_directory() . '/custom-pages';
$paths[] = MY_PLUGIN_DIR . '/pages';
return $paths;
} );
blockstudio/pages/manifest_scan_interval
تصفية الحد الأقصى لعمر ذاكرة التخزين المؤقت للبيان القديم قبل الإصدار 7.6.2، والتي يمكنها تهيئة بيئة تشغيل المجموعة المحفوظة أثناء الترقية. تستخدم الطلبات العادية إعدادات المجموعة المحفوظة ولا تعيد فحص جذور الصفحات دوريًا.
شغّل wp bs pages sync أو استدعِ Blockstudio\Pages::reconcile() بعد تغيير بيان المجموعة.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
تصفية بيانات المنشور قبل إنشاء صفحة جديدة.
add_filter( 'blockstudio/pages/create_post_data', function( $post_data, $page_data ) {
$post_data['post_author'] = 1;
return $post_data;
}, 10, 2 );
blockstudio/pages/update_post_data
تصفية بيانات المنشور قبل تحديث صفحة موجودة.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
يُنفّذ الإجراء بعد مزامنة جميع الصفحات.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
يُنفّذ الإجراء بعد إنشاء منشور صفحة.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
يُنفّذ الإجراء بعد تحديث منشور صفحة.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
الأنماط
blockstudio/patterns/paths
تصفية الأدلة التي تُفحص بحثًا عن قوالب الأنماط.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
يُنفّذ الإجراء بعد تسجيل جميع الأنماط.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
قوالب الموقع
blockstudio/site_templates/template_paths
تصفية الأدلة التي تُفحص بحثًا عن ملفات template.json.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
تصفية الأدلة التي تُفحص بحثًا عن ملفات part.json.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
تصفية قائمتي مسارات الاكتشاف معًا. تتضمن القيمة مصفوفتَي templates وparts.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
تصفية ملفات المصدر المرشحة بعد تحديد البيان وشجرة المصدر المنطقية.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
تصفية القوالب الكاملة التي يعيدها السجل API.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
تصفية أجزاء القوالب التي يعيدها السجل API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
تصفية سلسلة مصدر القالب قبل أن يحللها Blockstudio إلى كتل.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
تصفية سلسلة مصدر جزء القالب قبل أن يحللها Blockstudio إلى كتل.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
تصفية مثيل Blockstudio\Html_Parser المستخدم لقالب أو جزء مجمّع. أعد Html_Parser؛ وستستخدم القيم الأخرى المحلّل الافتراضي.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
يُنفَّذ الإجراء بعد مرور اكتشاف وتجميع بارد، وقبل حفظ السجل المُعاد بناؤه.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
يُنفَّذ الإجراء بعد حفظ سجل قوالب محرر الموقع المعاد بناؤه والمستند إلى الملفات.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
لا يُنفَّذ الإجراءان discovered وregistered عند إصابة ذاكرة التخزين المؤقت الدافئة للسجل.