انتقل إلى المحتوى

نقاط التوسعة

المرشحات والإجراءات المتاحة لتخصيص الصفحات والأنماط وقوالب الموقع ومحلّل HTML.

المحلّل

blockstudio/block_tags/builders

سجّل أدوات إنشاء مصفوفات الكتل التي تستخدمها وسوم الكتل والكتل المخصصة المعيّنة حسب العناصر. تتلقى دالة الاستدعاء لكل كتلة مصفوفة السمات والمحتوى الداخلي الخام.

PHP
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 الأساسية. استخدم هذا المرشح لتوجيه أي عنصر إلى كتلة مختلفة.

PHP
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

تصفية الأدلة التي تُفحص بحثًا عن قوالب الصفحات.

PHP
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() بعد تغيير بيان المجموعة.

PHP
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
    return 10;
} );

blockstudio/pages/create_post_data

تصفية بيانات المنشور قبل إنشاء صفحة جديدة.

PHP
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

تصفية بيانات المنشور قبل تحديث صفحة موجودة.

PHP
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
    return $post_data;
}, 10, 3 );

blockstudio/pages/synced

يُنفّذ الإجراء بعد مزامنة جميع الصفحات.

PHP
add_action( 'blockstudio/pages/synced', function( $registry ) {
    // $registry is the Page_Registry instance
} );

blockstudio/pages/post_created

يُنفّذ الإجراء بعد إنشاء منشور صفحة.

PHP
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
    // Do something after page creation
}, 10, 2 );

blockstudio/pages/post_updated

يُنفّذ الإجراء بعد تحديث منشور صفحة.

PHP
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
    // Do something after page update
}, 10, 2 );

الأنماط

blockstudio/patterns/paths

تصفية الأدلة التي تُفحص بحثًا عن قوالب الأنماط.

PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/custom-patterns';
    $paths[] = MY_PLUGIN_PATH . '/patterns';
    return $paths;
} );

blockstudio/patterns/registered

يُنفّذ الإجراء بعد تسجيل جميع الأنماط.

PHP
add_action( 'blockstudio/patterns/registered', function( $registry ) {
    // $registry is the Pattern_Registry instance
} );

قوالب الموقع

blockstudio/site_templates/template_paths

تصفية الأدلة التي تُفحص بحثًا عن ملفات template.json.

PHP
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/site-templates';
    return $paths;
} );

blockstudio/site_templates/part_paths

تصفية الأدلة التي تُفحص بحثًا عن ملفات part.json.

PHP
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/site-parts';
    return $paths;
} );

blockstudio/site_templates/paths

تصفية قائمتي مسارات الاكتشاف معًا. تتضمن القيمة مصفوفتَي templates وparts.

PHP
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
    return $paths;
} );

blockstudio/site_templates/template_candidates

تصفية ملفات المصدر المرشحة بعد تحديد البيان وشجرة المصدر المنطقية.

PHP
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.

PHP
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
    return $templates;
} );

blockstudio/site_templates/parts

تصفية أجزاء القوالب التي يعيدها السجل API.

PHP
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
    return $parts;
} );

blockstudio/site_templates/template_content

تصفية سلسلة مصدر القالب قبل أن يحللها Blockstudio إلى كتل.

PHP
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
    return $content;
}, 10, 2 );

blockstudio/site_templates/part_content

تصفية سلسلة مصدر جزء القالب قبل أن يحللها Blockstudio إلى كتل.

PHP
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
    return $content;
}, 10, 2 );

blockstudio/site_templates/parser

تصفية مثيل Blockstudio\Html_Parser المستخدم لقالب أو جزء مجمّع. أعد Html_Parser؛ وستستخدم القيم الأخرى المحلّل الافتراضي.

PHP
add_filter(
    'blockstudio/site_templates/parser',
    function( $parser, $item ) {
        return $parser;
    },
    10,
    2
);

blockstudio/site_templates/discovered

يُنفَّذ الإجراء بعد مرور اكتشاف وتجميع بارد، وقبل حفظ السجل المُعاد بناؤه.

PHP
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
    // Inspect the rebuilt Site_Template_Registry.
} );

blockstudio/site_templates/registered

يُنفَّذ الإجراء بعد حفظ سجل قوالب محرر الموقع المعاد بناؤه والمستند إلى الملفات.

PHP
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
    // $registry is the Site_Template_Registry instance
} );

لا يُنفَّذ الإجراءان discovered وregistered عند إصابة ذاكرة التخزين المؤقت الدافئة للسجل.