钩子文档

wp_get_missing_image_subsizes

💡 云策文档标注

概述

wp_get_missing_image_subsizes 是一个 WordPress 过滤器,用于处理上传图片时缺失的图像子尺寸数组。它允许开发者修改或扩展缺失尺寸的检测逻辑。

关键要点

  • 过滤器名称:wp_get_missing_image_sizes
  • 参数:$missing_sizes(缺失尺寸的关联数组)、$image_meta(图像元数据)、$attachment_id(附件ID)
  • 用途:比较已注册图像尺寸与附件元数据中的现有尺寸,返回差异
  • 相关函数:wp_get_missing_image_subsizes() 在 wp-admin/includes/image.php 中定义
  • 引入版本:WordPress 5.3.0

📄 原文内容

Filters the array of missing image sub-sizes for an uploaded image.

Parameters

$missing_sizesarray[]
Associative array of arrays of image sub-size information for missing image sizes, keyed by image size name.
$image_metaarray
The image meta data.
$attachment_idint
The image attachment post ID.

Source

return apply_filters( 'wp_get_missing_image_subsizes', $missing_sizes, $image_meta, $attachment_id );

Changelog

Version Description
5.3.0 Introduced.