Changeset 59700 for trunk/src/wp-includes/post.php

Timestamp:

01/24/2025 01:30:27 PM (4 months ago)

Author:

swissspidy

Message:

Posts, Post Types: Embeds: Add new embeddable argument to post types.

This new argument, which defaults to the value of public, can be used to determine whether a post can be embedded using oEmbed. A new is_post_embeddable() function is added to easily check this.

Props pampfelimetten, swissspidy, bradleyt, DrewAPicture, gadelhas, mukesh27.
Fixes #35567.

File:

• trunk/src/wp-includes/post.php (modified) (1 diff)

trunk/src/wp-includes/post.php

@@ -2477 +2477 @@
 
 /**
+ * Determines whether a post is embeddable.
+ *
+ * @since 6.8.0
+ *
+ * @param int|WP_Post|null $post Optional. Post ID or `WP_Post` object. Defaults to global $post.
+ * @return bool Whether the post should be considered embeddable.
+ */
+function is_post_embeddable( $post = null ) {
+    $post = get_post( $post );
+
+    if ( ! $post ) {
+        return false;
+    }
+
+    $post_type = get_post_type_object( $post->post_type );
+
+    if ( ! $post_type ) {
+        return false;
+    }
+
+    $is_embeddable = $post_type->embeddable;
+
+    /**
+     * Filter whether a post is embeddable.
+     *
+     * @since 6.8.0
+     *
+     * @param bool    $is_embeddable Whether the post is embeddable.
+     * @param WP_Post $post          Post object.
+     */
+    return apply_filters( 'is_post_embeddable', $is_embeddable, $post );
+}
+
+/**
  * Retrieves an array of the latest posts, or posts matching the given criteria.
  *