diff --git a/wp-includes/post.php b/wp-includes/post.php index a7e8ab49d7..8647c7f0f9 100644 --- a/wp-includes/post.php +++ b/wp-includes/post.php @@ -705,35 +705,34 @@ function create_initial_post_types() { /** * Retrieves attached file path based on attachment ID. * - * Will return intermediate size path if $size param is provided. + * Will return intermediate size path if the `$size` parameter is provided. * - * By default the path will go through the 'get_attached_file' filter, but - * passing a true to the $unfiltered argument of get_attached_file() will - * return the file path unfiltered. + * By default the path will go through the {@see 'get_attached_file'} filter, but + * passing `true` to the `$unfiltered` argument will return the file path unfiltered. * - * The function works by getting the single post meta name, named - * '_wp_attached_file' and returning it. This is a convenience function to - * prevent looking up the meta name and provide a mechanism for sending the - * attached filename through a filter. + * The function works by retrieving the `_wp_attached_file` post meta value. + * This is a convenience function to prevent looking up the meta name and provide + * a mechanism for sending the attached filename through a filter. * * @since 2.0.0 - * @since 6.2 The `$size` parameter was added + * @since 6.2.0 The `$size` parameter was added. * * @param int $attachment_id Attachment ID. - * @param bool $unfiltered Optional. Whether to apply filters. Default false. + * @param bool $unfiltered Optional. Whether to skip the {@see 'get_attached_file'} filter. + * Default false. * @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array - * of width and height values in pixels (in that order). Default ''. - * + * of width and height values in pixels (in that order). Default empty string. * @return string|false The file path to where the attached file should be, false otherwise. */ function get_attached_file( $attachment_id, $unfiltered = false, $size = '' ) { - // Check for intermediate sizes first, otherwise fallback to original attachment size + // Check for intermediate sizes first, otherwise fall back to the original attachment size. if ( ! empty( $size ) ) { $intermediate_image = image_get_intermediate_size( $attachment_id, $size ); if ( ! $intermediate_image || ! isset( $intermediate_image['path'] ) ) { return false; } + $file = $intermediate_image['path']; } else { $file = get_post_meta( $attachment_id, '_wp_attached_file', true ); diff --git a/wp-includes/version.php b/wp-includes/version.php index ac9691cef7..c868c5b758 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -16,7 +16,7 @@ * * @global string $wp_version */ -$wp_version = '6.2-alpha-55201'; +$wp_version = '6.2-alpha-55202'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.