apply_filters( 'pre_untrash_post', bool|null $untrash, WP_Post $post, string $previous_status )
- Since
- 4.9.0, 5.6.0
Filters whether a post untrashing should take place.
Compatibility
- WordPress
- since 5.6.0
- 6.7.7
- 6.8.8
- 6.9.7
- 7.0.4
- 7.1.0
Present in every tracked release (6.7.7 to 7.1.0).
Parameters
$untrashbool|null- Whether to go forward with untrashing.
$postWP_Post- Post object.
$previous_statusstring- The status of the post at the point where it was trashed.
Where this hook fires · 1
wp-includes/post.php:4193wp_untrash_post()
Source code
* @since 5.6.0 Added the `$previous_status` parameter. * * @param bool|null $untrash Whether to go forward with untrashing. * @param WP_Post $post Post object. * @param string $previous_status The status of the post at the point where it was trashed. */ $check = apply_filters( 'pre_untrash_post', null, $post, $previous_status ); if ( null !== $check ) { return $check; } /** * Fires before a post is restored from the Trash.Changelog
Introduced in 4.9.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
5.6.0
Added the
$previous_status parameter.from the docblock4.9.0
Introduced.from the docblock
About this page
- Parsed data
- Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
- Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.