钩子文档

add_{$meta_type}_meta

💡 云策文档标注

概述

add_{$meta_type}_meta 是一个 WordPress 动态 Hook,在添加特定类型的元数据之前立即触发。它允许开发者在元数据操作前执行自定义代码。

关键要点

  • 这是一个动态 Hook,$meta_type 指代元对象类型,如 blog、post、comment、term、user 等。
  • 可能的 Hook 名称包括 add_blog_meta、add_post_meta、add_comment_meta、add_term_meta、add_user_meta。
  • 参数包括 $object_id(对象 ID)、$meta_key(元数据键)、$_meta_value(元数据值)。
  • 相关函数为 add_metadata(),用于添加指定对象的元数据。
  • 自 WordPress 3.1.0 版本引入。

📄 原文内容

Fires immediately before meta of a specific type is added.

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:

  • add_blog_meta
  • add_post_meta
  • add_comment_meta
  • add_term_meta
  • add_user_meta

Parameters

$object_idint
ID of the object metadata is for.
$meta_keystring
Metadata key.
$_meta_valuemixed
Metadata value.

Source

do_action( "add_{$meta_type}_meta", $object_id, $meta_key, $_meta_value );

Changelog

Version Description
3.1.0 Introduced.