描述
URL可能是原始图像,也可能是调整尺寸的版本。此函数不会创建一个新的调整尺寸的副本,它只会返回一个已调整尺寸的拷贝(如果存在)。
插件可以使用‘image_downsize’过滤器连接到图像并提供图片尺寸调整服务。钩子必须返回一个数组,该数组包含通常从函数返回的元素。
参数
- $id
-
(int)(必填) 图片附件ID。
- $size
-
(string|int[])(可选) 图像尺寸。接受任何已注册的图片尺寸名称,或以像素为单位的宽度和高度值数组(按该顺序)。
默认值: 'medium'
返回
(array|false) 图像数据数组,如果没有图像可用,则为布尔false。
- (string) 图片源URL。
- '1'
(int) 以像素为单位的图片宽度。 - '2'
(int) 以像素为单位的图片高度。 - '3'
(bool) 图片是否是调整尺寸的图片。
源码
更新日志
版本 | 描述 |
---|---|
2.5.0 | 开始引入 |
使用示例
添加选择媒体附件图像的函数
也许你已经知道wp_get_attachment_thumb_url();。现在,我将演示如何执行相同的操作来返回中等大小附件的url。
function wp_get_attachment_medium_url( $id ) { $medium_array = image_downsize( $id, 'medium' ); $medium_path = $medium_array[0]; return $medium_path; }
$id是附件的ID。这对于像WP Choose Thumb这样的插件非常有用。使用此功能,您可以获得中等大小的预览。