wp_transition_post_status( string $new_status, string $old_status, WP_Post $post )

5912function wp_transition_post_status( $new_status, $old_status, $post ) {5913	/**5914	 * Fires when a post is transitioned from one status to another.5915	 *5916	 * @since 2.3.05917	 *5918	 * @param string  $new_status New post status.5919	 * @param string  $old_status Old post status.5920	 * @param WP_Post $post       Post object.5921	 */5922	do_action( 'transition_post_status', $new_status, $old_status, $post );5923 5924	/**5925	 * Fires when a post is transitioned from one status to another.5926	 *5927	 * The dynamic portions of the hook name, `$new_status` and `$old_status`,5928	 * refer to the old and new post statuses, respectively.5929	 *5930	 * Possible hook names include:5931	 *5932	 *  - `draft_to_publish`5933	 *  - `publish_to_trash`5934	 *  - `pending_to_draft`5935	 *5936	 * @since 2.3.05937	 *5938	 * @param WP_Post $post Post object.5939	 */5940	do_action( "{$old_status}_to_{$new_status}", $post );5941 5942	/**5943	 * Fires when a post is transitioned from one status to another.5944	 *5945	 * The dynamic portions of the hook name, `$new_status` and `$post->post_type`,5946	 * refer to the new post status and post type, respectively.5947	 *5948	 * Possible hook names include:5949	 *5950	 *  - `draft_post`5951	 *  - `future_post`5952	 *  - `pending_post`5953	 *  - `private_post`5954	 *  - `publish_post`5955	 *  - `trash_post`5956	 *  - `draft_page`5957	 *  - `future_page`5958	 *  - `pending_page`5959	 *  - `private_page`5960	 *  - `publish_page`5961	 *  - `trash_page`5962	 *  - `publish_attachment`5963	 *  - `trash_attachment`5964	 *5965	 * Please note: When this action is hooked using a particular post status (like5966	 * 'publish', as `publish_{$post->post_type}`), it will fire both when a post is5967	 * first transitioned to that status from something else, as well as upon5968	 * subsequent post updates (old and new status are both the same).5969	 *5970	 * Therefore, if you are looking to only fire a callback when a post is first5971	 * transitioned to a status, use the {@see 'transition_post_status'} hook instead.5972	 *5973	 * @since 2.3.05974	 * @since 5.9.0 Added `$old_status` parameter.5975	 *5976	 * @param int     $post_id    Post ID.5977	 * @param WP_Post $post       Post object.5978	 * @param string  $old_status Old post status.5979	 */5980	do_action( "{$new_status}_{$post->post_type}", $post->ID, $post, $old_status );5981}