钩子文档

wp_generate_attachment_metadata

💡 云策文档标注

概述

wp_generate_attachment_metadata 是一个 WordPress 过滤器,用于修改生成的附件元数据。它允许开发者在附件元数据创建或更新时进行自定义处理。

关键要点

  • 过滤器名称:wp_generate_attachment_metadata
  • 参数:$metadata(元数据数组)、$attachment_id(附件 ID)、$context(上下文,如 'create' 或 'update')
  • 用途:在附件元数据生成过程中进行过滤,常用于图像子尺寸处理或元数据修改
  • 相关函数:wp_update_image_subsizes() 和 wp_generate_attachment_metadata()
  • 版本历史:从 2.1.0 引入,5.3.0 添加 $context 参数

📄 原文内容

Filters the generated attachment meta data.

Parameters

$metadataarray
An array of attachment meta data.
$attachment_idint
Current attachment ID.
$contextstring
Additional context. Can be 'create' when metadata was initially created for new attachment or 'update' when the metadata was updated.

Source

return apply_filters( 'wp_generate_attachment_metadata', $metadata, $attachment_id, 'create' );

Changelog

Version Description
5.3.0 The $context parameter was added.
2.1.0 Introduced.