Zanke
Filtri in dejanja, ki so na voljo za prilagajanje strani, vzorcev, Site Templates in razčlenjevalnika HTML.
Razčlenjevalnik
blockstudio/block_tags/builders
Registrirajte gradnike za gradnjo polj, ki jih uporabljajo oznake blokov in bloki po meri, preslikani na elemente. Povratni klic za vsak blok prejme polje atributov in surovo notranjo vsebino.
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 in blockstudio/parser/renderers prejmeta isti register. Zaženeta se za blockstudio/block_tags/builders, v tem vrstnem redu, in lahko nadomestita predhodno orodje za gradnjo istega bloka.
blockstudio/parser/element_mapping
Prepišite privzeto preslikavo elementov HTML v bloke. Privzeto se standardni elementi HTML, kot so <h1>, <p> in <img>, preslikajo v osnovne bloke WordPress. S tem filtrom lahko kateri koli element usmerite v drug blok.
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 );
Če <p> preslika element v registrirani blok Blockstudio, ki ni osnovni in ima atribut richtext content, se njegova notranja vsebina HTML kopira v ta atribut, vključno z vstavljenimi oznakami, kot sta code in img, ki so prav tako preslikane na elemente. Odstavek, katerega edini podrejeni element je slika, postane blok, v katerega preslika <img>. Ugnezdene oznake blokov ali elementi HTML na ravni blokov ohranijo običajno vedenje razčlenjevanja notranjih blokov.
Strani
blockstudio/pages/paths
Filtrirajte imenike, ki se pregledujejo za predloge strani.
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
Filtrirajte najdaljšo starost predpomnilnika manifesta starejše različice pred 7.6.2, ki lahko med nadgradnjo napolni obstojni izvajalni sistem zbirke. Običajne zahteve uporabljajo obstojno konfiguracijo zbirke in ne pregledujejo korenskih imenikov strani periodično. Po spremembi manifesta zbirke zaženite wp bs pages sync ali pokličite Blockstudio\Pages::reconcile().
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Filtrirajte podatke objave pred ustvarjanjem nove strani.
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
Filtrirajte podatke objave pred posodobitvijo obstoječe strani.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Dejanje se sproži po sinhronizaciji vseh strani.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Dejanje se sproži po ustvarjanju objave strani.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Dejanje se sproži po posodobitvi objave strani.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Vzorci
blockstudio/patterns/paths
Filtrirajte imenike, ki se pregledujejo za predloge vzorcev.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Dejanje se sproži po registraciji vseh vzorcev.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Predloge spletnega mesta
blockstudio/site_templates/template_paths
Filtrirajte imenike, ki se pregledujejo za datoteke template.json.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
Filtrirajte imenike, ki se pregledujejo za datoteke part.json.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Filtrirajte oba seznama poti za odkrivanje hkrati. Vrednost vsebuje polji templates in parts.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Filtrirajte kandidate za izvorne datoteke, potem ko sta razrešena manifest in logično izvorno drevo.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
Filtrirajte celotne predloge, ki jih vrne register API.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Filtrirajte dele predlog, ki jih vrne register API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Filtrirajte izvorni niz predloge, preden ga Blockstudio razčleni v bloke.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Filtrirajte izvorni niz dela predloge, preden ga Blockstudio razčleni v bloke.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Filtrirajte primerek Blockstudio\Html_Parser, ki se uporabi za eno prevedeno predlogo ali njen del. Vrnite Html_Parser; pri drugih vrednostih se uporabi privzeti razčlenjevalnik.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Dejanje se sproži po hladnem pregledu za odkrivanje in prevajanje, preden se obnovljeni register shrani.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Dejanje se sproži po shranjevanju obnovljenega registra predlog urejevalnika spletnega mesta, ki temeljijo na datotekah.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
Dejanji discovered in registered se ob zadetku v toplem predpomnilniku registra ne sprožita.