从指定的URL下载图像并将其附加到帖子。
media_sideload_image( string $file , int $post_id , string $desc = null, string $return = ‘html’ )
参数(Parameters)
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
$file | (string) | 必需 | 要下载的图像的URL。 |
$post_id | (int) | 可选 | 要与媒体关联的post ID。 |
$desc | (string) | 可选 | 图像的描述。 |
$return | (string) | 可选 | 接受“html”(图像标记html)或“src”(URL)或“id”(附件id)。 |
返回(Return)
(string|WP_Error)成功时填充了HTML img标记,否则为WP_Error对象。
更新版本 | 源码位置 | 使用 | 被使用 |
---|---|---|---|
5.4.0 | wp-admin/includes/media.php:980 | 0 | 9 |
笔记(Notes)
注意,这个函数的第三个值“description”实际上是附件的“TITLE”,而不是“description”。
默认用法
使用此函数从src中查找附件的ID