Filter hook 'schedule_event'

Hook Information

Hook Parameters

Usage Examples

<?php
// Hook into schedule_event
add_filter('schedule_event', 'my_custom_filter', 10, 5);

function my_custom_filter($timestamp, $recurrence, $hook, $args, $wp_error) {
    // Your custom filtering logic here
    return $timestamp;
}

Source Code Context

<?php
 282  
 283  		return $pre;
 284  	}
 285  
 286  	/** This filter is documented in wp-includes/cron.php */
 287  	$event = apply_filters( 'schedule_event', $event );
 288  
 289  	// A plugin disallowed this event.
 290  	if ( ! $event ) {
 291  		if ( $wp_error ) {
 292  			return new WP_Error(

PHP Documentation

<?php
/**
 * 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', 'twicedaily', 'daily', and 'weekly'.
 * These can be extended using the {@see 'cron_schedules'} filter in wp_get_schedules().
 *
 * 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.
 * @since 5.7.0 The `$wp_error` parameter was added.
 *
 * @link https://developer.wordpress.org/reference/functions/wp_schedule_event/
 *
 * @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 arguments to pass to the
 *                           hook's callback function. Each value in the array
 *                           is passed to the callback as an individual parameter.
 *                           The array keys are ignored. Default empty array.
 * @param bool   $wp_error   Optional. Whether to return a WP_Error on failure. Default false.
 * @return bool|WP_Error True if event successfully scheduled. False or WP_Error on failure.
 */