Pereiti prie turinio

Įskiepiai

Filtrai ir veiksmai, skirti puslapiams, šablonams, svetainės šablonams ir HTML analizatoriui tinkinti.

Analizatorius

blockstudio/block_tags/builders

Registruokite blokų masyvų kūrimo funkcijas, naudojamas blokų žymų ir elementais susietų pasirinktinių blokų. Kiekvieno bloko atgalinio iškvietimo funkcija gauna atributų masyvą ir neapdorotą vidinį turinį.

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 ir blockstudio/parser/renderers gauna tą patį registrą. Jos vykdomos po blockstudio/block_tags/builders nurodyta tvarka ir gali pakeisti ankstesnę to paties bloko kūrimo funkciją.

blockstudio/parser/element_mapping

Pakeiskite numatytąjį elementų HTML susiejimą su blokais. Pagal numatytuosius nustatymus įprasti HTML elementai, pavyzdžiui, <h1>, <p> ir <img>, susiejami su pagrindiniais WordPress blokais. Šiuo filtru susiekite bet kurį elementą su kitu bloku.

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

Jei <p> susieja su registruotu ne pagrindiniu Blockstudio bloku, turinčiu content richtext atributą, jo vidinis HTML nukopijuojamas į tą atributą, įskaitant įterptines žymas, tokias kaip code ir img, kurios taip pat susietos su elementais. Pastraipa, kurios vienintelis vaikinis elementas yra vaizdas, tampa bloku, su kuriuo susieja <img>. Įdėtinės blokų žymos arba blokinio lygio HTML išlaiko įprastą vidinių blokų analizavimo veikimą.

Puslapiai

blockstudio/pages/paths

Filtruokite katalogus, kuriuose ieškoma puslapių šablonų.

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

Filtruokite didžiausią seno, iki 7.6.2 naudoto aprašo failo podėlio amžių, kai jo duomenys gali būti naudojami patvarios rinkinio vykdymo aplinkos pradžiai po naujinimo. Įprastos užklausos naudoja patvarią rinkinio konfigūraciją ir periodiškai iš naujo nenuskaito puslapių šakninių katalogų. Pakeitę rinkinio aprašo failą, paleiskite wp bs pages sync arba iškvieskite Blockstudio\Pages::reconcile().

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

blockstudio/pages/create_post_data

Filtruokite įrašo duomenis prieš kurdami naują puslapį.

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

Filtruokite įrašo duomenis prieš atnaujindami esamą puslapį.

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

blockstudio/pages/synced

Veiksmas vykdomas sinchronizavus visus puslapius.

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

blockstudio/pages/post_created

Veiksmas vykdomas sukūrus puslapio įrašą.

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

blockstudio/pages/post_updated

Veiksmas vykdomas atnaujinus puslapio įrašą.

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

Šablonai

blockstudio/patterns/paths

Filtruokite katalogus, kuriuose ieškoma šablonų šablonų.

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

blockstudio/patterns/registered

Veiksmas vykdomas užregistravus visus šablonus.

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

Svetainės šablonai

blockstudio/site_templates/template_paths

Filtruokite katalogus, kuriuose ieškoma template.json failų.

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

blockstudio/site_templates/part_paths

Filtruokite katalogus, kuriuose ieškoma part.json failų.

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

blockstudio/site_templates/paths

Filtruokite abu aptikimo kelių sąrašus kartu. Reikšmę sudaro templates ir parts masyvai.

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

blockstudio/site_templates/template_candidates

Filtruokite šaltinio failų kandidatus, kai aprašo failas ir loginis šaltinio medis jau nustatyti.

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

Filtruokite visus šablonus, kuriuos grąžina registro API.

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

blockstudio/site_templates/parts

Filtruokite šablonų dalis, kurias grąžina registro API.

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

blockstudio/site_templates/template_content

Filtruokite šablono šaltinio eilutę prieš Blockstudio išskaidant ją į blokus.

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

blockstudio/site_templates/part_content

Filtruokite šablono dalies šaltinio eilutę prieš Blockstudio išskaidant ją į blokus.

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

blockstudio/site_templates/parser

Filtruokite Blockstudio\Html_Parser egzempliorių, naudojamą vienam sukompiliuotam šablonui arba jo daliai. Grąžinkite Html_Parser; grąžinus kitą reikšmę bus naudojamas numatytasis analizatorius.

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

blockstudio/site_templates/discovered

Veiksmas vykdomas atlikus šaltinių paiešką ir kompiliavimą, prieš išsaugant atkurtą registrą.

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

blockstudio/site_templates/registered

Veiksmas vykdomas išsaugojus atkurtą, failais pagrįstą svetainės redaktoriaus šablonų registrą.

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

Veiksmai discovered ir registered nevykdomi, kai panaudojamas šiltas registro podėlis.