Ugrás a tartalomhoz

Hookok

Az oldalak, minták, webhelysablonok és az HTML elemző testreszabására szolgáló szűrők és műveletek.

Elemző

blockstudio/block_tags/builders

Regisztrálja a blokktagek és az elemekhez rendelt egyéni blokkok által használt blokk-tömbépítőket. Minden blokk visszahívási függvénye egy attribútumtömböt és nyers belső tartalmat kap.

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 és blockstudio/parser/renderers ugyanazt a regisztert kapja meg. A blockstudio/block_tags/builders után, ebben a sorrendben futnak le, és lecserélhetik ugyanazon blokk korábban regisztrált építőjét.

blockstudio/parser/element_mapping

Felülírja az alapértelmezett HTML elem–blokk megfeleltetést. Alapértelmezés szerint a szabványos HTML elemek, például a <h1>, a <p> és a <img>, alapvető WordPress blokkokhoz vannak rendelve. Ezzel a szűrővel bármelyik elemet másik blokkhoz rendelheti.

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

Ha a <p> egy regisztrált, nem alapvető Blockstudio blokkhoz van rendelve, amelynek van content richtext attribútuma, akkor a belső HTML tartalma átkerül ebbe az attribútumba, beleértve az olyan inline tageket is, mint a code és a img, amelyek szintén elemekhez vannak rendelve. Az a bekezdés, amelynek egyetlen gyermeke egy kép, azzá a blokkká válik, amelyhez a <img> van rendelve. A beágyazott blokktagek és a blokk szintű HTML elemek megőrzik a szokásos belső blokkfeldolgozási viselkedést.

Oldalak

blockstudio/pages/paths

Megszűri az oldal sablonjaihoz beolvasott könyvtárakat.

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

Megszűri annak az örökölt, 7.6.2 előtti jegyzékgyorsítótárnak a maximális korát, amely frissítéskor inicializálhatja a tartós gyűjtemény-futtatókörnyezetet. A szokásos kérések a tartós gyűjtemény-konfigurációt használják, és nem olvassák be rendszeresen újra az oldalgyökereket. Gyűjteményjegyzék módosítása után futtassa a wp bs pages sync parancsot, vagy hívja meg a Blockstudio\Pages::reconcile() függvényt.

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

blockstudio/pages/create_post_data

Megszűri a bejegyzés adatait az új oldal létrehozása előtt.

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

Megszűri a bejegyzés adatait egy meglévő oldal frissítése előtt.

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

blockstudio/pages/synced

Az összes oldal szinkronizálása után lefutó művelet.

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

blockstudio/pages/post_created

Az oldalbejegyzés létrehozása után lefutó művelet.

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

blockstudio/pages/post_updated

Az oldalbejegyzés frissítése után lefutó művelet.

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

Minták

blockstudio/patterns/paths

Megszűri a mintasablonokhoz beolvasott könyvtárakat.

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

blockstudio/patterns/registered

Az összes minta regisztrálása után lefutó művelet.

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

Webhely sablonjai

blockstudio/site_templates/template_paths

Megszűri a template.json fájlokhoz beolvasott könyvtárakat.

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

blockstudio/site_templates/part_paths

Megszűri a part.json fájlokhoz beolvasott könyvtárakat.

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

blockstudio/site_templates/paths

Együttesen megszűri mindkét felderítési útvonal listáját. Az érték templates és parts tömböt tartalmaz.

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

blockstudio/site_templates/template_candidates

Megszűri a forrásfájl-jelölteket a jegyzék és a logikai forrásfa feloldása után.

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

Megszűri a regiszter API által visszaadott teljes sablonokat.

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

blockstudio/site_templates/parts

Megszűri a regiszter API által visszaadott sablonrészeket.

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

blockstudio/site_templates/template_content

Megszűri a sablon forrásszövegét, mielőtt a Blockstudio blokkokká dolgozza fel.

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

blockstudio/site_templates/part_content

Megszűri a sablonrész forrásszövegét, mielőtt a Blockstudio blokkokká dolgozza fel.

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

blockstudio/site_templates/parser

Megszűri az egyetlen lefordított sablonhoz vagy sablonrészhez használt Blockstudio\Html_Parser példányt. Adjon vissza egy Html_Parser értéket; más érték esetén az alapértelmezett elemző lép működésbe.

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

blockstudio/site_templates/discovered

A hideg felderítési és fordítási menet után, az újraépített regiszter mentése előtt lefutó művelet.

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

blockstudio/site_templates/registered

Az újraépített, fájlalapú Site Editor-sablonregiszter mentése után lefutó művelet.

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

A discovered és a registered művelet nem fut le meleg regisztergyorsítótár-találat esetén.