Ga naar de inhoud

Hooks

Beschikbare filters en acties voor het aanpassen van pagina’s, patronen, sitetemplates en de parser van HTML.

Parser

blockstudio/block_tags/builders

Registreer builders voor blokarrays die door bloktags en aangepaste, aan elementen gekoppelde blokken worden gebruikt. De callback voor elk blok ontvangt een attributenarray en ruwe binneninhoud.

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 en blockstudio/parser/renderers ontvangen hetzelfde register. Ze worden na blockstudio/block_tags/builders uitgevoerd, in die volgorde, en kunnen een eerdere builder voor hetzelfde blok vervangen.

blockstudio/parser/element_mapping

Overschrijf de standaardmapping van HTML-elementen naar blokken. Standaard worden gewone HTML-elementen zoals <h1>, <p> en <img> gekoppeld aan kernblokken van WordPress. Gebruik dit filter om een element naar een ander blok te verwijzen.

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

Als <p> een geregistreerd niet-kernblok van Blockstudio met een attribuut voor rich text content koppelt, wordt de binnenliggende HTML naar dat attribuut gekopieerd, inclusief inline-tags zoals code en img die ook aan elementen zijn gekoppeld. Een alinea waarvan de enige child een afbeelding is, wordt het blok waaraan <img> deze koppelt. Geneste bloktags of blokniveau-HTML behouden het normale gedrag voor het parsen van binnenliggende blokken.

Pagina’s

blockstudio/pages/paths

Filter de mappen die worden doorzocht op paginasjablonen.

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

Filter de maximale leeftijd van een verouderde manifestcache van vóór 7.6.2 die tijdens een upgrade de persistente runtime van de collectie kan initialiseren. Normale aanvragen gebruiken de persistente configuratie van de collectie en doorzoeken de paginabronnen niet periodiek opnieuw. Voer wp bs pages sync uit of roep Blockstudio\Pages::reconcile() aan nadat je een manifest van een collectie hebt gewijzigd.

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

blockstudio/pages/create_post_data

Filter de berichtgegevens voordat een nieuwe pagina wordt aangemaakt.

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

Filter de berichtgegevens voordat een bestaande pagina wordt bijgewerkt.

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

blockstudio/pages/synced

Actie die wordt uitgevoerd nadat alle pagina’s zijn gesynchroniseerd.

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

blockstudio/pages/post_created

Actie die wordt uitgevoerd nadat een paginabericht is aangemaakt.

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

blockstudio/pages/post_updated

Actie die wordt uitgevoerd nadat een paginabericht is bijgewerkt.

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

Patronen

blockstudio/patterns/paths

Filter de mappen die worden doorzocht op patroonsjablonen.

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

blockstudio/patterns/registered

Actie die wordt uitgevoerd nadat alle patronen zijn geregistreerd.

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

Sitesjablonen

blockstudio/site_templates/template_paths

Filter de mappen die worden doorzocht op bestanden van 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

Filter de mappen die worden doorzocht op bestanden van part.json.

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

blockstudio/site_templates/paths

Filter beide lijsten met ontdekkingspaden samen. De waarde bevat arrays van templates en parts.

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

blockstudio/site_templates/template_candidates

Filter kandidaten voor bronbestanden nadat het manifest en de logische bronstructuur zijn vastgesteld.

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

Filter volledige sjablonen die door het register API worden teruggegeven.

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

blockstudio/site_templates/parts

Filter sjabloondelen die door het register API worden teruggegeven.

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

blockstudio/site_templates/template_content

Filter een brontekst voor een sjabloon voordat Blockstudio deze in blokken parseert.

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

blockstudio/site_templates/part_content

Filter een brontekst voor een sjabloondeel voordat Blockstudio deze in blokken parseert.

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

blockstudio/site_templates/parser

Filter de Blockstudio\Html_Parser-instantie die voor één gecompileerd sjabloon of sjabloondeel wordt gebruikt. Geef een Html_Parser terug; bij andere waarden wordt de standaardparser gebruikt.

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

blockstudio/site_templates/discovered

Actie die wordt uitgevoerd na een koude ontdekkings- en compilatieronde, voordat het opnieuw opgebouwde register wordt opgeslagen.

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

blockstudio/site_templates/registered

Actie die wordt uitgevoerd nadat een opnieuw opgebouwd, op bestanden gebaseerd Site Editor-sjabloonregister is opgeslagen.

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

De acties discovered en registered worden niet uitgevoerd bij een treffer in de warme registercache.