参数
$meta_typestring必填-
对象元数据的类型,接受
'post'、'comment'、'term'、'user'或任何其他具有关联meta表的对象类型。 $object_idint必填-
对象ID
$meta_keystring必填-
元数据键。
$meta_valuemixed必填-
元数据值,如果非标量,则必须可序列化。
$uniquebool可选-
指定的元数据键对于对象是否应唯一。
如果为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 ) ); }