Make WordPress Core


Ignore:
Timestamp:
02/20/2024 09:25:09 AM (3 months ago)
Author:
swissspidy
Message:

Block Hooks: Introduce a new hooked_block filter.

This is a counterpart to the dynamic hooked_block_{$block_type} filter introduced in [57354],
which makes it easier to modify all hooked blocks prior to insertion.

Also adds the hooked block type as an additional argument to both filters for consistency.

Props bernhard-reiter, swissspidy.
Fixes #60574.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/blocks.php

    r57644 r57660  
    896896         * Filters the parsed block array for a given hooked block.
    897897         *
     898         * @since 6.5.0
     899         *
     900         * @param array                           $parsed_hooked_block The parsed block array for the given hooked block type.
     901         * @param string                          $hooked_block_type   The hooked block type name.
     902         * @param string                          $relative_position   The relative position of the hooked block.
     903         * @param array                           $parsed_anchor_block The anchor block, in parsed block array format.
     904         * @param WP_Block_Template|WP_Post|array $context             The block template, template part, `wp_navigation` post type,
     905         *                                                             or pattern that the anchor block belongs to.
     906         */
     907        $parsed_hooked_block = apply_filters( 'hooked_block', $parsed_hooked_block, $hooked_block_type, $relative_position, $parsed_anchor_block, $context );
     908
     909        /**
     910         * Filters the parsed block array for a given hooked block.
     911         *
    898912         * The dynamic portion of the hook name, `$hooked_block_type`, refers to the block type name of the specific hooked block.
    899913         *
     
    901915         *
    902916         * @param array                           $parsed_hooked_block The parsed block array for the given hooked block type.
     917         * @param string                          $hooked_block_type   The hooked block type name.
    903918         * @param string                          $relative_position   The relative position of the hooked block.
    904919         * @param array                           $parsed_anchor_block The anchor block, in parsed block array format.
     
    906921         *                                                             or pattern that the anchor block belongs to.
    907922         */
    908         $parsed_hooked_block = apply_filters( "hooked_block_{$hooked_block_type}", $parsed_hooked_block, $relative_position, $parsed_anchor_block, $context );
    909 
    910         // It's possible that the `hooked_block_{$hooked_block_type}` filter returned a block of a different type,
    911         // so we explicitly look for the original `$hooked_block_type` in the `ignoredHookedBlocks` metadata.
     923        $parsed_hooked_block = apply_filters( "hooked_block_{$hooked_block_type}", $parsed_hooked_block, $hooked_block_type, $relative_position, $parsed_anchor_block, $context );
     924
     925        // It's possible that the filter returned a block of a different type, so we explicitly
     926        // look for the original `$hooked_block_type` in the `ignoredHookedBlocks` metadata.
    912927        if (
    913928            ! isset( $parsed_anchor_block['attrs']['metadata']['ignoredHookedBlocks'] ) ||
Note: See TracChangeset for help on using the changeset viewer.