Treci la conținut

Cârlige

Filtre și acțiuni disponibile pentru personalizarea paginilor, modelelor, Site Templates și a parserului HTML.

Parser

blockstudio/block_tags/builders

Înregistrează constructorii de matrice de blocuri utilizați de etichetele de bloc și de blocurile personalizate mapate la elemente. Callback-ul fiecărui bloc primește o matrice de atribute și conținutul interior brut.

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 și blockstudio/parser/renderers primesc același registru. Se execută după blockstudio/block_tags/builders, în această ordine, și pot înlocui un constructor anterior pentru același bloc.

blockstudio/parser/element_mapping

Suprascrie maparea implicită dintre elementul HTML și bloc. În mod implicit, elemente HTML standard precum <h1>, <p> și <img> sunt mapate la blocuri WordPress de bază. Folosiți acest filtru pentru a direcționa orice element către un alt bloc.

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

Dacă <p> mapează la un bloc Blockstudio non-core înregistrat, cu un atribut richtext content, conținutul interior HTML este copiat în acel atribut, inclusiv etichetele inline precum code și img, care sunt și ele mapate la elemente. Un paragraf al cărui singur copil este o imagine devine blocul către care mapează <img>. Etichetele de bloc imbricate sau elementele HTML la nivel de bloc păstrează comportamentul normal de analizare a blocurilor interioare.

Pagini

blockstudio/pages/paths

Filtrați directoarele scanate pentru șabloanele de pagină.

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

Filtrați vechimea maximă a unei memorii cache pentru manifestul anterior versiunii 7.6.2, care poate inițializa colecția persistentă a mediului de execuție în timpul unui upgrade. Cererile obișnuite folosesc configurația persistentă a colecției și nu rescanează periodic rădăcinile paginilor. Rulați wp bs pages sync sau apelați Blockstudio\Pages::reconcile() după ce modificați un manifest al colecției.

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

blockstudio/pages/create_post_data

Filtrați datele postării înainte de a crea o pagină nouă.

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

Filtrați datele postării înainte de a actualiza o pagină existentă.

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

blockstudio/pages/synced

Acțiune declanșată după sincronizarea tuturor paginilor.

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

blockstudio/pages/post_created

Acțiune declanșată după crearea unei postări de pagină.

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

blockstudio/pages/post_updated

Acțiune declanșată după actualizarea unei postări de pagină.

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

Modele

blockstudio/patterns/paths

Filtrați directoarele scanate pentru șabloanele de modele.

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

blockstudio/patterns/registered

Acțiune declanșată după înregistrarea tuturor modelelor.

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

Șabloane de site

blockstudio/site_templates/template_paths

Filtrați directoarele scanate pentru fișierele 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

Filtrați directoarele scanate pentru fișierele part.json.

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

blockstudio/site_templates/paths

Filtrați împreună ambele liste de căi pentru descoperire. Valoarea conține matricele templates și parts.

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

blockstudio/site_templates/template_candidates

Filtrați candidații pentru fișierele sursă după ce au fost rezolvate manifestul și arborele logic al sursei.

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

Filtrați șabloanele complete returnate de registrul API.

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

blockstudio/site_templates/parts

Filtrați părțile de șablon returnate de registrul API.

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

blockstudio/site_templates/template_content

Filtrați șirul sursă al unui șablon înainte ca Blockstudio să îl analizeze și să îl transforme în blocuri.

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

blockstudio/site_templates/part_content

Filtrați șirul sursă al unei părți de șablon înainte ca Blockstudio să îl analizeze și să îl transforme în blocuri.

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

blockstudio/site_templates/parser

Filtrați instanța Blockstudio\Html_Parser utilizată pentru compilarea unui singur șablon sau a unei părți. Returnați un Html_Parser; celelalte valori folosesc analizorul implicit.

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

blockstudio/site_templates/discovered

Acțiune declanșată după o rundă de descoperire și compilare la rece, înainte ca registrul reconstruit să fie stocat.

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

blockstudio/site_templates/registered

Acțiune declanșată după stocarea registrului reconstruit de șabloane ale editorului de site, bazat pe fișiere.

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

Acțiunile discovered și registered nu se declanșează când există o intrare în memoria cache a registrului activ.