Changeset 51894 for trunk/src/wp-includes/blocks.php

Timestamp:

10/06/2021 06:47:09 PM (4 years ago)

Author:

azaozz

Message:

Apply the pre_render_block, render_block_data, and render_block_context filters when rendering inner/nested blocks. Introdices another param to these filters: $parent_block that is the "parent" WP_Block instance for nested blocks and null for top level blocks. Adds unit tests for the filters.

Props noisysocks, gaambo, azaozz.
Fixes #51612.

File:

• trunk/src/wp-includes/blocks.php (modified) (4 diffs)

trunk/src/wp-includes/blocks.php

@@ -814 +814 @@
 function render_block( $parsed_block ) {
     global $post;
+    $parent_block = null;
 
     /**
@@ -820 +821 @@
      * @since 5.1.0
      *
-     * @param string|null $pre_render   The pre-rendered content. Default null.
-     * @param array       $parsed_block The block being rendered.
+     * @param string|null   $pre_render   The pre-rendered content. Default null.
+     * @param array         $parsed_block The block being rendered.
+     * @param WP_Block|null $parent_block If this is a nested block, a reference to the parent block.
      */
-    $pre_render = apply_filters( 'pre_render_block', null, $parsed_block );
+    $pre_render = apply_filters( 'pre_render_block', null, $parsed_block, $parent_block );
     if ( ! is_null( $pre_render ) ) {
         return $pre_render;
@@ -835 +837 @@
      * @since 5.1.0
      *
-     * @param array $parsed_block The block being rendered.
-     * @param array $source_block An un-modified copy of $parsed_block, as it appeared in the source content.
+     * @param array         $parsed_block The block being rendered.
+     * @param array         $source_block An un-modified copy of $parsed_block, as it appeared in the source content.
+     * @param WP_Block|null $parent_block If this is a nested block, a reference to the parent block.
      */
-    $parsed_block = apply_filters( 'render_block_data', $parsed_block, $source_block );
+    $parsed_block = apply_filters( 'render_block_data', $parsed_block, $source_block, $parent_block );
 
     $context = array();
@@ -859 +862 @@
      * @since 5.5.0
      *
-     * @param array $context      Default context.
-     * @param array $parsed_block Block being rendered, filtered by `render_block_data`.
+     * @param array         $context      Default context.
+     * @param array         $parsed_block Block being rendered, filtered by `render_block_data`.
+     * @param WP_Block|null $parent_block If this is a nested block, a reference to the parent block.
      */
-    $context = apply_filters( 'render_block_context', $context, $parsed_block );
+    $context = apply_filters( 'render_block_context', $context, $parsed_block, $parent_block );
 
     $block = new WP_Block( $parsed_block, $context );