W3cubDocs

/WordPress

check_and_publish_future_post( int|WP_Post $post_id )

Publish future post and make sure post ID has future post status.

Description

Invoked by cron ‘publish_future_post’ event. This safeguard prevents cron from publishing drafts, etc.

Parameters

$post_id

(int|WP_Post) (Required) Post ID or post object.

Source

File: wp-includes/post.php 

function check_and_publish_future_post( $post_id ) {
	$post = get_post( $post_id );

	if ( empty( $post ) ) {
		return;
	}

	if ( 'future' !== $post->post_status ) {
		return;
	}

	$time = strtotime( $post->post_date_gmt . ' GMT' );

	// Uh oh, someone jumped the gun!
	if ( $time > time() ) {
		wp_clear_scheduled_hook( 'publish_future_post', array( $post_id ) ); // Clear anything else in the system.
		wp_schedule_single_event( $time, 'publish_future_post', array( $post_id ) );
		return;
	}

	// wp_publish_post() returns no meaningful value.
	wp_publish_post( $post_id );
}

Uses

Uses Description
wp-includes/cron.php: wp_clear_scheduled_hook()

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

Schedules an event to run only once.
wp-includes/post.php: wp_publish_post()

Publish a post by transitioning the post status.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.

Changelog

Version Description
2.5.0 Introduced.

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