WordPress 中文文档
Post Status Transitions
From WordPress Chinese
WordPress 2.3 introduces some new actions that WordPress Plugins use to hook into status transitions and workflow. Before, WordPress had a private_to_published action that only announced that a post moved from private to published. Now WordPress has actions for every possible transition.
These actions are of the form status_to_status where status is one of:
- publish
- draft
- private
- future
- pending
When a pending post is published, the action pending_to_publish is triggered. The action is accompanied by the post object that is changing status.
A generic transition_post_status action is also emitted for every status change. It is accompanied by the new status, the old status, and the post object. WordPress Plugins can use this action to attach a function that intercepts all status changes.
The final action triggered during a status change is of the form status_object, where status is from the status list above and object is either page or post. For example, when a post is published, a publish_post action is triggered. The action is accompanied by the post ID and post object.
See the function wp_transition_post_status() for how these actions are formed. Use add_action() to attach functions to these actions.
