add_meta( int $post_ID )

Add post meta data defined in $_POST superglobal for post with given ID.

Parameters

$post_ID

(Required)

Return

(int|bool)

Source

File: wp-admin/includes/post.php 

function add_meta( $post_ID ) {
	$post_ID = (int) $post_ID;

	$metakeyselect = isset($_POST['metakeyselect']) ? wp_unslash( trim( $_POST['metakeyselect'] ) ) : '';
	$metakeyinput = isset($_POST['metakeyinput']) ? wp_unslash( trim( $_POST['metakeyinput'] ) ) : '';
	$metavalue = isset($_POST['metavalue']) ? $_POST['metavalue'] : '';
	if ( is_string( $metavalue ) )
		$metavalue = trim( $metavalue );

	if ( ('0' === $metavalue || ! empty ( $metavalue ) ) && ( ( ( '#NONE#' != $metakeyselect ) && !empty ( $metakeyselect) ) || !empty ( $metakeyinput ) ) ) {
		/*
		 * We have a key/value pair. If both the select and the input
		 * for the key have data, the input takes precedence.
		 */
 		if ( '#NONE#' != $metakeyselect )
			$metakey = $metakeyselect;

		if ( $metakeyinput )
			$metakey = $metakeyinput; // default

		if ( is_protected_meta( $metakey, 'post' ) || ! current_user_can( 'add_post_meta', $post_ID, $metakey ) )
			return false;

		$metakey = wp_slash( $metakey );

		return add_post_meta( $post_ID, $metakey, $metavalue );
	}

	return false;
} // add_meta

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/capabilities.php: current_user_can()

Whether the current user has a specific capability.
wp-includes/meta.php: is_protected_meta()

Determine whether a meta key is protected.
wp-includes/post.php: add_post_meta()

Add meta data field to a post.
wp-includes/formatting.php: wp_unslash()

Remove slashes from a string or array of strings.
wp-includes/formatting.php: wp_slash()

Add slashes to a string or array of strings.

Used By

Used By
Used By Description
wp-admin/includes/ajax-actions.php: wp_ajax_add_meta()

Ajax handler for adding meta.
wp-admin/includes/post.php: edit_post()

Update an existing post with values provided in $_POST.
wp-admin/includes/post.php: wp_write_post()

Creates a new post from the “Write Post” form using $_POST information.

Changelog

Changelog
Version Description
WP-1.2.0 Introduced.