Pular para o conteúdo

Ganchos

Filtros e ações disponíveis para personalizar páginas, padrões, modelos do site e o analisador HTML.

Analisador

blockstudio/block_tags/builders

Registra construtores de arrays de blocos usados por tags de bloco e blocos personalizados mapeados por elemento. O callback de cada bloco recebe um array de atributos e o conteúdo interno bruto.

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 recebem o mesmo registro. São executados depois de blockstudio/block_tags/builders, nessa ordem, e podem substituir um construtor anterior para o mesmo bloco.

blockstudio/parser/element_mapping

Substitui o mapeamento padrão de elementos HTML para blocos. Por padrão, elementos HTML padrão, como <h1>, <p> e <img>, são mapeados para blocos WordPress principais. Use este filtro para direcionar qualquer elemento a um bloco diferente.

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> mapear para um bloco Blockstudio não principal registrado com um atributo content richtext, seu HTML interno será copiado para esse atributo, incluindo tags inline como code e img que também sejam mapeadas por elemento. Um parágrafo cujo único filho seja uma imagem se torna o bloco para o qual <img> mapeia. Tags de bloco aninhadas ou HTML de nível de bloco mantêm o comportamento normal de análise de blocos internos.

Páginas

blockstudio/pages/paths

Filtra os diretórios verificados em busca de modelos de página.

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 a idade máxima do cache de manifesto legado anterior a 7.6.2 que pode inicializar o runtime de coleção persistido durante uma atualização. As solicitações normais usam a configuração de coleção persistida e não verificam periodicamente as raízes das páginas. Execute wp bs pages sync ou chame Blockstudio\Pages::reconcile() depois de alterar um manifesto de coleção.

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

blockstudio/pages/create_post_data

Filtra os dados da publicação antes de criar uma nova página.

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 os dados da publicação antes de atualizar uma página existente.

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

blockstudio/pages/synced

Ação disparada após a sincronização de todas as páginas.

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

blockstudio/pages/post_created

Ação disparada após a criação de uma publicação de página.

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

blockstudio/pages/post_updated

Ação disparada após a atualização de uma publicação de página.

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

Padrões

blockstudio/patterns/paths

Filtra os diretórios verificados em busca de modelos de padrão.

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

blockstudio/patterns/registered

Ação disparada após o registro de todos os padrões.

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

Modelos do site

blockstudio/site_templates/template_paths

Filtra os diretórios verificados em busca de arquivos 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 os diretórios verificados em busca de arquivos 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 juntas as duas listas de caminhos de descoberta. O valor contém arrays templates e parts.

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

blockstudio/site_templates/template_candidates

Filtra os candidatos a arquivos de origem depois que o manifesto e a árvore lógica de origem forem resolvidos.

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 os modelos completos retornados pelo registro API.

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

blockstudio/site_templates/parts

Filtra as partes de modelo retornadas pelo registro API.

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

blockstudio/site_templates/template_content

Filtra uma string de origem de modelo antes de Blockstudio analisá-la em blocos.

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

blockstudio/site_templates/part_content

Filtra uma string de origem de parte de modelo antes de Blockstudio analisá-la em blocos.

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

blockstudio/site_templates/parser

Filtra a instância de Blockstudio\Html_Parser usada para um modelo ou parte compilado. Retorne um Html_Parser; outros valores usam o analisador padrão.

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

blockstudio/site_templates/discovered

Ação disparada após uma passagem de descoberta e compilação a frio, antes de o registro reconstruído ser persistido.

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

blockstudio/site_templates/registered

Ação disparada após a persistência de um registro reconstruído de modelos do Editor do Site baseado em arquivos.

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

As ações discovered e registered não são disparadas quando há um acerto no cache de registro aquecido.