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 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 Parameters
- $post_id
-
(int) Post ID.
- $post
-
(WP_Post) Post object.
Source Source
File: wp-includes/post.php
Changelog Changelog
Version | Description |
---|---|
2.3.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Example Migrated from Codex:
The example below will send an email via wp_mail() to the post author when their article is published.
Expand full source codeCollapse full source code