Āķi
Filtri un darbības lapu, rakstu, vietnes veidņu un HTML parsētāja pielāgošanai.
Parsētājs
blockstudio/block_tags/builders
Reģistrējiet bloku masīvu veidotājus, ko izmanto bloku tagi un elementiem piesaistīti pielāgoti bloki. Katra bloka atzvanīšanas funkcija saņem atribūtu masīvu un neapstrādātu iekšējo saturu.
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 un blockstudio/parser/renderers saņem vienu un to pašu reģistru. Tie tiek izpildīti pēc blockstudio/block_tags/builders norādītajā secībā un var aizstāt agrāk reģistrētu tā paša bloka veidotāju.
blockstudio/parser/element_mapping
Mainiet noklusējuma HTML elementu un bloku kartējumu. Pēc noklusējuma standarta HTML elementi, piemēram, <h1>, <p> un <img>, tiek kartēti uz pamata WordPress blokiem. Izmantojiet šo filtru, lai jebkuru elementu piesaistītu citam blokam.
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 );
Ja <p> kartē uz reģistrētu bloku, kas nav pamata Blockstudio bloks ar atribūtu content, iekšējais HTML tiek kopēts uz šo atribūtu, tostarp iekļautie tagi, piemēram, code un img, kas arī ir kartēti pēc elementiem. Rindkopa, kuras vienīgais bērnelements ir attēls, kļūst par bloku, uz kuru kartē <img>. Ligzdoti bloku tagi vai bloka līmeņa HTML saglabā parasto iekšējo bloku parsēšanas darbību.
Lapas
blockstudio/pages/paths
Filtrējiet direktorijus, kuros tiek meklētas lapu veidnes.
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
Filtrējiet maksimālo vecumu mantotai, pirms 7.6.2 izveidotai manifesta kešatmiņai, kas jaunināšanas laikā var inicializēt saglabāto kolekciju izpildvidi. Parastie pieprasījumi izmanto saglabāto kolekcijas konfigurāciju un periodiski atkārtoti neskenē lapu saknes. Pēc kolekcijas manifesta maiņas palaidiet wp bs pages sync vai izsauciet Blockstudio\Pages::reconcile().
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Filtrējiet ziņas datus pirms jaunas lapas izveides.
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
Filtrējiet ziņas datus pirms esošas lapas atjaunināšanas.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Darbība tiek izpildīta pēc visu lapu sinhronizēšanas.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Darbība tiek izpildīta pēc lapas ziņas izveides.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Darbība tiek izpildīta pēc lapas ziņas atjaunināšanas.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Raksti
blockstudio/patterns/paths
Filtrējiet direktorijus, kuros tiek meklētas rakstu veidnes.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Darbība tiek izpildīta pēc visu rakstu reģistrēšanas.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Vietnes veidnes
blockstudio/site_templates/template_paths
Filtrējiet direktorijus, kuros tiek meklēti template.json faili.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
Filtrējiet direktorijus, kuros tiek meklēti part.json faili.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Filtrējiet abus atklāšanas ceļu sarakstus kopā. Vērtība satur templates un parts masīvus.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Filtrējiet avota failu kandidātus pēc manifesta un loģiskā avota koka noteikšanas.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
Filtrējiet pilnās veidnes, ko atgriež reģistrs API.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Filtrējiet veidņu daļas, ko atgriež reģistrs API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Filtrējiet veidnes avota virkni, pirms Blockstudio to parsē blokos.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Filtrējiet veidnes daļas avota virkni, pirms Blockstudio to parsē blokos.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Filtrējiet Blockstudio\Html_Parser instanci, ko izmanto vienai kompilētai veidnei vai tās daļai. Atgrieziet Html_Parser; citas vērtības liek izmantot noklusējuma parsētāju.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Darbība tiek izpildīta pēc aukstās atklāšanas un kompilēšanas procesa, pirms atjaunotais reģistrs tiek saglabāts.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Darbība tiek izpildīta pēc tam, kad atjaunotais, failos balstītais vietnes redaktora veidņu reģistrs ir saglabāts.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
Darbības discovered un registered netiek izpildītas, ja tiek izmantota siltā reģistra kešatmiņa.