Cârlige
Filtre și acțiuni disponibile pentru personalizarea paginilor, modelelor, Site Templates și a parserului HTML.
Parser
blockstudio/block_tags/builders
Înregistrează constructorii de matrice de blocuri utilizați de etichetele de bloc și de blocurile personalizate mapate la elemente. Callback-ul fiecărui bloc primește o matrice de atribute și conținutul interior brut.
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 și blockstudio/parser/renderers primesc același registru. Se execută după blockstudio/block_tags/builders, în această ordine, și pot înlocui un constructor anterior pentru același bloc.
blockstudio/parser/element_mapping
Suprascrie maparea implicită dintre elementul HTML și bloc. În mod implicit, elemente HTML standard precum <h1>, <p> și <img> sunt mapate la blocuri WordPress de bază. Folosiți acest filtru pentru a direcționa orice element către un alt bloc.
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 );
Dacă <p> mapează la un bloc Blockstudio non-core înregistrat, cu un atribut richtext content, conținutul interior HTML este copiat în acel atribut, inclusiv etichetele inline precum code și img, care sunt și ele mapate la elemente. Un paragraf al cărui singur copil este o imagine devine blocul către care mapează <img>. Etichetele de bloc imbricate sau elementele HTML la nivel de bloc păstrează comportamentul normal de analizare a blocurilor interioare.
Pagini
blockstudio/pages/paths
Filtrați directoarele scanate pentru șabloanele de pagină.
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
Filtrați vechimea maximă a unei memorii cache pentru manifestul anterior versiunii 7.6.2, care poate inițializa colecția persistentă a mediului de execuție în timpul unui upgrade. Cererile obișnuite folosesc configurația persistentă a colecției și nu rescanează periodic rădăcinile paginilor. Rulați wp bs pages sync sau apelați Blockstudio\Pages::reconcile() după ce modificați un manifest al colecției.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Filtrați datele postării înainte de a crea o pagină nouă.
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
Filtrați datele postării înainte de a actualiza o pagină existentă.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Acțiune declanșată după sincronizarea tuturor paginilor.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Acțiune declanșată după crearea unei postări de pagină.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Acțiune declanșată după actualizarea unei postări de pagină.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Modele
blockstudio/patterns/paths
Filtrați directoarele scanate pentru șabloanele de modele.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Acțiune declanșată după înregistrarea tuturor modelelor.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Șabloane de site
blockstudio/site_templates/template_paths
Filtrați directoarele scanate pentru fișierele template.json.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
Filtrați directoarele scanate pentru fișierele part.json.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Filtrați împreună ambele liste de căi pentru descoperire. Valoarea conține matricele templates și parts.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Filtrați candidații pentru fișierele sursă după ce au fost rezolvate manifestul și arborele logic al sursei.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
Filtrați șabloanele complete returnate de registrul API.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Filtrați părțile de șablon returnate de registrul API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Filtrați șirul sursă al unui șablon înainte ca Blockstudio să îl analizeze și să îl transforme în blocuri.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Filtrați șirul sursă al unei părți de șablon înainte ca Blockstudio să îl analizeze și să îl transforme în blocuri.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Filtrați instanța Blockstudio\Html_Parser utilizată pentru compilarea unui singur șablon sau a unei părți. Returnați un Html_Parser; celelalte valori folosesc analizorul implicit.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Acțiune declanșată după o rundă de descoperire și compilare la rece, înainte ca registrul reconstruit să fie stocat.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Acțiune declanșată după stocarea registrului reconstruit de șabloane ale editorului de site, bazat pe fișiere.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
Acțiunile discovered și registered nu se declanșează când există o intrare în memoria cache a registrului activ.