<?php

/**

 * WordPress Cron API

 *

 * @package WordPress

 */

/**

 * Schedules an event to run only once.

 *

 * Schedules a hook which will be triggered by WordPress at the specified time.

 * The action will trigger when someone visits your WordPress site if the scheduled

 * time has passed.

 *

 * Note that scheduling an event to occur within 10 minutes of an existing event

 * with the same action hook will be ignored unless you pass unique `$args` values

 * for each scheduled event.

 *

 * Use wp_next_scheduled() to prevent duplicate events.

 *

 * Use wp_schedule_event() to schedule a recurring event.

 *

 * @since 2.1.0

 * @since 5.1.0 Return value modified to boolean indicating success or failure,

 *              {@see 'pre_schedule_event'} filter added to short-circuit the function.

 *

 *

 * @param int    $timestamp  Unix timestamp (UTC) for when to next run the event.

 * @param string $hook       Action hook to execute when the event is run.

 * @param array  $args       Optional. Array containing each separate argument to pass to the hook's callback function.

 * @return bool True if event successfully scheduled. False for failure.

 */

function wp_schedule_single_event( $timestamp, $hook, $args = array() ) {

	if ( ! is_numeric( $timestamp ) || $timestamp <= 0 ) {

		return false;

	}

	$event = (object) array(

		'hook'      => $hook,

		'timestamp' => $timestamp,

		'schedule'  => false,

		'args'      => $args,

	);

	/**

	 * Filter to preflight or hijack scheduling an event.

	 *

	 * Returning a non-null value will short-circuit adding the event to the

	 * cron array, causing the function to return the filtered value instead.

	 *

	 * Both single events and recurring events are passed through this filter;

	 * single events have `$event->schedule` as false, whereas recurring events

	 * have this set to a recurrence from wp_get_schedules(). Recurring

	 * events also have the integer recurrence interval set as `$event->interval`.

	 *

	 * For plugins replacing wp-cron, it is recommended you check for an

	 * identical event within ten minutes and apply the {@see 'schedule_event'}

	 * filter to check if another plugin has disallowed the event before scheduling.

	 *

	 * Return true if the event was scheduled, false if not.

	 *

	 * @since 5.1.0

	 *

	 * @param null|bool $pre   Value to return instead. Default null to continue adding the event.

	 * @param stdClass  $event {

	 *     An object containing an event's data.

	 *

	 *     @type string       $hook      Action hook to execute when the event is run.

	 *     @type int          $timestamp Unix timestamp (UTC) for when to next run the event.

	 *     @type string|false $schedule  How often the event should subsequently recur.

	 *     @type array        $args      Array containing each separate argument to pass to the hook's callback function.

	 *     @type int          $interval  The interval time in seconds for the schedule. Only present for recurring events.

	 * }

	 */

	$pre = apply_filters( 'pre_schedule_event', null, $event );

	if ( null !== $pre ) {

		return $pre;

	}

	/*

	 * Check for a duplicated event.

	 *

	 * Don't schedule an event if there's already an identical event

	 * within 10 minutes.

	 *

	 * When scheduling events within ten minutes of the current time,

	 * all past identical events are considered duplicates.

	 *

	 * When scheduling an event with a past timestamp (ie, before the

	 * current time) all events scheduled within the next ten minutes

	 * are considered duplicates.

	 */

	$crons     = (array) _get_cron_array();

	$key       = md5( serialize( $event->args ) );

	$duplicate = false;

	if ( $event->timestamp < time() + 10 * MINUTE_IN_SECONDS ) {

		$min_timestamp = 0;

	} else {

		$min_timestamp = $event->timestamp - 10 * MINUTE_IN_SECONDS;

	}

	if ( $event->timestamp < time() ) {

		$max_timestamp = time() + 10 * MINUTE_IN_SECONDS;

	} else {

		$max_timestamp = $event->timestamp + 10 * MINUTE_IN_SECONDS;

	}

	foreach ( $crons as $event_timestamp => $cron ) {

		if ( $event_timestamp < $min_timestamp ) {

			continue;

		}

		if ( $event_timestamp > $max_timestamp ) {

			break;

		}

		if ( isset( $cron[ $event->hook ][ $key ] ) ) {

			$duplicate = true;

			break;

		}

	}

	if ( $duplicate ) {

		return false;

	}

	/**

	 * Modify an event before it is scheduled.

	 *

	 * @since 3.1.0

	 *

	 *

	 *     @type string       $hook      Action hook to execute when the event is run.

	 *     @type int          $timestamp Unix timestamp (UTC) for when to next run the event.

	 *     @type string|false $schedule  How often the event should subsequently recur.

	 *     @type array        $args      Array containing each separate argument to pass to the hook's callback function.

	 *     @type int          $interval  The interval time in seconds for the schedule. Only present for recurring events.

	 * }

	 */

	$event = apply_filters( 'schedule_event', $event );

	if ( ! $event ) {

		return false;

	}

	$crons[ $event->timestamp ][ $event->hook ][ $key ] = array(

		'schedule' => $event->schedule,

		'args'     => $event->args,

	);

	uksort( $crons, 'strnatcasecmp' );

	return _set_cron_array( $crons );

}

