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

Timestamp:

02/08/2021 02:12:21 PM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Clarify the @return value for wp_get_attachment_image_url() and get_the_post_thumbnail_url().

Props GeekPress, audrasjb, naveen17797.
Fixes #52183.

File:

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

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

@@ -216 +216 @@
  *
  * @param int|WP_Post  $post Optional. Post ID or WP_Post object.  Default is global `$post`.
- * @param string|int[] $size Optional. Registered image size to retrieve the source for or a flat
- *                           array of height and width dimensions. Default 'post-thumbnail'.
- * @return string|false Post thumbnail URL or false if no URL is available.
+ * @param string|int[] $size Optional. Registered image size to retrieve the source for or a flat array
+ *                           of height and width dimensions. Default 'post-thumbnail'.
+ * @return string|false Post thumbnail URL or false if no image is available. If `$size` does not match
+ *                      any registered image size, the original image URL will be returned.
  */
 function get_the_post_thumbnail_url( $post = null, $size = 'post-thumbnail' ) {