wp_trash_post action-hookWP 3.3.0

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_trash_post
WP_Customize_Manager::trash_changeset_post()
wp_trash_post
wp-includes/post.php 3694
do_action( 'wp_trash_post', $post_id, $previous_status );
wp-includes/class-wp-customize-manager.php 3091
do_action( 'wp_trash_post', $post_id, $previous_status );

Where the hook is used in WordPress

wp-includes/default-filters.php 549
add_action( 'wp_trash_post', '_reset_front_page_settings_for_post' );