mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-19 20:33:00 +02:00
62 lines
1.7 KiB
PHP
62 lines
1.7 KiB
PHP
|
<?php
|
||
|
/**
|
||
|
* Functions related to registering and parsing blocks.
|
||
|
*
|
||
|
* @package WordPress
|
||
|
* @subpackage Blocks
|
||
|
* @since 5.0.0
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* Determine whether a post or content string has blocks.
|
||
|
*
|
||
|
* 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.
|
||
|
*
|
||
|
* @since 5.0.0
|
||
|
* @see parse_blocks()
|
||
|
*
|
||
|
* @param int|string|WP_Post|null $post Optional. Post content, post ID, or post object. Defaults to global $post.
|
||
|
* @return bool Whether the post has blocks.
|
||
|
*/
|
||
|
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:' );
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* 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.
|
||
|
*
|
||
|
* @since 5.0.0
|
||
|
* @see parse_blocks()
|
||
|
*
|
||
|
* @param string $block_type Full Block type to look for.
|
||
|
* @param int|string|WP_Post|null $post Optional. Post content, post ID, or post object. Defaults to global $post.
|
||
|
* @return bool Whether the post content contains the specified block.
|
||
|
*/
|
||
|
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 . ' ' );
|
||
|
}
|