Liigu sisu juurde

Konksud

Lehtede, mustrite, saidimallide ja parseri HTML kohandamiseks saadaval olevad filtrid ja toimingud.

Parser

blockstudio/block_tags/builders

Registreeri plokisiltide ja elementidega seostatud kohandatud plokkide jaoks plokimassiivi koostajad. Iga ploki tagasihelistusfunktsioon saab atribuutide massiivi ja töötlemata sisemise sisu.

PHP
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 saavad sama registri. Need käivituvad pärast blockstudio/block_tags/builders selles järjekorras ning võivad asendada sama ploki varasema koostaja.

blockstudio/parser/element_mapping

Alista vaikimisi HTML elemendi ja ploki vastendus. Vaikimisi seostatakse standardsed HTML elemendid, nagu <h1>, <p> ja <img>, tuumiku WordPress plokkidega. Selle filtri abil saab suunata mis tahes elemendi teise plokki.

PHP
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 );

Kui <p> seostab registreeritud mittetuumikulise Blockstudio ploki, millel on content rikasteksti atribuut, kopeeritakse selle sisemine HTML sellesse atribuuti, sealhulgas reasisesed sildid, nagu code ja img, mis on samuti elementidega seotud. Lõik, mille ainus alamelement on pilt, muutub plokiks, millele <img> viitab. Pesastatud plokisildid või plokitaseme HTML säilitavad tavapärase sisemiste plokkide parsimise käitumise.

Lehed

blockstudio/pages/paths

Filtreeri lehemallide jaoks skannitavaid katalooge.

PHP
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

Filtreeri pärandvormingus, versioonieelse 7.6.2 manifestivahemälu maksimaalset vanust, mida saab uuendamise ajal kasutada püsiva kollektsiooni käituskeskkonna algandmetena. Tavalised päringud kasutavad püsivat kollektsiooni konfiguratsiooni ega skanni lehtede juuri perioodiliselt uuesti. Pärast kollektsiooni manifesti muutmist käivita wp bs pages sync või kutsu välja Blockstudio\Pages::reconcile().

PHP
add_filter( 'blockstudio/pages/manifest_scan_interval', function() {
    return 10;
} );

blockstudio/pages/create_post_data

Filtreeri postituse andmeid enne uue lehe loomist.

PHP
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

Filtreeri postituse andmeid enne olemasoleva lehe uuendamist.

PHP
add_filter( 'blockstudio/pages/update_post_data', function( $post_data, $post, $page_data ) {
    return $post_data;
}, 10, 3 );

blockstudio/pages/synced

Toiming käivitatakse pärast kõigi lehtede sünkroonimist.

PHP
add_action( 'blockstudio/pages/synced', function( $registry ) {
    // $registry is the Page_Registry instance
} );

blockstudio/pages/post_created

Toiming käivitatakse pärast lehepostituse loomist.

PHP
add_action( 'blockstudio/pages/post_created', function( $post_id, $page_data ) {
    // Do something after page creation
}, 10, 2 );

blockstudio/pages/post_updated

Toiming käivitatakse pärast lehepostituse uuendamist.

PHP
add_action( 'blockstudio/pages/post_updated', function( $post_id, $page_data ) {
    // Do something after page update
}, 10, 2 );

Mustrid

blockstudio/patterns/paths

Filtreeri mustrimallide jaoks skannitavaid katalooge.

PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/custom-patterns';
    $paths[] = MY_PLUGIN_PATH . '/patterns';
    return $paths;
} );

blockstudio/patterns/registered

Toiming käivitatakse pärast kõigi mustrite registreerimist.

PHP
add_action( 'blockstudio/patterns/registered', function( $registry ) {
    // $registry is the Pattern_Registry instance
} );

Saidi mallid

blockstudio/site_templates/template_paths

Filtreeri template.json failide jaoks skannitavaid katalooge.

PHP
add_filter( 'blockstudio/site_templates/template_paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/site-templates';
    return $paths;
} );

blockstudio/site_templates/part_paths

Filtreeri part.json failide jaoks skannitavaid katalooge.

PHP
add_filter( 'blockstudio/site_templates/part_paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/site-parts';
    return $paths;
} );

blockstudio/site_templates/paths

Filtreeri mõlemat avastusteekondade loendit koos. Väärtus sisaldab massiive templates ja parts.

PHP
add_filter( 'blockstudio/site_templates/paths', function( $paths ) {
    return $paths;
} );

blockstudio/site_templates/template_candidates

Filtreeri lähtefailide kandidaate pärast manifesti ja loogilise lähtepuu lahendamist.

PHP
add_filter(
    'blockstudio/site_templates/template_candidates',
    function( $candidates, $directory, $manifest ) {
        $candidates[] = $directory . '/template.custom.php';
        return $candidates;
    },
    10,
    3
);

blockstudio/site_templates/templates

Filtreeri registri API tagastatud täismalle.

PHP
add_filter( 'blockstudio/site_templates/templates', function( $templates ) {
    return $templates;
} );

blockstudio/site_templates/parts

Filtreeri registri API tagastatud malliosi.

PHP
add_filter( 'blockstudio/site_templates/parts', function( $parts ) {
    return $parts;
} );

blockstudio/site_templates/template_content

Filtreeri malli lähtekoodistringi enne, kui Blockstudio parsib selle plokkideks.

PHP
add_filter( 'blockstudio/site_templates/template_content', function( $content, $template ) {
    return $content;
}, 10, 2 );

blockstudio/site_templates/part_content

Filtreeri malli osa lähtekoodistringi enne, kui Blockstudio parsib selle plokkideks.

PHP
add_filter( 'blockstudio/site_templates/part_content', function( $content, $part ) {
    return $content;
}, 10, 2 );

blockstudio/site_templates/parser

Filtreeri ühe kompileeritud malli või osa jaoks kasutatavat Blockstudio\Html_Parser eksemplari. Tagasta Html_Parser; muud väärtused suunatakse vaikeparserile.

PHP
add_filter(
    'blockstudio/site_templates/parser',
    function( $parser, $item ) {
        return $parser;
    },
    10,
    2
);

blockstudio/site_templates/discovered

Toiming käivitatakse pärast külma avastamis- ja kompileerimiskäiku, enne uuesti koostatud registri salvestamist.

PHP
add_action( 'blockstudio/site_templates/discovered', function( $registry ) {
    // Inspect the rebuilt Site_Template_Registry.
} );

blockstudio/site_templates/registered

Toiming käivitatakse pärast failipõhise Site Editori malliregistri uuesti koostamist ja salvestamist.

PHP
add_action( 'blockstudio/site_templates/registered', function( $registry ) {
    // $registry is the Site_Template_Registry instance
} );

Toimingud discovered ja registered ei käivitu sooja registrivahemälu tabamuse korral.