Saltar al contenido

Hooks

Filtros y acciones disponibles para personalizar páginas, patrones, plantillas del sitio y el analizador HTML.

Analizador

blockstudio/block_tags/builders

Registra constructores de matrices de bloques que utilizan las etiquetas de bloque y los bloques personalizados asignados a elementos. La función de retorno de cada bloque recibe una matriz de atributos y el contenido interno sin procesar.

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 y blockstudio/parser/renderers reciben el mismo registro. Se ejecutan después de blockstudio/block_tags/builders, en ese orden, y pueden reemplazar un constructor anterior para el mismo bloque.

blockstudio/parser/element_mapping

Anula la asignación predeterminada de elementos HTML a bloques. De forma predeterminada, los elementos estándar de HTML, como <h1>, <p> y <img>, se asignan a bloques principales de WordPress. Usa este filtro para asignar cualquier elemento a otro bloque.

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

Si <p> asigna un bloque que no es principal y está registrado de Blockstudio, con un atributo de texto enriquecido content, su HTML interno se copia en ese atributo, incluidas las etiquetas en línea como code y img que también están asignadas a elementos. Un párrafo cuyo único elemento secundario es una imagen se convierte en el bloque al que asigna <img>. Las etiquetas de bloque anidadas o el HTML a nivel de bloque conservan el comportamiento normal de análisis de bloques internos.

Páginas

blockstudio/pages/paths

Filtra los directorios que se examinan para buscar plantillas 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 la antigüedad máxima de la caché del manifiesto anterior a 7.6.2 que puede inicializar el entorno de ejecución de la colección persistida durante una actualización. Las solicitudes normales usan la configuración persistida de la colección y no vuelven a examinar periódicamente las raíces de páginas. Ejecuta wp bs pages sync o llama a Blockstudio\Pages::reconcile() después de cambiar un manifiesto de colección.

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

blockstudio/pages/create_post_data

Filtra los datos de la entrada antes de crear una página nueva.

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 los datos de la entrada antes de actualizar una 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

Acción que se activa después de sincronizar todas las páginas.

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

blockstudio/pages/post_created

Acción que se activa después de crear una entrada 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

Acción que se activa después de actualizar una entrada de página.

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

Patrones

blockstudio/patterns/paths

Filtra los directorios que se examinan para buscar plantillas de patrones.

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

blockstudio/patterns/registered

Acción que se activa después de registrar todos los patrones.

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

Plantillas del sitio

blockstudio/site_templates/template_paths

Filtra los directorios que se examinan para buscar archivos de 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 los directorios que se examinan para buscar archivos de 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 conjuntamente ambas listas de rutas de descubrimiento. El valor contiene matrices de templates y parts.

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

blockstudio/site_templates/template_candidates

Filtra los archivos candidatos de origen después de resolver el manifiesto y el árbol lógico de origen.

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 las plantillas completas que devuelve el registro API.

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

blockstudio/site_templates/parts

Filtra las partes de plantilla que devuelve el registro API.

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

blockstudio/site_templates/template_content

Filtra una cadena de origen de plantilla antes de que Blockstudio la analice y la convierta en bloques.

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

blockstudio/site_templates/part_content

Filtra una cadena de origen de parte de plantilla antes de que Blockstudio la analice y la convierta en bloques.

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

blockstudio/site_templates/parser

Filtra la instancia de Blockstudio\Html_Parser que se utiliza para una plantilla o parte compilada. Devuelve un Html_Parser; los demás valores recurren al analizador predeterminado.

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

blockstudio/site_templates/discovered

Acción que se activa después de un ciclo de descubrimiento y compilación en frío, antes de guardar el registro reconstruido.

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

blockstudio/site_templates/registered

Acción que se activa después de guardar un registro reconstruido de plantillas del Editor del sitio basado en archivos.

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

Las acciones discovered y registered no se activan si se encuentra el registro en la caché activa.