参数
$meta_type
string必填-
对象元数据的类型,接受
'post'
、'comment'
、'term'
、'user'
或任何其他具有关联meta表的对象类型。 $object_id
int必填-
对象ID
$meta_key
string必填-
元数据键。
$meta_value
mixed必填-
元数据值,如果非标量,则必须可序列化。
$unique
bool可选-
指定的元数据键对于对象是否应唯一。
如果为true,并且对象已经具有指定元数据键的值,则不会进行任何更改。默认:
false
返回
int|false 成功时为meta ID,失败时为false。
钩子
- do_action( "added_{$meta_type}_meta",
int $mid ,int $object_id ,string $meta_key ,mixed $_meta_value ) -
在添加特定类型的meta后立即触发。
源码
更新日志
版本 | 描述 |
---|---|
2.9.0 | 开始引入 |
使用示例
例子:
为评论添加额外的元值,这里的元键是location,$location变量保存其值。
function add_comment_location($comment_id, $location) { return add_metadata( 'comment', $comment_id, 'location', wp_slash( $location ) ); }