Preskoči na vsebino

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.

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 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.

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

Č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.

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

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().

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

blockstudio/pages/create_post_data

Filtrirajte podatke objave pred ustvarjanjem nove strani.

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

Filtrirajte podatke objave pred posodobitvijo obstoječe strani.

PHP
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.

PHP
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.

PHP
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.

PHP
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.

PHP
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.

PHP
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.

PHP
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.

PHP
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.

PHP
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.

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

Filtrirajte celotne predloge, ki jih vrne register API.

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

blockstudio/site_templates/parts

Filtrirajte dele predlog, ki jih vrne register API.

PHP
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.

PHP
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.

PHP
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.

PHP
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.

PHP
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.

PHP
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.