Preskočiť na obsah

Hooky

Filtre a akcie dostupné na prispôsobenie stránok, vzorov, šablón webu a parsera HTML.

Parser

blockstudio/block_tags/builders

Zaregistrujte tvorcov polí blokov, ktoré používajú značky blokov a vlastné bloky mapované na prvky. Callback každého bloku dostane pole atribútov a surový vnútorný obsah.

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 a blockstudio/parser/renderers používajú ten istý register. Spúšťajú sa po blockstudio/block_tags/builders v uvedenom poradí a môžu nahradiť skorší tvorca pre ten istý blok.

blockstudio/parser/element_mapping

Prepíšte predvolené mapovanie prvkov HTML na bloky. Štandardné prvky HTML, ako <h1>, <p> a <img>, sa predvolene mapujú na základné bloky WordPress. Pomocou tohto filtra môžete nasmerovať ľubovoľný prvok na iný 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 );

Ak <p> mapuje na zaregistrovaný neštandardný blok Blockstudio s atribútom richtext content, jeho vnútorný obsah HTML sa skopíruje do tohto atribútu vrátane vložených značiek, ako code a img, ktoré sú tiež mapované na prvky. Odsek, ktorého jediným potomkom je obrázok, sa zmení na blok, na ktorý mapuje <img>. Vnorené značky blokov alebo prvky HTML na úrovni bloku si zachovávajú bežné spracovanie vnútorných blokov.

Stránky

blockstudio/pages/paths

Filtrujte adresáre, v ktorých sa vyhľadávajú šablóny stránok.

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

Filtrujte maximálny vek vyrovnávacej pamäte manifestu pre staršie verzie 7.6.2, ktorá môže počas aktualizácie inicializovať trvalé prostredie kolekcie. Bežné požiadavky používajú trvalú konfiguráciu kolekcie a pravidelne znova neprechádzajú koreňové adresáre stránok. Po zmene manifestu kolekcie spustite wp bs pages sync alebo zavolajte Blockstudio\Pages::reconcile().

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

blockstudio/pages/create_post_data

Filtrujte údaje príspevku pred vytvorením novej stránky.

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

Filtrujte údaje príspevku pred aktualizáciou existujúcej stránky.

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

blockstudio/pages/synced

Akcia sa spustí po synchronizácii všetkých stránok.

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

blockstudio/pages/post_created

Akcia sa spustí po vytvorení príspevku stránky.

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

blockstudio/pages/post_updated

Akcia sa spustí po aktualizácii príspevku stránky.

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

Vzory

blockstudio/patterns/paths

Filtrujte adresáre, v ktorých sa vyhľadávajú šablóny vzorov.

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

blockstudio/patterns/registered

Akcia sa spustí po zaregistrovaní všetkých vzorov.

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

Šablóny webu

blockstudio/site_templates/template_paths

Filtrujte adresáre, v ktorých sa vyhľadávajú súbory 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

Filtrujte adresáre, v ktorých sa vyhľadávajú súbory part.json.

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

blockstudio/site_templates/paths

Filtrujte spoločne oba zoznamy vyhľadávacích ciest. Hodnota obsahuje polia templates a parts.

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

blockstudio/site_templates/template_candidates

Filtrujte kandidátov zdrojových súborov po vyriešení manifestu a logického stromu zdrojov.

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

Filtrujte úplné šablóny vrátené registrom API.

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

blockstudio/site_templates/parts

Filtrujte časti šablón vrátené registrom API.

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

blockstudio/site_templates/template_content

Filtrujte zdrojový reťazec šablóny predtým, ako ho Blockstudio spracuje na bloky.

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

blockstudio/site_templates/part_content

Filtrujte zdrojový reťazec časti šablóny predtým, ako ho Blockstudio spracuje na bloky.

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

blockstudio/site_templates/parser

Filtrujte inštanciu Blockstudio\Html_Parser použitú pre jednu skompilovanú šablónu alebo jej časť. Vráťte Html_Parser; iné hodnoty spôsobia použitie predvoleného parsera.

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

blockstudio/site_templates/discovered

Akcia sa spustí po prechode studeným vyhľadávaním a kompiláciou, pred uložením obnoveného registra.

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

blockstudio/site_templates/registered

Akcia sa spustí po uložení obnoveného registra šablón editora webu založeného na súboroch.

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

Akcie discovered a registered sa nespúšťajú pri zásahu do teplej vyrovnávacej pamäte registra.