Changeset 52027 for trunk/src/wp-includes/post-thumbnail-template.php

Timestamp:

11/07/2021 07:27:45 PM (3 years ago)

Author:

antpb

Message:

Media: Add filter for post thumbnail url.

Introduces new filter post_thumbnail_url which allows overriding the default url returned from wp_get_attachement_image_url().

Props ibenic, SergeyBiryukov, jackreichert, audrasjb.
Fixes #40547.

File:

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

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

@@ -228 +228 @@
     }
 
-    return wp_get_attachment_image_url( $post_thumbnail_id, $size );
+    $thumbnail_url = wp_get_attachment_image_url( $post_thumbnail_id, $size );
+
+    /**
+     * Filters the post thumbnail URL.
+     *
+     * @since 5.9.0
+     *
+     * @param string|false     $thumbnail_url Post thumbnail URL or false if the post does not exist.
+     * @param int|WP_Post|null $post          Post ID or WP_Post object. Default is global `$post`.
+     * @param string|int[]     $size          Registered image size to retrieve the source for or a flat array
+     *                                        of height and width dimensions. Default 'post-thumbnail'.
+     */
+    return apply_filters( 'post_thumbnail_url', $thumbnail_url, $post, $size );
 }