add_meta( int $post_ID )

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

Contents

Description Description

Parameters Parameters

$post_ID

(int) (Required)

Top ↑

Return Return

(int|bool)

Top ↑

Source 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 ( ( ( '#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 full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
1.2.0 Introduced.

Top ↑

Top ↑

Uses Uses

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

Whether the current user has a specific capability.
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.
wp-includes/post.php: add_post_meta()

Adds a meta field to the given post.
wp-includes/meta.php: is_protected_meta()

Determines whether a meta key is considered protected.

Top ↑

Used By Used By

Used By
Used By Description
wp-admin/includes/post.php: wp_write_post()

Creates a new post from the “Write Post” form using $_POST information.
wp-admin/includes/post.php: edit_post()

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

Ajax handler for adding meta.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.