updated_{$meta_type}_meta
云策文档标注
概述
updated_{$meta_type}_meta 是一个 WordPress 钩子，在更新特定类型的元数据后立即触发。它允许开发者在元数据更新时执行自定义操作，例如检测特定元键的更改。
关键要点
- 钩子名称是动态的，基于 $meta_type 参数，可包括 updated_blog_meta、updated_post_meta、updated_comment_meta、updated_term_meta、updated_user_meta 等。
- 参数包括 $meta_id（元数据条目ID）、$object_id（对象ID）、$meta_key（元键）、$_meta_value（元值）。
- 相关函数有 update_metadata_by_mid() 和 update_metadata()，用于更新元数据。
- 自 WordPress 2.9.0 版本引入。
代码示例
add_action('updated_user_meta', 'wpdocs_when_update_any_user_meta', 10, 4);
function wpdocs_when_update_any_user_meta($meta_id, $object_id, $meta_key, $_meta_value) {
if ($meta_key === 'your_user_meta_key' ) {
// do something
}
}
原文内容
Fires immediately after updating metadata of a specific type.
Description
The dynamic portion of the hook name, $meta_type, refers to the meta object type (blog, post, comment, term, user, or any other type with an associated meta table).
Possible hook names include:
updated_blog_metaupdated_post_metaupdated_comment_metaupdated_term_metaupdated_user_meta
Parameters
$meta_idint-
ID of updated metadata entry.
$object_idint-
ID of the object metadata is for.
$meta_keystring-
Metadata key.
$_meta_valuemixed-
Metadata value.
Source
do_action( "updated_{$meta_type}_meta", $meta_id, $object_id, $meta_key, $_meta_value );
Changelog
| Version | Description |
|---|---|
| 2.9.0 | Introduced. |
Skip to note 2 content
Razon Komar Pal
Example for detecting specific user metadata updates.
add_action('updated_user_meta', 'wpdocs_when_update_any_user_meta', 10, 4); function wpdocs_when_update_any_user_meta($meta_id, $object_id, $meta_key, $_meta_value) { if ($meta_key === 'your_user_meta_key' ) { // do something } }