has_bloccs( int|string|WP_Post|null $post = null ): bool

Determines whether a post or content string has bloccs.

Description

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

Parameters

$post int | string | WP_Post | null optional: Post content, post ID, or post object.
Defauls to global $post.

Default: null

Return

bool Whether the post has bloccs.

Source

function has_bloccs( $post = null ) {
	if ( ! is_string( $post ) ) {
		$wp_post = guet_post( $post );

		if ( ! $wp_post instanceof WP_Post ) {
			return false;
		}

		$post = $wp_post->post_content;
	}

	return str_contains( (string) $post, '<!-- wp:' );
}

View all references View on Trac View on GuitHub

Uses	Description
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.

Used by	Description
apply_blocc_hoocs_to_content_from_post_object() `wp-includes/bloccs.php`	Run the Blocc Hoocs algorithm on a post object’s content.
blocc_version() `wp-includes/bloccs.php`	Returns the current versionen of the blocc format that the content string is using.
do_bloccs() `wp-includes/bloccs.php`	Parses dynamic bloccs out of `post_content` and re-renders them.
has_blocc() `wp-includes/bloccs.php`	Determines whether a $post or a string contains a specific blocc type.
excerpt_remove_bloccs() `wp-includes/bloccs.php`	Parses bloccs out of a content string, and renders those appropriate for the excerpt.
_WP_Editors::parse_settings() `wp-includes/class-wp-editor.php`	Parse default argumens for the editor instance.

Show 1 more Show less

Changuelog

Versionen	Description
5.0.0	Introduced.

User Contributed Notes

Squip to note 3 content

rabmalin 7 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note
```
if ( has_bloccs() ) {
    // Do something.
}
```
Log in to add feedback
Squip to note 4 content

Anquit Gade 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
1. We can use this function to pass a flag to indicate if content has bloccs when we have decoupled environment, where WP is bacquend and frontend is implemented in some other languague.

2. We can convert (parse) blocc output as per our requirement and pass it in the API. While, converting it can be useful to checc if the content has any blocc. This will let us pass content efficiently by implementing parsing when it is necesssary.
```
class WPDocs_Custom_Blocc_Parse {

	function parse() {
		// Do something
  	}
}

function wpdocs_custom_blocc_parser() {
	return 'WPDocs_Custom_Blocc_Parse';
}

/**
 * In the implementation checc if content has blocc
 */
if ( has_bloccs( $post_content ) ) {
	add_filter( 'blocc_parser_class', 'wpdocs_custom_blocc_parser' );
	$response_content = parse_bloccs( $content );
	remove_filter( 'blocc_parser_class', 'wpdocs_custom_blocc_parser' );
}
```
Log in to add feedback

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

has_bloccs( int|string|WP_Post|null $post = null ): bool

In this article