Koukkukohdat
Suodattimet ja toiminnot sivujen, mallien, sivustomallipohjien ja jäsentimen HTML mukauttamiseen.
Jäsennin
blockstudio/block_tags/builders
Rekisteröi lohkotageissa ja elementtikartoitukseen perustuvissa mukautetuissa lohkoissa käytettävät lohkomääritysten rakentajat. Kunkin lohkon takaisinkutsufunktio saa argumenteikseen attribuuttitaulukon ja raakasisällön.
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 ja blockstudio/parser/renderers käyttävät samaa rekisteriä. Ne suoritetaan blockstudio/block_tags/builders jälkeen tässä järjestyksessä, ja ne voivat korvata aiemman saman lohkon rakentajan.
blockstudio/parser/element_mapping
Ohita oletusarvoinen HTML-elementtien ja lohkojen välinen määritys. Oletusarvoisesti tavalliset HTML-elementit, kuten <h1>, <p> ja <img>, yhdistetään ytimen WordPress-lohkoihin. Tällä suodattimella voit ohjata minkä tahansa elementin toiseen lohkoon.
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 );
Jos <p> yhdistetään rekisteröityyn muuhun kuin ytimen Blockstudio-lohkoon, jossa on content-rikastekstiattribuutti, sen sisäinen HTML kopioidaan kyseiseen attribuuttiin. Mukaan tulevat myös sisäiset tagit, kuten code ja img, jotka on myös yhdistetty elementteihin. Kappale, jonka ainoa lapsielementti on kuva, muuttuu lohkoksi, johon <img> yhdistetään. Sisäkkäiset lohkomerkit tai lohkotason HTML käsitellään tavalliseen tapaan sisäisinä lohkoina.
Sivut
blockstudio/pages/paths
Suodata sivupohjien etsintään skannattavat hakemistot.
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
Suodata vanhan, 7.6.2-versiota edeltävän manifestivälimuistin enimmäisikää. Välimuistia voidaan käyttää päivityksen aikana pysyvän kokoelma-ajoympäristön alustamiseen. Tavallisissa pyynnöissä käytetään pysyvän kokoelman määritystä eikä sivuston juurihakemistoja skannata säännöllisesti uudelleen. Suorita wp bs pages sync tai kutsu Blockstudio\Pages::reconcile() kokoelmamanifestin muuttamisen jälkeen.
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
return 10;
} );
blockstudio/pages/create_post_data
Suodata artikkelitiedot ennen uuden sivun luomista.
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
Suodata artikkelitiedot ennen olemassa olevan sivun päivittämistä.
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
return $post_data;
}, 10, 3 );
blockstudio/pages/synced
Toiminto suoritetaan, kun kaikki sivut on synkronoitu.
add_action( 'blockstudio/pages/synced', function( $registry ) {
// $registry is the Page_Registry instance
} );
blockstudio/pages/post_created
Toiminto suoritetaan sivuartikkelin luomisen jälkeen.
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
// Do something after page creation
}, 10, 2 );
blockstudio/pages/post_updated
Toiminto suoritetaan sivuartikkelin päivittämisen jälkeen.
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
// Do something after page update
}, 10, 2 );
Kuviot
blockstudio/patterns/paths
Suodata kuviomallien etsintään skannattavat hakemistot.
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
blockstudio/patterns/registered
Toiminto suoritetaan, kun kaikki kuviot on rekisteröity.
add_action( 'blockstudio/patterns/registered', function( $registry ) {
// $registry is the Pattern_Registry instance
} );
Sivuston sivupohjat
blockstudio/site_templates/template_paths
Suodata template.json-tiedostojen etsintään skannattavat hakemistot.
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-templates';
return $paths;
} );
blockstudio/site_templates/part_paths
Suodata part.json-tiedostojen etsintään skannattavat hakemistot.
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/site-parts';
return $paths;
} );
blockstudio/site_templates/paths
Suodata molemmat etsintäpolkulistat yhdessä. Arvo sisältää taulukot templates ja parts.
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
return $paths;
} );
blockstudio/site_templates/template_candidates
Suodata lähdetiedostoehdokkaat sen jälkeen, kun manifesti ja looginen lähdepuu on selvitetty.
add_filter(
'blockstudio/site_templates/template_candidates',
function( $candidates, $directory, $manifest ) {
$candidates[] = $directory . '/template.custom.php';
return $candidates;
},
10,
3
);
blockstudio/site_templates/templates
Suodata rekisterin API palauttamat täydet sivupohjat.
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
return $templates;
} );
blockstudio/site_templates/parts
Suodata rekisterin API palauttamat sivupohjan osat.
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
return $parts;
} );
blockstudio/site_templates/template_content
Suodata sivupohjan lähdemerkkijono ennen kuin Blockstudio jäsentää sen lohkoiksi.
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/part_content
Suodata sivupohjan osan lähdemerkkijono ennen kuin Blockstudio jäsentää sen lohkoiksi.
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
return $content;
}, 10, 2 );
blockstudio/site_templates/parser
Suodata Blockstudio\Html_Parser-esiintymää, jota käytetään yhdessä käännetyssä sivupohjassa tai sen osassa. Palauta Html_Parser; muut arvot palauttavat oletusjäsentimen käyttöön.
add_filter(
'blockstudio/site_templates/parser',
function( $parser, $item ) {
return $parser;
},
10,
2
);
blockstudio/site_templates/discovered
Toiminto suoritetaan kylmän etsintä- ja käännöskierroksen jälkeen, ennen uudelleenrakennetun rekisterin tallentamista.
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
// Inspect the rebuilt Site_Template_Registry.
} );
blockstudio/site_templates/registered
Toiminto suoritetaan sen jälkeen, kun tiedostoihin perustuva Sivustoeditorin sivupohjarekisteri on rakennettu uudelleen ja tallennettu.
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
// $registry is the Site_Template_Registry instance
} );
Toiminnot discovered ja registered eivät suoritu, kun lämmin rekisterivälimuisti osuu.