钩子文档

attachment_updated

💡 云策文档标注

概述

attachment_updated 是一个 WordPress 动作钩子,在现有附件更新后触发。它允许开发者在附件更新时执行自定义代码,例如同步数据或记录日志。

关键要点

  • 触发时机:当现有附件(如媒体文件)被更新时触发。
  • 参数:$post_id(附件ID)、$post_after(更新后的WP_Post对象)、$post_before(更新前的WP_Post对象)。
  • 用途:常用于处理附件更新后的操作,如更新元数据或触发其他事件。
  • 相关函数:与 wp_insert_post() 关联,用于插入或更新帖子(包括附件)。
  • 版本历史:从 WordPress 4.4.0 版本开始引入。

代码示例

add_action('attachment_updated', 'my_attachment_updated_callback', 10, 3);
function my_attachment_updated_callback($post_id, $post_after, $post_before) {
    // 自定义代码,例如记录更新日志或同步外部服务
    error_log('附件已更新: ' . $post_id);
}

📄 原文内容

Fires once an existing attachment has been updated.

Parameters

$post_idint
Post ID.
$post_afterWP_Post
Post object following the update.
$post_beforeWP_Post
Post object before the update.

Source

do_action( 'attachment_updated', $post_id, $post_after, $post_before );

Changelog

Version Description
4.4.0 Introduced.