A WordPress-centric search engine for devs and theme authors



has_block ›

Since5.0.0
Deprecatedn/a
has_block ( $block_type, $post = null )
Parameters: (2)
  • (string) $block_type Full Block type to look for.
    Required: Yes
  • (int|string|WP_Post|null) $post Optional. Post content, post ID, or post object. Defaults to global $post.
    Required: No
    Default: null
See:
Returns:
  • (bool) Whether the post content contains the specified block.
Defined at:
Codex:

Determine whether a $post or a string contains a specific block type.

This test optimizes for performance rather than strict accuracy, detecting the block type exists but not validating its structure. For strict accuracy, you should use the block parser on post content.



Source

function has_block( $block_type, $post = null ) {
	if ( ! has_blocks( $post ) ) {
		return false;
	}

	if ( ! is_string( $post ) ) {
		$wp_post = get_post( $post );
		if ( $wp_post instanceof WP_Post ) {
			$post = $wp_post->post_content;
		}
	}

	return false !== strpos( $post, '<!-- wp:' . $block_type . ' ' );
}