Hooks
Filtre og handlinger til tilpasning af sider, mønstre, webstedsskabeloner og HTML-parseren.
Parser
blockstudio/block_tags/builders
Registrér block-array-buildere, der bruges af block-tags og elementtilknyttede brugerdefinerede blocks. Callbacken for hver block modtager et attributarray og råt indhold.
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 og blockstudio/parser/renderers modtager det samme register. De køres efter blockstudio/block_tags/builders i den rækkefølge og kan erstatte en tidligere builder for den samme block.
blockstudio/parser/element_mapping
Tilsidesæt standardtilknytningen mellem HTML-elementer og blocks. Som standard knyttes standardelementer i HTML, såsom <h1>, <p> og <img>, til core-WordPress-blocks. Brug dette filter til at knytte et element til en anden block.
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 );
Hvis <p> knytter et element til en registreret ikke-core-Blockstudio-block med en richtext-attribut content, kopieres det indre HTML til den attribut, inklusive inline-tags som code og img, der også er tilknyttet elementer. Et afsnit, hvis eneste child er et billede, bliver til den block, som <img> knytter elementet til. Indlejrede block-tags eller HTML på blokniveau følger den normale adfærd for parsing af indre blocks.
Sider
blockstudio/pages/paths
Filtrér de mapper, der gennemsøges efter sideskabeloner.
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ér den maksimale alder for en ældre manifestcache fra før 7.6.2, som kan danne grundlag for den vedvarende samlingsruntime under en opgradering. Normale forespørgsler bruger den vedvarende samlingskonfiguration og gennemsøger ikke sidernes rødder med faste mellemrum. Kør wp bs pages sync, eller kald Blockstudio\Pages::reconcile(), efter du har ændret et samlingsmanifest.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Filtrér indlægsdata, før en ny side oprettes.
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ér indlægsdata, før en eksisterende side opdateres.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Handling, der udløses, når alle sider er synkroniseret.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Handling, der udløses, når et sideindlæg oprettes.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Handling, der udløses, når et sideindlæg opdateres.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Mønstre
blockstudio/patterns/paths
Filtrér de mapper, der gennemsøges efter mønsterskabeloner.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Handling, der udløses, når alle mønstre er registreret.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Webstedsskabeloner
blockstudio/site_templates/template_paths
Filtrér de mapper, der gennemsøges efter template.json-filer.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
Filtrér de mapper, der gennemsøges efter part.json-filer.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Filtrér begge lister over søgestier samlet. Værdien indeholder arrays af templates og parts.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Filtrér kildefilkandidater, efter manifestet og det logiske kildetræ er blevet fundet.
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ér komplette skabeloner, der returneres af registret API.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Filtrér skabelondele, der returneres af registret API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Filtrér en kildestreng for en skabelon, før Blockstudio parser den til blocks.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Filtrér en kildestreng for en skabelondel, før Blockstudio parser den til blocks.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Filtrér den Blockstudio\Html_Parser-instans, der bruges til én kompileret skabelon eller del. Returnér en Html_Parser; andre værdier falder tilbage til standardparseren.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Handling, der udløses efter en kold søge- og kompileringsrunde, før det genopbyggede register gemmes.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Handling, der udløses, efter et genopbygget filbaseret Site Editor-skabelonregister er blevet gemt.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
Handlingerne discovered og registered udløses ikke, når der er et cachehit i et varmt register.