add_post_meta()

最后更新于:2021-11-25 19:25:14

add_post_meta( int$post_id, string$meta_key, mixed$meta_value, bool$unique=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 value: false

响应

(int|false) Meta ID on success, false on failure.

源文件

文件: gc-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 = gc_is_post_revision( $post_id );
	if ( $the_post ) {
		$post_id = $the_post;
	}

	return add_metadata( 'post', $post_id, $meta_key, $meta_value, $unique );
}