wp_trash_post
Fires before a post is sent to the Trash.
Usage
add_action( 'wp_trash_post', 'wp_kama_trash_post_action', 10, 2 );
/**
* Function for `wp_trash_post` action-hook.
*
* @param int $post_id Post ID.
* @param string $previous_status The status of the post about to be trashed.
*
* @return void
*/
function wp_kama_trash_post_action( $post_id, $previous_status ){
// action...
}
- $post_id(int)
- Post ID.
- $previous_status(string)
- The status of the post about to be trashed.
Changelog
| Since 3.3.0 | Introduced. |
| Since 6.3.0 | Added the $previous_status parameter. |
Where the hook is called
wp_trash_post
wp-includes/post.php 4050
do_action( 'wp_trash_post', $post_id, $previous_status );
wp-includes/class-wp-customize-manager.php 3097
do_action( 'wp_trash_post', $post_id, $previous_status );
Where the hook is used in WordPress
wp-includes/default-filters.php 577
add_action( 'wp_trash_post', '_reset_front_page_settings_for_post' );