函数原型
add_post_meta( int $post_id, string $meta_key, mixed $meta_value, bool $unique = false ): int|false
函数描述
Adds a meta field to the given post.
是否弃用
未弃用
函数参数
-
$post_id
int
Required - Post ID.
-
$meta_key
string
Required - Metadata name.
-
$meta_value
mixed
Required - Metadata value. Must be serializable if non-scalar.
-
$unique
bool
Optional - Whether the same key should not be added.
Default:
false
函数返回值
int|false Meta ID on success, false on failure.
函数位置
File: wp-includes/post.php.
函数源码
function add_post_meta( $post_id, $meta_key, $meta_value, $unique = false ) {
// Make sure meta is added to the post, not a revision.
$the_post = wp_is_post_revision( $post_id );
if ( $the_post ) {
$post_id = $the_post;
}
return add_metadata( 'post', $post_id, $meta_key, $meta_value, $unique );
}
源码链接
变更日志
| Version | Description |
|---|---|
| 1.5.0 | Introduced. |
