wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_untrash_post_status › WordPress Filter Hooks

Since5.6.0
Deprecatedn/a
› apply_filters( 'wp_untrash_post_status', $new_status, $post_id, $previous_status )
Parameters: (3)
  • () new_status The new status of the post being restored.
    Required: Yes
  • () post_id The ID of the post being restored.
    Required: Yes
  • () previous_status The status of the post at the point where it was trashed.
    Required: Yes
Defined at:
Codex:

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

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.


Related Functions: wp_transition_post_status, wp_untrash_post, wp_untrash_post_comments, wp_untrash_post_set_previous_status, _transition_post_status, wp_trash_post


Related Hooks: pre_untrash_post, wp_trash_post, transition_post_status, untrash_post, get_post_status

Source 

$post_status = apply_filters( 'wp_untrash_post_status', $new_status, $post_id, $previous_status );