transition_post_status action-hook . WP 2.3.0

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

Usage

add_action( 'transition_post_status', 'action_function_name_8121', 10, 3 );
function action_function_name_8121( $new_status, $old_status, $post ){
	// action...
}

$new_status(string): New post status.
$old_status(string): Old post status.
$post(WP_Post): Post object.

Changelog

Since 2.3.0

Introduced.

Where the hook is called

wp_transition_post_status()

transition_post_status

(old_status)_to_(new_status)

(new_status)_(post_type)

wp-includes/post.php 4902

do_action( 'transition_post_status', $new_status, $old_status, $post );

Where in WP core the hook is used WordPress

wp-includes/post.php 366

add_action( 'transition_post_status', '_transition_post_status', 5, 3 );

wp-includes/post.php 367

add_action( 'transition_post_status', '_update_term_count_on_transition_post_status', 10, 3 );

wp-includes/post.php 392

add_action( 'transition_post_status', '_wp_auto_add_pages_to_menu', 10, 3 );

wp-includes/post.php 480

add_action( 'transition_post_status', '_wp_customize_publish_changeset', 10, 3 );

wp-includes/post.php 483

add_action( 'transition_post_status', '_wp_keep_alive_customize_changeset_dependent_auto_drafts', 20, 3 );

wp-includes/post.php 492

add_action( 'transition_post_status', '__clear_multi_author_cache' );

wp-includes/post.php 81

add_action( 'transition_post_status', '_update_blog_date_on_post_publish', 10, 3 );

wp-includes/post.php 82

add_action( 'transition_post_status', '_update_posts_count_on_transition_post_status', 10, 3 );