Įskiepiai
Filtrai ir veiksmai, skirti puslapiams, šablonams, svetainės šablonams ir HTML analizatoriui tinkinti.
Analizatorius
blockstudio/block_tags/builders
Registruokite blokų masyvų kūrimo funkcijas, naudojamas blokų žymų ir elementais susietų pasirinktinių blokų. Kiekvieno bloko atgalinio iškvietimo funkcija gauna atributų masyvą ir neapdorotą vidinį turinį.
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 ir blockstudio/parser/renderers gauna tą patį registrą. Jos vykdomos po blockstudio/block_tags/builders nurodyta tvarka ir gali pakeisti ankstesnę to paties bloko kūrimo funkciją.
blockstudio/parser/element_mapping
Pakeiskite numatytąjį elementų HTML susiejimą su blokais. Pagal numatytuosius nustatymus įprasti HTML elementai, pavyzdžiui, <h1>, <p> ir <img>, susiejami su pagrindiniais WordPress blokais. Šiuo filtru susiekite bet kurį elementą su kitu bloku.
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 );
Jei <p> susieja su registruotu ne pagrindiniu Blockstudio bloku, turinčiu content richtext atributą, jo vidinis HTML nukopijuojamas į tą atributą, įskaitant įterptines žymas, tokias kaip code ir img, kurios taip pat susietos su elementais. Pastraipa, kurios vienintelis vaikinis elementas yra vaizdas, tampa bloku, su kuriuo susieja <img>. Įdėtinės blokų žymos arba blokinio lygio HTML išlaiko įprastą vidinių blokų analizavimo veikimą.
Puslapiai
blockstudio/pages/paths
Filtruokite katalogus, kuriuose ieškoma puslapių šablonų.
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
Filtruokite didžiausią seno, iki 7.6.2 naudoto aprašo failo podėlio amžių, kai jo duomenys gali būti naudojami patvarios rinkinio vykdymo aplinkos pradžiai po naujinimo. Įprastos užklausos naudoja patvarią rinkinio konfigūraciją ir periodiškai iš naujo nenuskaito puslapių šakninių katalogų. Pakeitę rinkinio aprašo failą, paleiskite wp bs pages sync arba iškvieskite Blockstudio\Pages::reconcile().
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Filtruokite įrašo duomenis prieš kurdami naują puslapį.
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
Filtruokite įrašo duomenis prieš atnaujindami esamą puslapį.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Veiksmas vykdomas sinchronizavus visus puslapius.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Veiksmas vykdomas sukūrus puslapio įrašą.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Veiksmas vykdomas atnaujinus puslapio įrašą.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Šablonai
blockstudio/patterns/paths
Filtruokite katalogus, kuriuose ieškoma šablonų šablonų.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Veiksmas vykdomas užregistravus visus šablonus.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Svetainės šablonai
blockstudio/site_templates/template_paths
Filtruokite katalogus, kuriuose ieškoma template.json failų.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
Filtruokite katalogus, kuriuose ieškoma part.json failų.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Filtruokite abu aptikimo kelių sąrašus kartu. Reikšmę sudaro templates ir parts masyvai.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Filtruokite šaltinio failų kandidatus, kai aprašo failas ir loginis šaltinio medis jau nustatyti.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
Filtruokite visus šablonus, kuriuos grąžina registro API.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Filtruokite šablonų dalis, kurias grąžina registro API.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Filtruokite šablono šaltinio eilutę prieš Blockstudio išskaidant ją į blokus.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Filtruokite šablono dalies šaltinio eilutę prieš Blockstudio išskaidant ją į blokus.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Filtruokite Blockstudio\Html_Parser egzempliorių, naudojamą vienam sukompiliuotam šablonui arba jo daliai. Grąžinkite Html_Parser; grąžinus kitą reikšmę bus naudojamas numatytasis analizatorius.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Veiksmas vykdomas atlikus šaltinių paiešką ir kompiliavimą, prieš išsaugant atkurtą registrą.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Veiksmas vykdomas išsaugojus atkurtą, failais pagrįstą svetainės redaktoriaus šablonų registrą.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
Veiksmai discovered ir registered nevykdomi, kai panaudojamas šiltas registro podėlis.