WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

_wp_get_allowed_postdata()

_wp_get_allowed_postdata( array|WP_Error|null $post_data = null ): array|WP_Error

In this article

Back to top

Returns only allowed post data fields.

Parameters

$post_dataarray|WP_Error|nulloptional
The array of post data to process, or an error object.
Defaults to the $_POST superglobal.

Default:null

Return

array|WP_Error Array of post data on success, WP_Error on failure.

Source

function _wp_get_allowed_postdata( $post_data = null ) {
	if ( empty( $post_data ) ) {
		$post_data = $_POST;
	}

	// Pass through errors.
	if ( is_wp_error( $post_data ) ) {
		return $post_data;
	}

	return array_diff_key( $post_data, array_flip( array( 'meta_input', 'file', 'guid' ) ) );
}

View all references View on Trac View on GitHub

UsesDescription
is_wp_error()wp-includes/load.php

Checks whether the given variable is a WordPress Error.

Used byDescription
wp_create_post_autosave()wp-admin/includes/post.php

Creates autosave data for the specified post from $_POST data.

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.

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

Processes the post data for the bulk editing of posts.

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

Handles uploading attachments via AJAX.

Changelog

VersionDescription
5.0.1Introduced.

User Contributed Notes

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