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

Determine whether a post or content string has blocks.


Description 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 See also


Top ↑

Parameters Parameters

$post

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

Default value: null


Top ↑

Return Return

(bool) Whether the post has blocks.


Top ↑

Source Source

File: wp-includes/blocks.php

56
57
58
59
60
61
62
63
64
65
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

Changelog
Version Description
5.0.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.