Gå til indhold

Hooks

Filtre og handlinger til tilpasning af sider, mønstre, webstedsskabeloner og HTML-parseren.

Parser

blockstudio/block_tags/builders

Registrér block-array-buildere, der bruges af block-tags og elementtilknyttede brugerdefinerede blocks. Callbacken for hver block modtager et attributarray og råt indhold.

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 og blockstudio/parser/renderers modtager det samme register. De køres efter blockstudio/block_tags/builders i den rækkefølge og kan erstatte en tidligere builder for den samme block.

blockstudio/parser/element_mapping

Tilsidesæt standardtilknytningen mellem HTML-elementer og blocks. Som standard knyttes standardelementer i HTML, såsom <h1>, <p> og <img>, til core-WordPress-blocks. Brug dette filter til at knytte et element til en anden block.

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

Hvis <p> knytter et element til en registreret ikke-core-Blockstudio-block med en richtext-attribut content, kopieres det indre HTML til den attribut, inklusive inline-tags som code og img, der også er tilknyttet elementer. Et afsnit, hvis eneste child er et billede, bliver til den block, som <img> knytter elementet til. Indlejrede block-tags eller HTML på blokniveau følger den normale adfærd for parsing af indre blocks.

Sider

blockstudio/pages/paths

Filtrér de mapper, der gennemsøges efter sideskabeloner.

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

Filtrér den maksimale alder for en ældre manifestcache fra før 7.6.2, som kan danne grundlag for den vedvarende samlingsruntime under en opgradering. Normale forespørgsler bruger den vedvarende samlingskonfiguration og gennemsøger ikke sidernes rødder med faste mellemrum. Kør wp bs pages sync, eller kald Blockstudio\Pages::reconcile(), efter du har ændret et samlingsmanifest.

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

blockstudio/pages/create_post_data

Filtrér indlægsdata, før en ny side oprettes.

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

Filtrér indlægsdata, før en eksisterende side opdateres.

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

blockstudio/pages/synced

Handling, der udløses, når alle sider er synkroniseret.

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

blockstudio/pages/post_created

Handling, der udløses, når et sideindlæg oprettes.

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

blockstudio/pages/post_updated

Handling, der udløses, når et sideindlæg opdateres.

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

Mønstre

blockstudio/patterns/paths

Filtrér de mapper, der gennemsøges efter mønsterskabeloner.

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

blockstudio/patterns/registered

Handling, der udløses, når alle mønstre er registreret.

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

Webstedsskabeloner

blockstudio/site_templates/template_paths

Filtrér de mapper, der gennemsøges efter template.json-filer.

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

blockstudio/site_templates/part_paths

Filtrér de mapper, der gennemsøges efter part.json-filer.

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

blockstudio/site_templates/paths

Filtrér begge lister over søgestier samlet. Værdien indeholder arrays af templates og parts.

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

blockstudio/site_templates/template_candidates

Filtrér kildefilkandidater, efter manifestet og det logiske kildetræ er blevet fundet.

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

Filtrér komplette skabeloner, der returneres af registret API.

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

blockstudio/site_templates/parts

Filtrér skabelondele, der returneres af registret API.

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

blockstudio/site_templates/template_content

Filtrér en kildestreng for en skabelon, før Blockstudio parser den til blocks.

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

blockstudio/site_templates/part_content

Filtrér en kildestreng for en skabelondel, før Blockstudio parser den til blocks.

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

blockstudio/site_templates/parser

Filtrér den Blockstudio\Html_Parser-instans, der bruges til én kompileret skabelon eller del. Returnér en Html_Parser; andre værdier falder tilbage til standardparseren.

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

blockstudio/site_templates/discovered

Handling, der udløses efter en kold søge- og kompileringsrunde, før det genopbyggede register gemmes.

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

blockstudio/site_templates/registered

Handling, der udløses, efter et genopbygget filbaseret Site Editor-skabelonregister er blevet gemt.

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

Handlingerne discovered og registered udløses ikke, når der er et cachehit i et varmt register.