trash_page action-hookWP 2.3.0

Fires when a post is transitioned from one status to another.

The dynamic portions of the hook name, $new_status and $post->post_type, refer to the new post status and post type, respectively.

Please note: When this action is hooked using a particular post status (like 'publish', as publish_{$post->post_type}), it will fire both when a post is first transitioned to that status from something else, as well as upon subsequent post updates (old and new status are both the same).

Therefore, if you are looking to only fire a callback when a post is first transitioned to a status, use the transition_post_status hook instead.

This is one of the variants of the dynamic hook (new_status)_(post_type)

Usage

add_action( 'trash_page', 'wp_kama_trash_page_action', 10, 3 );

/**
 * Function for `trash_page` action-hook.
 * 
 * @param int     $post_id    Post ID.
 * @param WP_Post $post       Post object.
 * @param string  $old_status Old post status.
 *
 * @return void
 */
function wp_kama_trash_page_action( $post_id, $post, $old_status ){

	// action...
}
$post_id(int)
Post ID.
$post(WP_Post)
Post object.
$old_status(string)
Old post status.

Changelog

Since 2.3.0 Introduced.
Since 5.9.0 Added $old_status parameter.

Where the hook is called

wp_transition_post_status()
trash_page
wp-includes/post.php 5448
do_action( "{$new_status}_{$post->post_type}", $post->ID, $post, $old_status );

Where the hook is used in WordPress

Usage not found.