Vai al contenuto

Hook

Filtri e azioni disponibili per personalizzare pagine, pattern, template del sito e il parser HTML.

Parser

blockstudio/block_tags/builders

Registra i builder di array di blocchi usati dai tag di blocco e dai blocchi personalizzati associati agli elementi. La callback di ogni blocco riceve un array di attributi e il contenuto interno grezzo.

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 e blockstudio/parser/renderers ricevono lo stesso registro. Vengono eseguiti dopo blockstudio/block_tags/builders, in quest’ordine, e possono sostituire un builder precedente per lo stesso blocco.

blockstudio/parser/element_mapping

Sovrascrive la mappatura predefinita da elemento HTML a blocco. Per impostazione predefinita, gli elementi standard HTML come <h1>, <p> e <img> vengono associati ai blocchi WordPress di base. Usate questo filtro per associare qualsiasi elemento a un blocco diverso.

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

Se <p> associa un elemento a un blocco Blockstudio non di base registrato con un attributo richtext content, il suo contenuto interno HTML viene copiato in quell’attributo, inclusi i tag inline come code e img che sono anch’essi associati a elementi. Un paragrafo il cui unico elemento figlio è un’immagine diventa il blocco a cui lo associa <img>. I tag di blocco annidati o gli elementi HTML a livello di blocco mantengono il normale comportamento di analisi dei blocchi interni.

Pagine

blockstudio/pages/paths

Filtra le directory analizzate per trovare i template di pagina.

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 l’età massima della cache di un manifesto legacy precedente a 7.6.2 che può inizializzare il runtime della raccolta persistita durante un aggiornamento. Le richieste normali usano la configurazione della raccolta persistita e non analizzano periodicamente le radici delle pagine. Eseguite wp bs pages sync o chiamate Blockstudio\Pages::reconcile() dopo aver modificato un manifesto della raccolta.

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

blockstudio/pages/create_post_data

Filtra i dati del post prima di creare una nuova pagina.

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 dati del post prima di aggiornare una pagina esistente.

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

blockstudio/pages/synced

Azione eseguita dopo la sincronizzazione di tutte le pagine.

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

blockstudio/pages/post_created

Azione eseguita dopo la creazione di un post di pagina.

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

blockstudio/pages/post_updated

Azione eseguita dopo l’aggiornamento di un post di pagina.

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

Pattern

blockstudio/patterns/paths

Filtra le directory analizzate per trovare i template dei pattern.

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

blockstudio/patterns/registered

Azione eseguita dopo la registrazione di tutti i pattern.

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

Template del sito

blockstudio/site_templates/template_paths

Filtra le directory analizzate per trovare i file 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 le directory analizzate per trovare i file 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 insieme entrambi gli elenchi dei percorsi di individuazione. Il valore contiene gli array templates e parts.

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

blockstudio/site_templates/template_candidates

Filtra i candidati file sorgente dopo aver risolto il manifesto e l’albero logico dei sorgenti.

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 template completi restituiti dal registro API.

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

blockstudio/site_templates/parts

Filtra le parti dei template restituite dal registro API.

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

blockstudio/site_templates/template_content

Filtra una stringa sorgente del template prima che Blockstudio la analizzi in blocchi.

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

blockstudio/site_templates/part_content

Filtra una stringa sorgente della parte del template prima che Blockstudio la analizzi in blocchi.

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

blockstudio/site_templates/parser

Filtra l’istanza Blockstudio\Html_Parser usata per un template o una parte compilati. Restituisce un Html_Parser; gli altri valori fanno ricadere sull’analizzatore predefinito.

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

blockstudio/site_templates/discovered

Azione eseguita dopo un passaggio a freddo di individuazione e compilazione, prima che il registro ricostruito venga salvato.

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

blockstudio/site_templates/registered

Azione eseguita dopo il salvataggio del registro ricostruito dei template dell’editor del sito basato su file.

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

Le azioni discovered e registered non vengono eseguite quando si usa una cache del registro già calda.