/**

 * Schedules a recurring event.

 *

 * Schedules a hook which will be triggered by WordPress at the specified interval.

 * The action will trigger when someone visits your WordPress site if the scheduled

 * time has passed.

 *

 * Valid values for the recurrence are 'hourly', 'daily', and 'twicedaily'. These can

 * be extended using the {@see 'cron_schedules'} filter in wp_get_schedules().

 *

 * Note that scheduling an event to occur within 10 minutes of an existing event

 * with the same action hook will be ignored unless you pass unique `$args` values

 * for each scheduled event.

 *

 * Use wp_next_scheduled() to prevent duplicate events.

 *

 * Use wp_schedule_single_event() to schedule a non-recurring event.

 *

 * @since 2.1.0

 * @since 5.1.0 Return value modified to boolean indicating success or failure,

 *              {@see 'pre_schedule_event'} filter added to short-circuit the function.

 *

 *

 * @param int    $timestamp  Unix timestamp (UTC) for when to next run the event.

 * @param string $recurrence How often the event should subsequently recur. See wp_get_schedules() for accepted values.

 * @param string $hook       Action hook to execute when the event is run.

 * @param array  $args       Optional. Array containing each separate argument to pass to the hook's callback function.

 * @return bool True if event successfully scheduled. False for failure.

 */

function wp_schedule_event( $timestamp, $recurrence, $hook, $args = array() ) {

	if ( ! is_numeric( $timestamp ) || $timestamp <= 0 ) {

		return false;

	}

	$schedules = wp_get_schedules();

	if ( ! isset( $schedules[ $recurrence ] ) ) {

		return false;

	}

	$event = (object) array(

		'hook'      => $hook,

		'timestamp' => $timestamp,

		'schedule'  => $recurrence,

		'args'      => $args,

		'interval'  => $schedules[ $recurrence ]['interval'],

	);

	/** This filter is documented in wp-includes/cron.php */

	$pre = apply_filters( 'pre_schedule_event', null, $event );

	if ( null !== $pre ) {

		return $pre;

	}

	/** This filter is documented in wp-includes/cron.php */

	$event = apply_filters( 'schedule_event', $event );

	if ( ! $event ) {

		return false;

	}

	$key = md5( serialize( $event->args ) );

	$crons = _get_cron_array();

	$crons[ $event->timestamp ][ $event->hook ][ $key ] = array(

		'schedule' => $event->schedule,

		'args'     => $event->args,

		'interval' => $event->interval,

	);

	uksort( $crons, 'strnatcasecmp' );

	return _set_cron_array( $crons );

}

/**

 * Reschedules a recurring event.

 *

 * Mainly for internal use, this takes the time stamp of a previously run

 * recurring event and reschedules it for its next run.

 *

 * To change upcoming scheduled events, use wp_schedule_event() to

 * change the recurrence frequency.

 *

 * @since 2.1.0

 * @since 5.1.0 Return value modified to boolean indicating success or failure,

 *              {@see 'pre_reschedule_event'} filter added to short-circuit the function.

 *

 * @param int    $timestamp  Unix timestamp (UTC) for when the event was scheduled.

 * @param string $recurrence How often the event should subsequently recur. See wp_get_schedules() for accepted values.

 * @param string $hook       Action hook to execute when the event is run.

 * @param array  $args       Optional. Array containing each separate argument to pass to the hook's callback function.

 * @return bool True if event successfully rescheduled. False for failure.

 */

