wp_untrash_post( int $post_id = 0 ): WP_Post|false|null

3968function wp_untrash_post( $post_id = 0 ) {3969	$post = get_post( $post_id );3970 3971	if ( ! $post ) {3972		return $post;3973	}3974 3975	$post_id = $post->ID;3976 3977	if ( 'trash' !== $post->post_status ) {3978		return false;3979	}3980 3981	$previous_status = get_post_meta( $post_id, '_wp_trash_meta_status', true );3982 3983	/**3984	 * Filters whether a post untrashing should take place.3985	 *3986	 * @since 4.9.03987	 * @since 5.6.0 Added the `$previous_status` parameter.3988	 *3989	 * @param bool|null $untrash         Whether to go forward with untrashing.3990	 * @param WP_Post   $post            Post object.3991	 * @param string    $previous_status The status of the post at the point where it was trashed.3992	 */3993	$check = apply_filters( 'pre_untrash_post', null, $post, $previous_status );3994	if ( null !== $check ) {3995		return $check;3996	}3997 3998	/**3999	 * Fires before a post is restored from the Trash.4000	 *4001	 * @since 2.9.04002	 * @since 5.6.0 Added the `$previous_status` parameter.4003	 *4004	 * @param int    $post_id         Post ID.4005	 * @param string $previous_status The status of the post at the point where it was trashed.4006	 */4007	do_action( 'untrash_post', $post_id, $previous_status );4008 4009	$new_status = ( 'attachment' === $post->post_type ) ? 'inherit' : 'draft';4010 4011	/**4012	 * Filters the status that a post gets assigned when it is restored from the trash (untrashed).4013	 *4014	 * By default posts that are restored will be assigned a status of 'draft'. Return the value of `$previous_status`4015	 * in order to assign the status that the post had before it was trashed. The `wp_untrash_post_set_previous_status()`4016	 * function is available for this.4017	 *4018	 * Prior to WordPress 5.6.0, restored posts were always assigned their original status.4019	 *4020	 * @since 5.6.04021	 *4022	 * @param string $new_status      The new status of the post being restored.4023	 * @param int    $post_id         The ID of the post being restored.4024	 * @param string $previous_status The status of the post at the point where it was trashed.4025	 */4026	$post_status = apply_filters( 'wp_untrash_post_status', $new_status, $post_id, $previous_status );4027 4028	delete_post_meta( $post_id, '_wp_trash_meta_status' );4029	delete_post_meta( $post_id, '_wp_trash_meta_time' );4030 4031	$post_updated = wp_update_post(4032		array(4033			'ID'          => $post_id,4034			'post_status' => $post_status,4035		)4036	);4037 4038	if ( ! $post_updated ) {4039		return false;4040	}4041 4042	wp_untrash_post_comments( $post_id );4043 4044	/**4045	 * Fires after a post is restored from the Trash.4046	 *4047	 * @since 2.9.0
When	Instructions	Calls it makes
always	7–12	`get_post()`
`$check !== null`	27	`get_post(), get_post_meta(), apply_filters()`
`$check === null`	59–60	`get_post(), get_post_meta(), apply_filters(), do_action(), apply_filters(), delete_post_meta(), delete_post_meta(), ID()`
`$check === null`	67–68	`get_post(), get_post_meta(), apply_filters(), do_action(), apply_filters(), delete_post_meta(), delete_post_meta(), ID(), wp_untrash_post_comments(), do_action()`