has_blocks() WordPress Function

The has_blocks() function checks whether a post or content has blocks. This can be useful for conditionally loading styles or scripts when a post has blocks.

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

Determines 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.

Top ↑

See also


Top ↑

Parameters

$post

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

Default value: null


Top ↑

Return

(bool) Whether the post has blocks.


Top ↑

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:' );
}


Top ↑

Changelog

Changelog
VersionDescription
5.0.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.