function wp_reschedule_event( $timestamp, $recurrence, $hook, $args = array() ) {

	if ( ! is_numeric( $timestamp ) || $timestamp <= 0 ) {

		return false;

	}

	$schedules = wp_get_schedules();

	$interval  = 0;

	// First we try to get the interval from the schedule.

	if ( isset( $schedules[ $recurrence ] ) ) {

		$interval = $schedules[ $recurrence ]['interval'];

	}

	// Now we try to get it from the saved interval in case the schedule disappears.

	if ( 0 === $interval ) {

		$scheduled_event = wp_get_scheduled_event( $hook, $args, $timestamp );

		if ( $scheduled_event && isset( $scheduled_event->interval ) ) {

			$interval = $scheduled_event->interval;

		}

	}

	$event = (object) array(

		'hook'      => $hook,

		'timestamp' => $timestamp,

		'schedule'  => $recurrence,

		'args'      => $args,

		'interval'  => $interval,

	);

	/**

	 * Filter to preflight or hijack rescheduling of events.

	 *

	 * Returning a non-null value will short-circuit the normal rescheduling

	 * process, causing the function to return the filtered value instead.

	 *

	 * For plugins replacing wp-cron, return true if the event was successfully

	 * rescheduled, false if not.

	 *

	 * @since 5.1.0

	 *

	 * @param null|bool $pre   Value to return instead. Default null to continue adding the event.

	 * @param stdClass  $event {

	 *     An object containing an event's data.

	 *

	 *     @type string       $hook      Action hook to execute when the event is run.

	 *     @type int          $timestamp Unix timestamp (UTC) for when to next run the event.

	 *     @type string|false $schedule  How often the event should subsequently recur.

	 *     @type array        $args      Array containing each separate argument to pass to the hook's callback function.

	 *     @type int          $interval  The interval time in seconds for the schedule. Only present for recurring events.

	 * }

	 */

	$pre = apply_filters( 'pre_reschedule_event', null, $event );

	if ( null !== $pre ) {

		return $pre;

	}

	if ( 0 == $interval ) {

		return false;

	}

	$now = time();

	if ( $timestamp >= $now ) {

		$timestamp = $now + $interval;

	} else {

		$timestamp = $now + ( $interval - ( ( $now - $timestamp ) % $interval ) );

	}

	return wp_schedule_event( $timestamp, $recurrence, $hook, $args );

}

/**

 * Unschedule a previously scheduled event.

 *

 * The $timestamp and $hook parameters are required so that the event can be

 * identified.

 *

 * @since 2.1.0

 * @since 5.1.0 Return value modified to boolean indicating success or failure,

 *              {@see 'pre_unschedule_event'} filter added to short-circuit the function.

 *

 * @param int    $timestamp Unix timestamp (UTC) of the event.

 * @param string $hook      Action hook of the event.

 * @param array  $args      Optional. Array containing each separate argument to pass to the hook's callback function.

 *                          Although not passed to a callback, these arguments are used to uniquely identify the

 *                          event, so they should be the same as those used when originally scheduling the event.

 * @return bool True if event successfully unscheduled. False for failure.

 */

function wp_unschedule_event( $timestamp, $hook, $args = array() ) {

	if ( ! is_numeric( $timestamp ) || $timestamp <= 0 ) {

		return false;

	}

	/**

	 * Filter to preflight or hijack unscheduling of events.

	 *

	 * Returning a non-null value will short-circuit the normal unscheduling

	 * process, causing the function to return the filtered value instead.

	 *

	 * For plugins replacing wp-cron, return true if the event was successfully

	 * unscheduled, false if not.

	 *

	 * @since 5.1.0

	 *

	 * @param null|bool $pre       Value to return instead. Default null to continue unscheduling the event.

	 * @param int       $timestamp Timestamp for when to run the event.

	 * @param string    $hook      Action hook, the execution of which will be unscheduled.

	 * @param array     $args      Arguments to pass to the hook's callback function.

	 */

	$pre = apply_filters( 'pre_unschedule_event', null, $timestamp, $hook, $args );

	if ( null !== $pre ) {

		return $pre;

	}

	$crons = _get_cron_array();

	$key   = md5( serialize( $args ) );

	unset( $crons[ $timestamp ][ $hook ][ $key ] );

	if ( empty( $crons[ $timestamp ][ $hook ] ) ) {

		unset( $crons[ $timestamp ][ $hook ] );

	}

	if ( empty( $crons[ $timestamp ] ) ) {

		unset( $crons[ $timestamp ] );

	}

	return _set_cron_array( $crons );

}

/**

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

 *

 * Warning: This function may return Boolean FALSE, but may also return a non-Boolean

 * value which evaluates to FALSE. For information about casting to booleans see the

 * the `===` operator for testing the return value of this function.

 *

 * @since 2.1.0

 * @since 5.1.0 Return value modified to indicate success or failure,

 *              {@see 'pre_clear_scheduled_hook'} filter added to short-circuit the function.

 *

 * @param string $hook Action hook, the execution of which will be unscheduled.

 */

function wp_clear_scheduled_hook( $hook, $args = array() ) {

	if ( ! is_array( $args ) ) {

		_deprecated_argument( __FUNCTION__, '3.0.0', __( 'This argument has changed to an array to match the behavior of the other cron functions.' ) );

	}

	/**

	 * Filter to preflight or hijack clearing a scheduled hook.

	 *

	 * Returning a non-null value will short-circuit the normal unscheduling

	 * process, causing the function to return the filtered value instead.

	 *

	 * For plugins replacing wp-cron, return the number of events successfully

	 * unscheduled (zero if no events were registered with the hook) or false

	 * if unscheduling one or more events fails.

	 *

	 * @since 5.1.0

	 *

	 */

	$pre = apply_filters( 'pre_clear_scheduled_hook', null, $hook, $args );