从“废纸篓”中恢复帖子或页面。
原型
wp_untrash_post( int $post_id )
参数
$post_id
(int)
(Optional)
帖子ID。默认值是全局$ post的ID。
返回值
(WP_Post|false|null)
发布成功数据,错误或失败时返回null。
源文件
路径:wp-includes/post.php
<?php
...
function wp_untrash_post( $post_id = 0 ) {
$post = get_post( $post_id );
if ( ! $post ) {
return $post;
}
if ( 'trash' !== $post->post_status ) {
return false;
}
/**
* Filters whether a post untrashing should take place.
*
* @since 4.9.0
*
* @param bool $untrash Whether to go forward with untrashing.
* @param WP_Post $post Post object.
*/
$check = apply_filters( 'pre_untrash_post', null, $post );
if ( null !== $check ) {
return $check;
}
/**
* 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 );
delete_post_meta( $post_id, '_wp_trash_meta_status' );
delete_post_meta( $post_id, '_wp_trash_meta_time' );
wp_update_post( array( 'ID' => $post_id, 'post_status' => $post_status ) );
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;
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/wp_untrash_post/