Changeset 52028

Timestamp:

11/07/2021 08:36:11 PM (3 years ago)

Author:

antpb

Message:

Media: Add filter for post thumbnail id.

Introduces new filter post_thumbnail_id which allows overriding the default id returned from get_post_thumbnail_id().

Props engelen, alexvorn2, gilbitron, sebastianpisula, SergeyBiryukov, leogermani, rzen, joemcgill, audrasjb.
Fixes #23983.

File:

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

trunk/src/wp-includes/post-thumbnail-template.php

@@ -58 +58 @@
     }
 
-    return (int) get_post_meta( $post->ID, '_thumbnail_id', true );
+    $thumbnail_id = (int) get_post_meta( $post->ID, '_thumbnail_id', true );
+
+    /**
+     * Filters post thumbnail ID.
+     *
+     * @since 5.9.0
+     *
+     * @param int|false        $thumbnail_id Post thumbnail ID or false if the post does not exist.
+     * @param int|WP_Post|null $post         Post ID or WP_Post object. Default is global `$post`.
+     */
+    return (int) apply_filters( 'post_thumbnail_id', $thumbnail_id, $post );
 }