Hooks
Beschikbare filters en acties voor het aanpassen van pagina’s, patronen, sitetemplates en de parser van HTML.
Parser
blockstudio/block_tags/builders
Registreer builders voor blokarrays die door bloktags en aangepaste, aan elementen gekoppelde blokken worden gebruikt. De callback voor elk blok ontvangt een attributenarray en ruwe binneninhoud.
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 en blockstudio/parser/renderers ontvangen hetzelfde register. Ze worden na blockstudio/block_tags/builders uitgevoerd, in die volgorde, en kunnen een eerdere builder voor hetzelfde blok vervangen.
blockstudio/parser/element_mapping
Overschrijf de standaardmapping van HTML-elementen naar blokken. Standaard worden gewone HTML-elementen zoals <h1>, <p> en <img> gekoppeld aan kernblokken van WordPress. Gebruik dit filter om een element naar een ander blok te verwijzen.
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 );
Als <p> een geregistreerd niet-kernblok van Blockstudio met een attribuut voor rich text content koppelt, wordt de binnenliggende HTML naar dat attribuut gekopieerd, inclusief inline-tags zoals code en img die ook aan elementen zijn gekoppeld. Een alinea waarvan de enige child een afbeelding is, wordt het blok waaraan <img> deze koppelt. Geneste bloktags of blokniveau-HTML behouden het normale gedrag voor het parsen van binnenliggende blokken.
Pagina’s
blockstudio/pages/paths
Filter de mappen die worden doorzocht op paginasjablonen.
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 de maximale leeftijd van een verouderde manifestcache van vóór 7.6.2 die tijdens een upgrade de persistente runtime van de collectie kan initialiseren. Normale aanvragen gebruiken de persistente configuratie van de collectie en doorzoeken de paginabronnen niet periodiek opnieuw. Voer wp bs pages sync uit of roep Blockstudio\Pages::reconcile() aan nadat je een manifest van een collectie hebt gewijzigd.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Filter de berichtgegevens voordat een nieuwe pagina wordt aangemaakt.
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 de berichtgegevens voordat een bestaande pagina wordt bijgewerkt.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Actie die wordt uitgevoerd nadat alle pagina’s zijn gesynchroniseerd.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Actie die wordt uitgevoerd nadat een paginabericht is aangemaakt.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Actie die wordt uitgevoerd nadat een paginabericht is bijgewerkt.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Patronen
blockstudio/patterns/paths
Filter de mappen die worden doorzocht op patroonsjablonen.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Actie die wordt uitgevoerd nadat alle patronen zijn geregistreerd.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Sitesjablonen
blockstudio/site_templates/template_paths
Filter de mappen die worden doorzocht op bestanden van 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 de mappen die worden doorzocht op bestanden van part.json.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Filter beide lijsten met ontdekkingspaden samen. De waarde bevat arrays van templates en parts.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Filter kandidaten voor bronbestanden nadat het manifest en de logische bronstructuur zijn vastgesteld.
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 volledige sjablonen die door het register API worden teruggegeven.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Filter sjabloondelen die door het register API worden teruggegeven.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Filter een brontekst voor een sjabloon voordat Blockstudio deze in blokken parseert.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Filter een brontekst voor een sjabloondeel voordat Blockstudio deze in blokken parseert.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Filter de Blockstudio\Html_Parser-instantie die voor één gecompileerd sjabloon of sjabloondeel wordt gebruikt. Geef een Html_Parser terug; bij andere waarden wordt de standaardparser gebruikt.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Actie die wordt uitgevoerd na een koude ontdekkings- en compilatieronde, voordat het opnieuw opgebouwde register wordt opgeslagen.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Actie die wordt uitgevoerd nadat een opnieuw opgebouwd, op bestanden gebaseerd Site Editor-sjabloonregister is opgeslagen.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
De acties discovered en registered worden niet uitgevoerd bij een treffer in de warme registercache.