apply_filters( 'wp_untrash_post_status', string $new_status, int $post_id, string $previous_status )

Filters the status that a post gets assigned when it is restored from the trash (untrashed).


Description Description

By default posts that are restored will be assigned a status of ‘draft’. Return the value of $previous_status in order to assign the status that the post had before it was trashed. The wp_untrash_post_set_previous_status() function is available for this.

Prior to WordPress 5.6.0, restored posts were always assigned their original status.


Top ↑

Parameters Parameters

$new_status

(string) The new status of the post being restored.

$post_id

(int) The ID of the post being restored.

$previous_status

(string) The status of the post at the point where it was trashed.


Top ↑

Source Source

File: wp-includes/post.php

View on Trac



Top ↑

Changelog Changelog

Changelog
Version Description
5.6.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.