W3cubDocs

/WordPress

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

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness. Use wp_clear_scheduled_hook() instead.

Hook for managing future post transitions to published.

Description

See also

Parameters

$new_status

(string) (Required) New post status.

$old_status

(string) (Required) Previous post status.

$post

(WP_Post) (Required) Post object.

Source

File: wp-includes/post.php 

function _transition_post_status( $new_status, $old_status, $post ) {
	global $wpdb;

	if ( 'publish' !== $old_status && 'publish' === $new_status ) {
		// Reset GUID if transitioning to publish and it is empty.
		if ( '' === get_the_guid( $post->ID ) ) {
			$wpdb->update( $wpdb->posts, array( 'guid' => get_permalink( $post->ID ) ), array( 'ID' => $post->ID ) );
		}

		/**
		 * Fires when a post's status is transitioned from private to published.
		 *
		 * @since 1.5.0
		 * @deprecated 2.3.0 Use {@see 'private_to_publish'} instead.
		 *
		 * @param int $post_id Post ID.
		 */
		do_action_deprecated( 'private_to_published', array( $post->ID ), '2.3.0', 'private_to_publish' );
	}

	// If published posts changed clear the lastpostmodified cache.
	if ( 'publish' === $new_status || 'publish' === $old_status ) {
		foreach ( array( 'server', 'gmt', 'blog' ) as $timezone ) {
			wp_cache_delete( "lastpostmodified:$timezone", 'timeinfo' );
			wp_cache_delete( "lastpostdate:$timezone", 'timeinfo' );
			wp_cache_delete( "lastpostdate:$timezone:{$post->post_type}", 'timeinfo' );
		}
	}

	if ( $new_status !== $old_status ) {
		wp_cache_delete( _count_posts_cache_key( $post->post_type ), 'counts' );
		wp_cache_delete( _count_posts_cache_key( $post->post_type, 'readable' ), 'counts' );
	}

	// Always clears the hook in case the post status bounced from future to draft.
	wp_clear_scheduled_hook( 'publish_future_post', array( $post->ID ) );
}

Uses

Uses Description
wp-includes/plugin.php: do_action_deprecated()

Fires functions attached to a deprecated action hook.
wp-includes/cron.php: wp_clear_scheduled_hook()

Unschedules all events attached to the hook with the specified arguments.
wp-includes/cache.php: wp_cache_delete()

Removes the cache contents matching key and group.
wp-includes/link-template.php: get_permalink()

Retrieves the full permalink for the current post or post ID.
wp-includes/post-template.php: get_the_guid()

Retrieve the Post Global Unique Identifier (guid).
wp-includes/post.php: private_to_published

Fires when a post’s status is transitioned from private to published.
wp-includes/post.php: _count_posts_cache_key()

Return the cache key for wp_count_posts() based on the passed arguments.
wp-includes/wp-db.php: wpdb::update()

Updates a row in the table.

Changelog

Version Description
2.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/_transition_post_status