wp_ajax_add_meta()

Uses · 14

• check_ajax_referer()Verifies the Ajax request to prevent processing requests external of the blog.
• get_post()Retrieves post data given a post ID or post object.
• current_user_can()Returns whether the current user has the specified capability.
• wp_die()Kills WordPress execution and displays HTML page with an error message.
• __()Retrieves the translation of $text.
• edit_post()Updates an existing post with values provided in `$_POST`.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• add_meta()Adds post meta data defined in the `$_POST` superglobal for a post with given ID.
• get_metadata_by_mid()Retrieves metadata by meta ID.
• _list_meta_row()Outputs a single row of public meta data in the Custom Fields meta box.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• is_protected_meta()Determines whether a meta key is considered protected.

Source

View on Trac ↗View on GitHub ↗

1615function wp_ajax_add_meta() {1616	check_ajax_referer( 'add-meta', '_ajax_nonce-add-meta' );1617	$c    = 0;1618	$pid  = (int) $_POST['post_id'];1619	$post = get_post( $pid );1620 1621	if ( isset( $_POST['metakeyselect'] ) || isset( $_POST['metakeyinput'] ) ) {1622		if ( ! current_user_can( 'edit_post', $pid ) ) {1623			wp_die( -1 );1624		}1625 1626		if ( isset( $_POST['metakeyselect'] ) && '#NONE#' === $_POST['metakeyselect'] && empty( $_POST['metakeyinput'] ) ) {1627			wp_die( 1 );1628		}1629 1630		// If the post is an autodraft, save the post as a draft and then attempt to save the meta.1631		if ( 'auto-draft' === $post->post_status ) {1632			$post_data                = array();1633			$post_data['action']      = 'draft'; // Warning fix.1634			$post_data['post_ID']     = $pid;1635			$post_data['post_type']   = $post->post_type;1636			$post_data['post_status'] = 'draft';1637			$now                      = time();1638 1639			$post_data['post_title'] = sprintf(1640				/* translators: 1: Post creation date, 2: Post creation time. */1641				__( 'Draft created on %1$s at %2$s' ),1642				gmdate( __( 'F j, Y' ), $now ),1643				gmdate( __( 'g:i a' ), $now )1644			);1645 1646			$pid = edit_post( $post_data );1647 1648			if ( $pid ) {1649				if ( is_wp_error( $pid ) ) {1650					$x = new WP_Ajax_Response(1651						array(1652							'what' => 'meta',1653							'data' => $pid,1654						)1655					);1656					$x->send();1657				}1658 1659				$mid = add_meta( $pid );1660				if ( ! $mid ) {1661					wp_die( __( 'Please provide a custom field value.' ) );1662				}1663			} else {1664				wp_die( 0 );1665			}1666		} else {1667			$mid = add_meta( $pid );1668			if ( ! $mid ) {1669				wp_die( __( 'Please provide a custom field value.' ) );1670			}1671		}1672 1673		$meta = get_metadata_by_mid( 'post', $mid );1674		$pid  = (int) $meta->post_id;1675		$meta = get_object_vars( $meta );1676 1677		$x = new WP_Ajax_Response(1678			array(1679				'what'         => 'meta',1680				'id'           => $mid,1681				'data'         => _list_meta_row( $meta, $c ),1682				'position'     => 1,1683				'supplemental' => array( 'postid' => $pid ),1684			)1685		);1686	} else { // Update?1687		$mid   = (int) key( $_POST['meta'] );1688		$key   = wp_unslash( $_POST['meta'][ $mid ]['key'] );1689		$value = wp_unslash( $_POST['meta'][ $mid ]['value'] );1690 1691		if ( '' === trim( $key ) ) {1692			wp_die( __( 'Please provide a custom field name.' ) );1693		}1694

History

Introduced in 3.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-admin/includes/ajax-actions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.