Question

wp_untrash_post( int $post_id )

Restore a post or page from the Trash.

---

description

---

参数

$post_id

(int) (Optional) Post ID. Default is ID of the global $post.

---

返回值

(WP_Post|false) WP_Post object. False on failure.

---

源代码

File: wp-includes/post.php

function wp_untrash_post( $post_id = 0 ) {
	if ( !$post = get_post($post_id, ARRAY_A) )
		return $post;

	if ( $post['post_status'] != 'trash' )
		return false;

	/**
	 * Fires before a post is restored from the trash.
	 *
	 * @since 2.9.0
	 *
	 * @param int $post_id Post ID.
	 */
	do_action( 'untrash_post', $post_id );

	$post_status = get_post_meta($post_id, '_wp_trash_meta_status', true);

	$post['post_status'] = $post_status;

	delete_post_meta($post_id, '_wp_trash_meta_status');
	delete_post_meta($post_id, '_wp_trash_meta_time');

	wp_insert_post( wp_slash( $post ) );

	wp_untrash_post_comments($post_id);

	/**
	 * Fires after a post is restored from the trash.
	 *
	 * @since 2.9.0
	 *
	 * @param int $post_id Post ID.
	 */
	do_action( 'untrashed_post', $post_id );

	return $post;
}

---

更新日志

Version	description
2.9.0	Introduced.

---

相关函数

Uses

• wp-includes/formatting.php: wp_slash()
• wp-includes/plugin.php: do_action()
• wp-includes/post.php: wp_insert_post()
• wp-includes/post.php: wp_untrash_post_comments()
• wp-includes/post.php: untrash_post
• wp-includes/post.php: untrashed_post
• wp-includes/post.php: get_post_meta()
• wp-includes/post.php: delete_post_meta()
• wp-includes/post.php: get_post()
Show 4 more uses Hide more uses

---

Used By

• wp-admin/includes/ajax-actions.php: wp_ajax_trash_post()

---

User Contributed Notes