has_blocks( int|string|WP_Post|null $post = null )

Determine whether a post or content string has blocks.

Description

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

See also

Parameters

$post

(int|string|WP_Post|null) (Optional) Post content, post ID, or post object. Defaults to global $post.

Default value: null

Return

(bool) Whether the post has blocks.

Source

File: wp-includes/blocks.php 

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

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

Uses

Uses Description
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.

Used By

Used By Description
wp-includes/blocks.php: block_version()

Returns the current version of the block format that the content string is using.
wp-includes/blocks.php: do_blocks()

Parses dynamic blocks out of post_content and re-renders them.
wp-includes/blocks.php: has_block()

Determine whether a $post or a string contains a specific block type.
wp-includes/class-wp-editor.php: _WP_Editors::parse_settings()

Parse default arguments for the editor instance.

Changelog

Version Description
5.0.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/has_blocks