Posts, Post Types: Add a `$previous_status` parameter to `wp_trash_post()` related hooks.

This adds a `$previous_status` parameter to the `pre_trash_post`, `wp_trash_post`, and `trashed_post` hooks.

Props mujuonly, mukesh27, nihar007, dhruvishah2203, SergeyBiryukov, costdev, hugod, audrasjb, oglekler.
Fixes #58392.



Built from https://develop.svn.wordpress.org/trunk@56043


git-svn-id: http://core.svn.wordpress.org/trunk@55555 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
audrasjb 2023-06-26 20:57:22 +00:00
parent 13a38d84f9
commit d61ec19da0
2 changed files with 20 additions and 12 deletions

View File

@ -3576,15 +3576,19 @@ function wp_trash_post( $post_id = 0 ) {
return false; return false;
} }
$previous_status = $post->post_status;
/** /**
* Filters whether a post trashing should take place. * Filters whether a post trashing should take place.
* *
* @since 4.9.0 * @since 4.9.0
* @since 6.3.0 Added the `$previous_status` parameter.
* *
* @param bool|null $trash Whether to go forward with trashing. * @param bool|null $trash Whether to go forward with trashing.
* @param WP_Post $post Post object. * @param WP_Post $post Post object.
* @param string $previous_status The status of the post about to be trashed.
*/ */
$check = apply_filters( 'pre_trash_post', null, $post ); $check = apply_filters( 'pre_trash_post', null, $post, $previous_status );
if ( null !== $check ) { if ( null !== $check ) {
return $check; return $check;
@ -3594,12 +3598,14 @@ function wp_trash_post( $post_id = 0 ) {
* Fires before a post is sent to the Trash. * Fires before a post is sent to the Trash.
* *
* @since 3.3.0 * @since 3.3.0
* @since 6.3.0 Added the `$previous_status` parameter.
* *
* @param int $post_id Post ID. * @param int $post_id Post ID.
* @param string $previous_status The status of the post about to be trashed.
*/ */
do_action( 'wp_trash_post', $post_id ); do_action( 'wp_trash_post', $post_id, $previous_status );
add_post_meta( $post_id, '_wp_trash_meta_status', $post->post_status ); add_post_meta( $post_id, '_wp_trash_meta_status', $previous_status );
add_post_meta( $post_id, '_wp_trash_meta_time', time() ); add_post_meta( $post_id, '_wp_trash_meta_time', time() );
$post_updated = wp_update_post( $post_updated = wp_update_post(
@ -3619,10 +3625,12 @@ function wp_trash_post( $post_id = 0 ) {
* Fires after a post is sent to the Trash. * Fires after a post is sent to the Trash.
* *
* @since 2.9.0 * @since 2.9.0
* @since 6.3.0 Added the `$previous_status` parameter.
* *
* @param int $post_id Post ID. * @param int $post_id Post ID.
* @param string $previous_status The status of the post at the point where it was trashed.
*/ */
do_action( 'trashed_post', $post_id ); do_action( 'trashed_post', $post_id, $previous_status );
return $post; return $post;
} }
@ -3656,7 +3664,7 @@ function wp_untrash_post( $post_id = 0 ) {
* Filters whether a post untrashing should take place. * Filters whether a post untrashing should take place.
* *
* @since 4.9.0 * @since 4.9.0
* @since 5.6.0 The `$previous_status` parameter was added. * @since 5.6.0 Added the `$previous_status` parameter.
* *
* @param bool|null $untrash Whether to go forward with untrashing. * @param bool|null $untrash Whether to go forward with untrashing.
* @param WP_Post $post Post object. * @param WP_Post $post Post object.
@ -3671,7 +3679,7 @@ function wp_untrash_post( $post_id = 0 ) {
* Fires before a post is restored from the Trash. * Fires before a post is restored from the Trash.
* *
* @since 2.9.0 * @since 2.9.0
* @since 5.6.0 The `$previous_status` parameter was added. * @since 5.6.0 Added the `$previous_status` parameter.
* *
* @param int $post_id Post ID. * @param int $post_id Post ID.
* @param string $previous_status The status of the post at the point where it was trashed. * @param string $previous_status The status of the post at the point where it was trashed.
@ -3717,7 +3725,7 @@ function wp_untrash_post( $post_id = 0 ) {
* Fires after a post is restored from the Trash. * Fires after a post is restored from the Trash.
* *
* @since 2.9.0 * @since 2.9.0
* @since 5.6.0 The `$previous_status` parameter was added. * @since 5.6.0 Added the `$previous_status` parameter.
* *
* @param int $post_id Post ID. * @param int $post_id Post ID.
* @param string $previous_status The status of the post at the point where it was trashed. * @param string $previous_status The status of the post at the point where it was trashed.

View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '6.3-alpha-56042'; $wp_version = '6.3-alpha-56043';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.