Changeset 51046 for trunk/src/wp-includes/blocks.php

Timestamp:

05/29/2021 06:41:09 PM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Document that has_block() does not check reusable blocks.

Since the function only checks the raw, non-parsed post content, reusable blocks are just a core/block type and nothing more at that point.

In order to also check reusable blocks, the content needs to be parsed using parse_blocks() first.

Props vyskoczilova, peterwilsoncc.
Fixes #53140.

File:

• trunk/src/wp-includes/blocks.php (modified) (3 diffs)

trunk/src/wp-includes/blocks.php

@@ -375 +375 @@
  * @see parse_blocks()
  *
- * @param int|string|WP_Post|null $post Optional. Post content, post ID, or post object. Defaults to global $post.
+ * @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.
  */
@@ -393 +394 @@
  *
  * 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.
+ * whether the block type exists but not validating its structure and not checking
+ * reusable blocks. For strict accuracy, you should use the block parser on post content.
  *
  * @since 5.0.0
@@ -400 +401 @@
  * @see parse_blocks()
  *
- * @param string                  $block_name 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.
+ * @param string                  $block_name 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.
  */