WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

_future_post_hook()

_future_post_hook( int $deprecated, WP_Post $post )

In this article

Back to top

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.

Hook used to schedule publication for a post marked for the future.

Description

The $post properties used and must exist are ‘ID’ and ‘post_date_gmt’.

Parameters

$deprecatedintrequired
Not used. Can be set to null. Never implemented. Not marked as deprecated with _deprecated_argument() as it conflicts with wp_transition_post_status() and the default filter for _future_post_hook() .
More Arguments from _future_post_hook( … $deprecated )Not used. Can be set to null. Never implemented. Not marked as deprecated with _deprecated_argument() as it conflicts with wp_transition_post_status() and the default filter for _future_post_hook() .
$postWP_Postrequired
Post object.

Source

function _future_post_hook( $deprecated, $post ) {
	wp_clear_scheduled_hook( 'publish_future_post', array( $post->ID ) );
	wp_schedule_single_event( strtotime( get_gmt_from_date( $post->post_date ) . ' GMT' ), 'publish_future_post', array( $post->ID ) );
}

View all references View on Trac View on GitHub

UsesDescription
wp_clear_scheduled_hook()wp-includes/cron.php

Unschedules all events attached to the hook with the specified arguments.

wp_schedule_single_event()wp-includes/cron.php

Schedules an event to run only once.

get_gmt_from_date()wp-includes/formatting.php

Given a date in the timezone of the site, returns that date in UTC.

Changelog

VersionDescription
2.3.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.