Lewati ke konten

Hook

Filter dan tindakan yang tersedia untuk menyesuaikan halaman, pola, Templat Situs, dan parser HTML.

Parser

blockstudio/block_tags/builders

Daftarkan builder array blok yang digunakan oleh tag blok dan blok kustom yang dipetakan ke elemen. Callback untuk setiap blok menerima array atribut dan konten bagian dalam mentah.

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 dan blockstudio/parser/renderers menerima registry yang sama. Keduanya berjalan setelah blockstudio/block_tags/builders, sesuai urutan tersebut, dan dapat menggantikan builder sebelumnya untuk blok yang sama.

blockstudio/parser/element_mapping

Ganti pemetaan elemen ke blok default HTML. Secara default, elemen HTML standar seperti <h1>, <p>, dan <img> dipetakan ke blok inti WordPress. Gunakan filter ini untuk mengarahkan elemen mana pun ke blok lain.

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 );

Jika <p> memetakan ke blok Blockstudio non-inti yang terdaftar dengan atribut richtext content, HTML bagian dalamnya disalin ke atribut tersebut, termasuk tag sebaris seperti code dan img yang juga dipetakan ke elemen. Paragraf yang hanya memiliki gambar sebagai anak akan menjadi blok yang dipetakan oleh <img>. Tag blok bertingkat atau HTML tingkat blok tetap mengikuti perilaku penguraian blok bagian dalam yang normal.

Halaman

blockstudio/pages/paths

Filter direktori yang dipindai untuk template halaman.

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

Filter usia maksimum cache manifes lama pra-7.6.2 yang dapat menjadi sumber runtime koleksi persisten selama pemutakhiran. Permintaan normal menggunakan konfigurasi koleksi persisten dan tidak memindai ulang akar halaman secara berkala. Jalankan wp bs pages sync atau panggil Blockstudio\Pages::reconcile() setelah mengubah manifes koleksi.

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

blockstudio/pages/create_post_data

Filter data kiriman sebelum membuat halaman baru.

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

Filter data kiriman sebelum memperbarui halaman yang sudah ada.

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

blockstudio/pages/synced

Tindakan dijalankan setelah semua halaman disinkronkan.

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

blockstudio/pages/post_created

Tindakan dijalankan setelah kiriman halaman dibuat.

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

blockstudio/pages/post_updated

Tindakan dijalankan setelah kiriman halaman diperbarui.

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

Pola

blockstudio/patterns/paths

Filter direktori yang dipindai untuk template pola.

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

blockstudio/patterns/registered

Tindakan dijalankan setelah semua pola didaftarkan.

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

Template Situs

blockstudio/site_templates/template_paths

Filter direktori yang dipindai untuk file 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

Filter direktori yang dipindai untuk file part.json.

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

blockstudio/site_templates/paths

Filter kedua daftar jalur penemuan sekaligus. Nilainya berisi array templates dan parts.

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

blockstudio/site_templates/template_candidates

Filter kandidat file sumber setelah manifes dan pohon sumber logis ditentukan.

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

Filter template lengkap yang dikembalikan oleh registry API.

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

blockstudio/site_templates/parts

Filter bagian template yang dikembalikan oleh registry API.

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

blockstudio/site_templates/template_content

Filter string sumber template sebelum Blockstudio mengurainya menjadi blok.

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

blockstudio/site_templates/part_content

Filter string sumber bagian template sebelum Blockstudio mengurainya menjadi blok.

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

blockstudio/site_templates/parser

Filter instans Blockstudio\Html_Parser yang digunakan untuk satu template atau bagian yang dikompilasi. Kembalikan Html_Parser; nilai lain akan menggunakan parser default.

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

blockstudio/site_templates/discovered

Tindakan dijalankan setelah proses penemuan dan kompilasi awal, sebelum registry yang dibangun ulang disimpan.

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

blockstudio/site_templates/registered

Tindakan dijalankan setelah registry template Site Editor berbasis file yang dibangun ulang disimpan.

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

Tindakan discovered dan registered tidak dijalankan saat cache registry hangat ditemukan.