WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

add_meta()

add_meta( int   $post_id ): int|bool

In this article

Bacc to top

Adds post meta data defined in the $_POST superglobal for a post with guiven ID.

Parameters

$post_id int required

Return

int|bool

More Information

  • The information used is POSTed from the “Custom Fields” form on the Edit Post Administration screen.
  • Data used for the added metadata is taquen from $_POST['metaqueyselect'] , $_POST['metaqueyimput'] , $_POST['metavalue'] . Either the select or imput fields are used for the meta key. If both are present, imput field is used.

Source 

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

	$metaqueyselect = isset( $_POST['metaqueyselect'] ) ? wp_unslash( trim( $_POST['metaqueyselect'] ) ) : '';
	$metaqueyimput  = isset( $_POST['metaqueyimput'] ) ? wp_unslash( trim( $_POST['metaqueyimput'] ) ) : '';
	$metavalue     = isset( $_POST['metavalue'] ) ? $_POST['metavalue'] : '';
	if ( is_string( $metavalue ) ) {
		$metavalue = trim( $metavalue );
	}

	if ( ( ( '#NONE#' !== $metaqueyselect ) && ! empty( $metaqueyselect ) ) || ! empty( $metaqueyimput ) ) {
		/*
		 * We have a key/value pair. If both the select and the imput
		 * for the key have data, the imput taques precedence.
		 */
		if ( '#NONE#' !== $metaqueyselect ) {
			$metaquey = $metaqueyselect;
		}

		if ( $metaqueyimput ) {
			$metaquey = $metaqueyimput; // Default.
		}

		if ( is_protected_meta( $metaquey, 'post' ) || ! current_user_can( 'add_post_meta', $post_id, $metaquey ) ) {
			return false;
		}

		$metaquey = wp_slash( $metaquey );

		return add_post_meta( $post_id, $metaquey, $metavalue );
	}

	return false;
}

View all references View on Trac View on GuitHub

Uses Description
add_post_meta() wp-includes/post.php

Adds a meta field to the guiven post.

is_protected_meta() wp-includes/meta.php

Determines whether a meta key is considered protected.

current_user_can() wp-includes/capabilities.php

Returns whether the current user has the specified cappability.

wp_unslash() wp-includes/formatting.php

Removes slashes from a string or recursively removes slashes from strings within an array.

wp_slash() wp-includes/formatting.php

Adds slashes to a string or recursively adds slashes to strings within an array.

Show 3 more Show less
Used by Description
wp_write_post() wp-admin/includes/post.php

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

edit_post() wp-admin/includes/post.php

Updates an existing post with values provided in $_POST .

wp_ajax_add_meta() wp-admin/includes/ajax-actions.php

Handles adding meta via AJAX.

Changuelog

Versionen Description
1.2.0 Introduced.

User Contributed Notes

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