WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

render_block_data

apply_filters( ‘render_block_data’, array $parsed_block, array $source_block, WP_Block|null $parent_block )

In this article

Back to top

Filters the block being rendered in render_block() , before it’s processed.

Parameters

$parsed_blockarray
An associative array of the block being rendered. See WP_Block_Parser_Block.
  • blockName string|null
    Name of block.
  • attrs array
    Attributes from block comment delimiters.
  • innerBlocks array[]
    List of inner blocks. An array of arrays that have the same structure as this one.
  • innerHTML string
    HTML from inside block comment delimiters.
  • innerContent array
    List of string fragments and null markers where inner blocks were found.
$source_blockarray
An un-modified copy of $parsed_block, as it appeared in the source content.
See WP_Block_Parser_Block.
  • blockName string|null
    Name of block.
  • attrs array
    Attributes from block comment delimiters.
  • innerBlocks array[]
    List of inner blocks. An array of arrays that have the same structure as this one.
  • innerHTML string
    HTML from inside block comment delimiters.
  • innerContent array
    List of string fragments and null markers where inner blocks were found.
$parent_blockWP_Block|null
If this is a nested block, a reference to the parent block.

Source

$parsed_block = apply_filters( 'render_block_data', $parsed_block, $source_block, $parent_block );

View all references View on Trac View on GitHub

Used byDescription
WP_Block::render()wp-includes/class-wp-block.php

Generates the render output for the block.

render_block()wp-includes/blocks.php

Renders a single block into a HTML string.

Changelog

VersionDescription
5.9.0The $parent_block parameter was added.
5.1.0Introduced.

User Contributed Notes

  1. Skip to note 4 content
    Khokan Sardar
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Filter post content block and add custom classes for every post content block wrapper dynamically before render on template.

    /**
 * Filters the parsed block being rendered in render_block(), before it's processed.
 *
 * @param array  $parsed_block The block being rendered.
 * @return array $parsed_block Modified block.
 */
function wpdocs_modify_render_block_data( $parsed_block ) {

    // Do check first its Post Content block or not.
    if ( ! empty( $parsed_block['blockName'] ) && 'core/post-content' === $parsed_block['blockName'] ) {
        $block_attributes = $parsed_block['attrs'];

        // Set custom class for post content block.
        $post_content_classe           = 'wpdocs-content-wrap';
        $block_attributes['className'] = $post_content_classe;
        
        $parsed_block['attrs'] = $block_attributes;
    }

    return $parsed_block;
}
add_filter( 'render_block_data', 'wpdocs_modify_render_block_data' );
  2. Skip to note 5 content
    DragBlock.Com
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Here is the structure of the $parsed_block

    $parsed_block = array(
    'blockName' => 'dragblock/link',
    'attrs' => array(),

    // child
    'innerBlocks' => array(
        array(
            'blockName' => 'dragblock/text',
            'attrs' => array(),
            'innerBlocks' => array(),
            'innerHTML' => '<span class="wp-block-dragblock-text"></span>',
            'innerContent' => array(
                '<span class="wp-block-dragblock-text"></span>'
            )
        )
    ),

    // your current block output html without child blocks
    'innerHTML' => '<a class="wp-block-dragblock-link"></a>', 

    // your current block output html items without child blocks
    'innerContent' => array(
        '<a class="wp-block-dragblock-link">',
        null,
        '</a>'
    )
);
  3. Skip to note 6 content
    Pilar Mera
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Filter the Image core block to disable the “Enlarge on click” (lightbox) feature on the RSS feeds. This will remove the lightbox markup from the feed, including the Enlarge button, as it won’t work on the readers.


    // Disable lightbox ("Enlarge on click") markup for images on the feeds
    function wpdocs_disable_images_lightbox_on_feeds( $parsed_block ) {
    if ( ! is_feed() ) {
    return $parsed_block;
    }

    if ( 'core/image' === $parsed_block['blockName'] ) {
    $parsed_block['attrs']['lightbox'] = false;
    }

    return $parsed_block;
    }
    add_filter( 'render_block_data', 'wpdocs_disable_images_lightbox_on_feeds' );

You must log in before being able to contribute a note or feedback.