Към съдържанието

Куки

Филтри и действия за персонализиране на страници, шаблони, шаблони на сайта и парсера 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 от тип richtext, вътрешното му съдържание 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 не се задействат при попадение в кеша на затопления регистър.