wppaste
WordPress

do_action( "{$old_status}_to_{$new_status}", WP_Post $post )

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

Description

The dynamic portions of the hook name, $new_status and $old_status, refer to the old and new post statuses, respectively.

Possible hook names include:

  • draft_to_publish
  • publish_to_trash
  • pending_to_draft

Compatibility

WordPress
since 2.3.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$postWP_Post
Post object.

Where this hook fires · 1

  • wp-includes/post.php:5843wp_transition_post_status()

Source code

View on Trac View on GitHub 

	 *  - `pending_to_draft`	 *	 * @since 2.3.0	 *	 * @param WP_Post $post Post object.	 */	do_action( "{$old_status}_to_{$new_status}", $post ); 	/**	 * Fires when a post is transitioned from one status to another.	 *	 * The dynamic portions of the hook name, `$new_status` and `$post->post_type`,	 * refer to the new post status and post type, respectively.

Changelog

Introduced in 2.3.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.0.4 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.