概述

本文档介绍了 image_sideload_extensions 过滤器，用于在从 URL 侧载图像时自定义允许的文件扩展名列表。默认支持 jpg、jpeg、jpe、png、gif 和 webp 格式。

关键要点

• image_sideload_extensions 是一个过滤器，允许开发者修改侧载图像时允许的文件扩展名数组。
• 默认允许的扩展名包括 jpg、jpeg、jpe、png、gif 和 webp，其中 webp 从 WordPress 5.8.0 版本开始添加。
• 过滤器接受两个参数：$allowed_extensions（允许的扩展名数组）和 $file（要下载的图像的 URL）。
• 此过滤器在 media_sideload_image() 函数中使用，该函数用于从 URL 下载图像并保存为附件。

代码示例

$allowed_extensions = apply_filters( 'image_sideload_extensions', $allowed_extensions, $file );

注意事项

• WordPress 5.6.0 版本引入了此过滤器，5.8.0 版本将 webp 添加到默认允许的扩展名列表中。
• 开发者可以通过添加或移除扩展名来自定义侧载图像的文件类型支持。