WordPress at a glance
Home All Function Functions APIs Cron API

wp_get_schedules() WP 1.0

Retrieve supported event recurrence schedules.

The default supported recurrences are 'hourly', 'twicedaily', and 'daily'. A plugin may add more by hooking into the 'cron_schedules' filter. The filter accepts an array of arrays. The outer array has a key that is the name of the schedule or for example 'weekly'. The value is an array with two keys, one is 'interval' and the other is 'display'.

The 'interval' is a number in seconds of when the cron job should run. So for 'hourly', the time is 3600 or 6060. For weekly, the value would be
60
60247 or 604800. The value of 'interval' would then be 604800.

The 'display' is the description. For the 'weekly' key, the 'display' would be __('Once Weekly').

For your plugin, you will be passed an array. you can easily add your schedule by doing the following.

// Filter parameter variable name is 'array'.
$array['weekly'] = array(
	'interval' => 604800,
	'display'  => __( 'Once Weekly' )
);
✈ 1 time = 0.000001s = speed of light | 50000 times = 0.91s = very fast | PHP 7.0.19, WP 5.0.2
Hooks in function
Return

Array.

Usage

wp_get_schedules();

Code of wp get schedules: wp-includes/cron.php VER 5.1.1

<?php
function wp_get_schedules() {
	$schedules = array(
		'hourly'     => array(
			'interval' => HOUR_IN_SECONDS,
			'display'  => __( 'Once Hourly' ),
		),
		'twicedaily' => array(
			'interval' => 12 * HOUR_IN_SECONDS,
			'display'  => __( 'Twice Daily' ),
		),
		'daily'      => array(
			'interval' => DAY_IN_SECONDS,
			'display'  => __( 'Once Daily' ),
		),
	);
	/**
	 * Filters 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 );
}

Related Functions

From tag: cron (schedule)

No comments
    Hello, !     Log In . Register