W3cubDocs

/WordPress

do_action( "{$new_status}_{$post->post_type}", int $post_id, WP_Post $post )

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

Description

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.

Parameters

$post_id

(int) Post ID.

$post

(WP_Post) Post object.

Source

File: wp-includes/post.php

View on Trac

Changelog

Version Description
2.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/new_status_post-post_type