edit_post( array|null $post_data = null ): int

Description

Parameters

$post_dataarray|nulloptional

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

Return

int

Post ID.

Hooks fired · 1

One hook fires while edit_post() runs, in this order:

1. 1
   apply_filters( attachment_fields_to_save )filterline 435 (+176 into the body)

   Filters the attachment fields to be saved.

Uses · 38

• get_post()Retrieves post data given a post ID or post object.
• sanitize_key()Sanitizes a string key.
• get_post_type_object()Retrieves a post type object by name.
• 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.
• post_type_supports()Checks a post type's support for a given feature.
• wp_get_post_revisions()Returns all revisions of specified post.
• _wp_get_post_revision_version()Gets the post revision version.
• _wp_upgrade_revisions_of_post()Upgrades the revisions author, adds the current post as a revision and sets the revisions version to 1.
• _wp_translate_postdata()Renames `$_POST` data from form names to DB post columns.
• is_wp_error()Checks whether the given variable is a WordPress Error.

Used by · 6

• post_preview()Saves a draft or manually autosaves for the purpose of showing a post preview.
• wp_ajax_add_meta()Handles adding meta via AJAX.
• wp_ajax_inline_save()Handles Quick Edit saving a post from a list table via AJAX.
• wp_ajax_wp_fullscreen_save_post()Handles saving posts from the fullscreen editor via AJAX.
• wp_autosave()Saves a post submitted with XHR.
• wp_write_post()Creates a new post from the "Write Post" form using `$_POST` information.

Source

View on Trac ↗View on GitHub ↗

259function edit_post( $post_data = null ) {260	global $wpdb;261 262	if ( empty( $post_data ) ) {263		$post_data = &$_POST;264	}265 266	// Clear out any data in internal vars.267	unset( $post_data['filter'] );268 269	$post_id = (int) $post_data['post_ID'];270	$post    = get_post( $post_id );271 272	$post_data['post_type']      = $post->post_type;273	$post_data['post_mime_type'] = $post->post_mime_type;274 275	if ( ! empty( $post_data['post_status'] ) ) {276		$post_data['post_status'] = sanitize_key( $post_data['post_status'] );277 278		if ( 'inherit' === $post_data['post_status'] ) {279			unset( $post_data['post_status'] );280		}281	}282 283	$ptype = get_post_type_object( $post_data['post_type'] );284	if ( ! current_user_can( 'edit_post', $post_id ) ) {285		if ( 'page' === $post_data['post_type'] ) {286			wp_die( __( 'Sorry, you are not allowed to edit this page.' ) );287		} else {288			wp_die( __( 'Sorry, you are not allowed to edit this post.' ) );289		}290	}291 292	if ( post_type_supports( $ptype->name, 'revisions' ) ) {293		$revisions = wp_get_post_revisions(294			$post_id,295			array(296				'order'          => 'ASC',297				'posts_per_page' => 1,298			)299		);300		$revision  = current( $revisions );301 302		// Check if the revisions have been upgraded.303		if ( $revisions && _wp_get_post_revision_version( $revision ) < 1 ) {304			_wp_upgrade_revisions_of_post( $post, wp_get_post_revisions( $post_id ) );305		}306	}307 308	if ( isset( $post_data['visibility'] ) ) {309		switch ( $post_data['visibility'] ) {310			case 'public':311				$post_data['post_password'] = '';312				break;313			case 'password':314				unset( $post_data['sticky'] );315				break;316			case 'private':317				$post_data['post_status']   = 'private';318				$post_data['post_password'] = '';319				unset( $post_data['sticky'] );320				break;321		}322	}323 324	$post_data = _wp_translate_postdata( true, $post_data );325	if ( is_wp_error( $post_data ) ) {326		wp_die( $post_data->get_error_message() );327	}328	$translated = _wp_get_allowed_postdata( $post_data );329 330	// Post formats.331	if ( isset( $post_data['post_format'] ) ) {332		set_post_format( $post_id, $post_data['post_format'] );333	}334 335	$format_meta_urls = array( 'url', 'link_url', 'quote_source_url' );336	foreach ( $format_meta_urls as $format_meta_url ) {337		$keyed = '_format_' . $format_meta_url;338		if ( isset( $post_data[ $keyed ] ) ) {

History

Introduced in 1.5.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.8.8 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.