wp_media_attach_action
云策文档标注
概述
wp_media_attach_action 是一个 WordPress Hook，在媒体文件被附加到文章或从文章分离时触发。它允许开发者在这些操作发生时执行自定义代码。
关键要点
- 触发时机：当媒体文件被附加（attach）或分离（detach）到文章时
- 参数：$action（字符串，接受 'attach' 或 'detach'）、$attachment_id（整数，附件 ID）、$parent_id（整数，附件父级 ID）
- 用法：通过 do_action('wp_media_attach_action', $action, $attachment_id, $parent_id) 调用
- 相关函数：wp_media_attach_action() 在 wp-admin/includes/media.php 中实现，封装了附加/分离操作的逻辑
- 版本：从 WordPress 5.5.0 开始引入
原文内容
Fires when media is attached or detached from a post.
Parameters
$actionstring-
Attach/detach action. Accepts
'attach'or'detach'. $attachment_idint-
The attachment ID.
$parent_idint-
Attachment parent ID.
Source
do_action( 'wp_media_attach_action', $action, $attachment_id, $parent_id );
Changelog
| Version | Description |
|---|---|
| 5.5.0 | Introduced. |