Pāriet uz saturu

Āķi

Filtri un darbības lapu, rakstu, vietnes veidņu un HTML parsētāja pielāgošanai.

Parsētājs

blockstudio/block_tags/builders

Reģistrējiet bloku masīvu veidotājus, ko izmanto bloku tagi un elementiem piesaistīti pielāgoti bloki. Katra bloka atzvanīšanas funkcija saņem atribūtu masīvu un neapstrādātu iekšējo saturu.

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 un blockstudio/parser/renderers saņem vienu un to pašu reģistru. Tie tiek izpildīti pēc blockstudio/block_tags/builders norādītajā secībā un var aizstāt agrāk reģistrētu tā paša bloka veidotāju.

blockstudio/parser/element_mapping

Mainiet noklusējuma HTML elementu un bloku kartējumu. Pēc noklusējuma standarta HTML elementi, piemēram, <h1>, <p> un <img>, tiek kartēti uz pamata WordPress blokiem. Izmantojiet šo filtru, lai jebkuru elementu piesaistītu citam blokam.

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

Ja <p> kartē uz reģistrētu bloku, kas nav pamata Blockstudio bloks ar atribūtu content, iekšējais HTML tiek kopēts uz šo atribūtu, tostarp iekļautie tagi, piemēram, code un img, kas arī ir kartēti pēc elementiem. Rindkopa, kuras vienīgais bērnelements ir attēls, kļūst par bloku, uz kuru kartē <img>. Ligzdoti bloku tagi vai bloka līmeņa HTML saglabā parasto iekšējo bloku parsēšanas darbību.

Lapas

blockstudio/pages/paths

Filtrējiet direktorijus, kuros tiek meklētas lapu veidnes.

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ējiet maksimālo vecumu mantotai, pirms 7.6.2 izveidotai manifesta kešatmiņai, kas jaunināšanas laikā var inicializēt saglabāto kolekciju izpildvidi. Parastie pieprasījumi izmanto saglabāto kolekcijas konfigurāciju un periodiski atkārtoti neskenē lapu saknes. Pēc kolekcijas manifesta maiņas palaidiet wp bs pages sync vai izsauciet Blockstudio\Pages::reconcile().

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

blockstudio/pages/create_post_data

Filtrējiet ziņas datus pirms jaunas lapas izveides.

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ējiet ziņas datus pirms esošas lapas atjaunināšanas.

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

blockstudio/pages/synced

Darbība tiek izpildīta pēc visu lapu sinhronizēšanas.

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

blockstudio/pages/post_created

Darbība tiek izpildīta pēc lapas ziņas izveides.

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

blockstudio/pages/post_updated

Darbība tiek izpildīta pēc lapas ziņas atjaunināšanas.

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

Raksti

blockstudio/patterns/paths

Filtrējiet direktorijus, kuros tiek meklētas rakstu veidnes.

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

blockstudio/patterns/registered

Darbība tiek izpildīta pēc visu rakstu reģistrēšanas.

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

Vietnes veidnes

blockstudio/site_templates/template_paths

Filtrējiet direktorijus, kuros tiek meklēti template.json faili.

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

blockstudio/site_templates/part_paths

Filtrējiet direktorijus, kuros tiek meklēti part.json faili.

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

blockstudio/site_templates/paths

Filtrējiet abus atklāšanas ceļu sarakstus kopā. Vērtība satur templates un parts masīvus.

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

blockstudio/site_templates/template_candidates

Filtrējiet avota failu kandidātus pēc manifesta un loģiskā avota koka noteikšanas.

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ējiet pilnās veidnes, ko atgriež reģistrs API.

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

blockstudio/site_templates/parts

Filtrējiet veidņu daļas, ko atgriež reģistrs API.

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

blockstudio/site_templates/template_content

Filtrējiet veidnes avota virkni, pirms Blockstudio to parsē blokos.

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

blockstudio/site_templates/part_content

Filtrējiet veidnes daļas avota virkni, pirms Blockstudio to parsē blokos.

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

blockstudio/site_templates/parser

Filtrējiet Blockstudio\Html_Parser instanci, ko izmanto vienai kompilētai veidnei vai tās daļai. Atgrieziet Html_Parser; citas vērtības liek izmantot noklusējuma parsētāju.

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

blockstudio/site_templates/discovered

Darbība tiek izpildīta pēc aukstās atklāšanas un kompilēšanas procesa, pirms atjaunotais reģistrs tiek saglabāts.

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

blockstudio/site_templates/registered

Darbība tiek izpildīta pēc tam, kad atjaunotais, failos balstītais vietnes redaktora veidņu reģistrs ir saglabāts.

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

Darbības discovered un registered netiek izpildītas, ja tiek izmantota siltā reģistra kešatmiņa.