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.
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.
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.
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.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Filter data kiriman sebelum membuat halaman baru.
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.
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.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Tindakan dijalankan setelah kiriman halaman dibuat.
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.
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.
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.
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.
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.
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.
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.
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.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Filter bagian template yang dikembalikan oleh registry API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Filter string sumber template sebelum Blockstudio mengurainya menjadi blok.
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.
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.
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.
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.
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.