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

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.

Uses · 1

• is_wp_error()Checks whether the given variable is a WordPress Error.

Used by · 5

• bulk_edit_posts()Processes the post data for the bulk editing of posts.
• edit_post()Updates an existing post with values provided in `$_POST`.
• wp_ajax_upload_attachment()Handles uploading attachments via AJAX.
• wp_create_post_autosave()Creates autosave data for the specified post from `$_POST` data.
• wp_write_post()Creates a new post from the "Write Post" form using `$_POST` information.

Source

View on Trac ↗View on GitHub ↗

230function _wp_get_allowed_postdata( $post_data = null ) {231	if ( empty( $post_data ) ) {232		$post_data = $_POST;233	}234 235	// Pass through errors.236	if ( is_wp_error( $post_data ) ) {237		return $post_data;238	}239 240	return array_diff_key( $post_data, array_flip( array( 'meta_input', 'file', 'guid' ) ) );241}

History

Introduced in 5.0.1. 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.7.7 tag, from src/wp-admin/includes/post.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.