apply_filters( “render_block_{$this->name}”, string $block_content, array $block, WP_Block $instance )

User Contributed Notes

1. Skip to note 4 content

   Artemio Morales 2 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   If you’ve arrived here wondering why your image block with Expand on Click enabled contains lightbox markup that you seemingly can’t access from inside your filter function, here’s some extra information you might need:

   As of WordPress 6.4, please be aware that a built-in filter for the image block has been applied with priority 15 for images with Expand on Click. This means that if your filter has a priority of 15 or lower (the default is 10), then the markup used to create the lightbox behavior will NOT be available to your function for processing by default.

   Please make sure to use priority of at least 16 when adding filters to process the image block if you need to access the lightbox markup:

   add_filter( 'render_block_core/image', 'wpdocs_custom_html', 16 )

   See this issue for more details.
2. Skip to note 5 content

   Lovro Hrust 4 years ago

   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

   $block is array with keys:

   • blockName
   • attrs – array of block attributes
   • innerBlocks – array of inner blocks
   • innerHTML – resultant HTML from inside block comment delimiters after removing inner blocks.
   • innerContent – list of string fragments and null markers where inner blocks were found

   These keys are explained and referenced in WP_Block
3. Skip to note 6 content

   Brad Dalton 10 months ago

   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 core navigation block conditionally. Prepends content to the core navigation block.

   add_filter( 'render_block_core/navigation', 'wpdocs_modify_nav_menu_for_admins', 10, 2 );
   function wpdocs_modify_nav_menu_for_admins( $block_content, $block ) {
   
       if ( isset( $block['blockName'] ) && 'core/navigation' === $block['blockName'] ) {
   
           if ( is_user_logged_in() && current_user_can( 'administrator' ) ) {
   
               $custom_message = 'Welcome, Admin!';
               
               $block_content = $custom_message . $block_content;
           }
       }
   
       return $block_content;
   }