WordPress 4.0

[autoinstalls/wordpress.git] / wp-includes / cron.php

diff --git a/wp-includes/cron.php b/wp-includes/cron.php
index 1c68e146cf24902030c6537cf9d59b0a0064b299..fc876147cc8ef007e0433713514d310d2ae09b8b 100644 (file)
--- a/wp-includes/cron.php
+++ b/wp-includes/cron.php
@@ -27,7 +27,14 @@ function wp_schedule_single_event( $timestamp, $hook, $args = array()) {
 
        $crons = _get_cron_array();
        $event = (object) array( 'hook' => $hook, 'timestamp' => $timestamp, 'schedule' => false, 'args' => $args );
-       $event = apply_filters('schedule_event', $event);
+       /**
+        * Filter a single event before it is scheduled.
+        *
+        * @since 3.1.0
+        *
+        * @param object $event An object containing an event's data.
+        */
+       $event = apply_filters( 'schedule_event', $event );
 
        // A plugin disallowed this event
        if ( ! $event )
@@ -68,7 +75,8 @@ function wp_schedule_event( $timestamp, $recurrence, $hook, $args = array()) {
                return false;
 
        $event = (object) array( 'hook' => $hook, 'timestamp' => $timestamp, 'schedule' => $recurrence, 'args' => $args, 'interval' => $schedules[$recurrence]['interval'] );
-       $event = apply_filters('schedule_event', $event);
+       /** This filter is documented in wp-includes/cron.php */
+       $event = apply_filters( 'schedule_event', $event );
 
        // A plugin disallowed this event
        if ( ! $event )
@@ -92,28 +100,32 @@ function wp_schedule_event( $timestamp, $recurrence, $hook, $args = array()) {
  * @param array $args Optional. Arguments to pass to the hook's callback function.
  * @return bool|null False on failure. Null when event is rescheduled.
  */
-function wp_reschedule_event( $timestamp, $recurrence, $hook, $args = array()) {
+function wp_reschedule_event( $timestamp, $recurrence, $hook, $args = array() ) {
        $crons = _get_cron_array();
        $schedules = wp_get_schedules();
-       $key = md5(serialize($args));
+       $key = md5( serialize( $args ) );
        $interval = 0;
 
        // First we try to get it from the schedule
-       if ( 0 == $interval )
-               $interval = $schedules[$recurrence]['interval'];
+       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 )
-               $interval = $crons[$timestamp][$hook][$key]['interval'];
+       if ( 0 == $interval ) {
+               $interval = $crons[ $timestamp ][ $hook ][ $key ]['interval'];
+       }
        // Now we assume something is wrong and fail to schedule
-       if ( 0 == $interval )
+       if ( 0 == $interval ) {
                return false;
+       }
 
        $now = time();
 
-       if ( $timestamp >= $now )
+       if ( $timestamp >= $now ) {
                $timestamp = $now + $interval;
-       else
-               $timestamp = $now + ($interval - (($now - $timestamp) % $interval));
+       } else {
+               $timestamp = $now + ( $interval - ( ( $now - $timestamp ) % $interval ) );
+       }
 
        wp_schedule_event( $timestamp, $recurrence, $hook, $args );
 }
@@ -255,10 +267,34 @@ function spawn_cron( $gmt_time = 0 ) {
        $doing_wp_cron = sprintf( '%.22F', $gmt_time );
        set_transient( 'doing_cron', $doing_wp_cron );
 
+       /**
+        * Filter the cron request arguments.
+        *
+        * @since 3.5.0
+        *
+        * @param array $cron_request_array {
+        *     An array of cron request URL arguments.
+        *
+        *     @type string $url  The cron request URL.
+        *     @type int    $key  The 22 digit GMT microtime.
+        *     @type array  $args {
+        *         An array of cron request arguments.
+        *
+        *         @type int  $timeout   The request timeout in seconds. Default .01 seconds.
+        *         @type bool $blocking  Whether to set blocking for the request. Default false.
+        *         @type bool $sslverify Whether SSL should be verified for the request. Default false.
+        *     }
+        * }
+        */
        $cron_request = apply_filters( 'cron_request', array(
-               'url' => site_url( 'wp-cron.php?doing_wp_cron=' . $doing_wp_cron ),
-               'key' => $doing_wp_cron,
-               'args' => array( 'timeout' => 0.01, 'blocking' => false, 'sslverify' => apply_filters( 'https_local_ssl_verify', true ) )
+               'url'  => add_query_arg( 'doing_wp_cron', $doing_wp_cron, site_url( 'wp-cron.php' ) ),
+               'key'  => $doing_wp_cron,
+               'args' => array(
+                       'timeout'   => 0.01,
+                       'blocking'  => false,
+                       /** This filter is documented in wp-includes/class-http.php */
+                       'sslverify' => apply_filters( 'https_local_ssl_verify', false )
+               )
        ) );
 
        wp_remote_post( $cron_request['url'], $cron_request['args'] );
@@ -333,6 +369,13 @@ function wp_get_schedules() {
                'twicedaily' => array( 'interval' => 12 * HOUR_IN_SECONDS, 'display' => __( 'Twice Daily' ) ),
                'daily'      => array( 'interval' => DAY_IN_SECONDS,       'display' => __( 'Once Daily' ) ),
        );
+       /**
+        * Filter the non-default cron schedules.
+        *
+        * @since 2.1.0
+        *
+        * @param array $new_schedules An array of non-default cron schedules. Default empty.
+        */
        return array_merge( apply_filters( 'cron_schedules', array() ), $schedules );
 }