lzb/block_render/callback

Takes over the whole block output from PHP, which is what a block whose markup is too involved for Handlebars or the block builder's code editor needs.

$result arrives as null. Return anything else and Lazy Blocks skips the block's own code entirely, the theme template, the PHP output and the Handlebars template all included, and carries your string on to the wrapper handling. Return null and the block renders normally, which makes this the place to override one block without disturbing the rest. The check is is_block_content_exists(), so an empty string counts as no output and the block's own code still runs.

Attributes

Additional Filters

The per-location variants take two arguments only.

Usage

function my_lzb_block_render_callback( $result, $attributes, $render_location, $context ) {
  // Render the latest posts block from PHP, and show a placeholder in the
  // editor instead of running the query on every keystroke.
  if ( 'lazyblock/latest-posts' !== $attributes['lazyblock']['slug'] ) {
    return $result;
  }
 
  if ( 'editor' === $render_location ) {
    return '<div useBlockProps>Latest posts render on the front end.</div>';
  }
 
  $posts = get_posts( array( 'numberposts' => (int) $attributes['count'] ) );
  $items = '';
 
  foreach ( $posts as $post ) {
    $items .= '<li><a href="' . esc_url( get_permalink( $post ) ) . '">' . esc_html( $post->post_title ) . '</a></li>';
  }
 
  return '<ul useBlockProps>' . $items . '</ul>';
}
 
add_filter( 'lzb/block_render/callback', 'my_lzb_block_render_callback', 10, 4 );

The string is not escaped for you, so escape every value you interpolate. Include a useBlockProps attribute on your outer tag, as above. Without one, Lazy Blocks wraps the output in a <div useBlockProps> of its own, and that div, rather than your element, is what carries the block's classes, anchor and alignment on the front end. On the front end a block that returns nothing here and has no code of its own renders as nothing at all, and WordPress emits no wrapper for it.

Returning markup from the block builder instead is covered in PHP Callback.