_wp_translate_postdata( bool $update = false, array|null $post_data = null ): array|WP_Error

Description

Parameters

$updatebooloptional

Whether the post already exists.Default: false

$post_dataarray|nulloptional

The array of post data to process. Defaults to the $_POST superglobal.Default: null

Return

array|WP_Error

Array of post data on success, WP_Error on failure.

Uses · 11

• get_post_type_object()Retrieves a post type object by name.
• current_user_can()Returns whether the current user has the specified capability.
• __()Retrieves the translation of $text.
• get_current_user_id()Gets the current user's ID.
• sanitize_key()Sanitizes a string key.
• get_post_status_object()Retrieves a post status object by name.
• get_post_field()Retrieves data from a post field based on Post ID.
• wp_checkdate()Tests if the supplied date is valid for the Gregorian calendar.
• get_gmt_from_date()Given a date in the timezone of the site, returns that date in UTC.
• get_taxonomy()Retrieves the taxonomy object of $taxonomy.
• WP_Error::__construct()Initializes the 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 ↗

21function _wp_translate_postdata( $update = false, $post_data = null ) {22 23	if ( empty( $post_data ) ) {24		$post_data = &$_POST;25	}26 27	if ( $update ) {28		$post_data['ID'] = (int) $post_data['post_ID'];29	}30 31	$ptype = get_post_type_object( $post_data['post_type'] );32 33	if ( $update && ! current_user_can( 'edit_post', $post_data['ID'] ) ) {34		if ( 'page' === $post_data['post_type'] ) {35			return new WP_Error( 'edit_others_pages', __( 'Sorry, you are not allowed to edit pages as this user.' ) );36		} else {37			return new WP_Error( 'edit_others_posts', __( 'Sorry, you are not allowed to edit posts as this user.' ) );38		}39	} elseif ( ! $update && ! current_user_can( $ptype->cap->create_posts ) ) {40		if ( 'page' === $post_data['post_type'] ) {41			return new WP_Error( 'edit_others_pages', __( 'Sorry, you are not allowed to create pages as this user.' ) );42		} else {43			return new WP_Error( 'edit_others_posts', __( 'Sorry, you are not allowed to create posts as this user.' ) );44		}45	}46 47	if ( isset( $post_data['content'] ) ) {48		$post_data['post_content'] = $post_data['content'];49	}50 51	if ( isset( $post_data['excerpt'] ) ) {52		$post_data['post_excerpt'] = $post_data['excerpt'];53	}54 55	if ( isset( $post_data['parent_id'] ) ) {56		$post_data['post_parent'] = (int) $post_data['parent_id'];57	}58 59	if ( isset( $post_data['trackback_url'] ) ) {60		$post_data['to_ping'] = $post_data['trackback_url'];61	}62 63	$post_data['user_ID'] = get_current_user_id();64 65	if ( ! empty( $post_data['post_author_override'] ) ) {66		$post_data['post_author'] = (int) $post_data['post_author_override'];67	} else {68		if ( ! empty( $post_data['post_author'] ) ) {69			$post_data['post_author'] = (int) $post_data['post_author'];70		} else {71			$post_data['post_author'] = (int) $post_data['user_ID'];72		}73	}74 75	if ( isset( $post_data['user_ID'] ) && ( $post_data['post_author'] !== $post_data['user_ID'] )76		&& ! current_user_can( $ptype->cap->edit_others_posts ) ) {77 78		if ( $update ) {79			if ( 'page' === $post_data['post_type'] ) {80				return new WP_Error( 'edit_others_pages', __( 'Sorry, you are not allowed to edit pages as this user.' ) );81			} else {82				return new WP_Error( 'edit_others_posts', __( 'Sorry, you are not allowed to edit posts as this user.' ) );83			}84		} else {85			if ( 'page' === $post_data['post_type'] ) {86				return new WP_Error( 'edit_others_pages', __( 'Sorry, you are not allowed to create pages as this user.' ) );87			} else {88				return new WP_Error( 'edit_others_posts', __( 'Sorry, you are not allowed to create posts as this user.' ) );89			}90		}91	}92 93	if ( ! empty( $post_data['post_status'] ) ) {94		$post_data['post_status'] = sanitize_key( $post_data['post_status'] );95 96		// No longer an auto-draft.97		if ( 'auto-draft' === $post_data['post_status'] ) {98			$post_data['post_status'] = 'draft';99		}100

History

Introduced in 2.6.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 7.1.0 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.