wp_get_schedules

函数
wp_get_schedules ( No parameters )
返回值
  • (array[])
定义位置
相关方法
wp_get_schedulewp_next_scheduledwp_get_scheduled_eventwp_get_themeswp_get_sites
引入
2.1.0
弃用
-

wp_get_schedules: 这个函数用来检索可用的cron时间表的数组。它返回一个日程表对象的数组,每个对象都包含日程表的信息,比如它的名称和时间间隔。

检索支持的事件递归时间表。

默认支持的复现时间是”每小时”、”每天两次”、”每天”和”每周”。插件可以通过连接{@see ‘cron_schedules’}过滤器来添加更多内容。该过滤器接受一个数组。外层数组有一个键,是时间表的名称,例如”每月”。值是一个有两个键的数组,一个是’间隔’,另一个是’显示’。

间隔”是一个以秒为单位的数字,表示该cron job应该何时运行。所以对于’小时’,时间是`HOUR_IN_SECONDS`(60*60或3600)。对于’每月’,其值是`MONTH_IN_SECONDS`(30 * 24 * 60 * 60 或 2592000)。

‘显示’是描述。对于’每月’键,’显示’将是`__( ‘每月一次’)`。

对于你的插件,你将被传递一个数组。你可以通过以下方式轻松添加你的时间表。
// Filter parameter variable name is ‘array’.
$array[‘monthly’] = array(
‘interval’ => MONTH_IN_SECONDS,
‘display’ => __( ‘Once Monthly’ )
);

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' ),
		),
		'weekly'     => array(
			'interval' => WEEK_IN_SECONDS,
			'display'  => __( 'Once Weekly' ),
		),
	);

	/**
	 * Filters the non-default cron schedules.
	 *
	 * @since 2.1.0
	 *
	 * @param array[] $new_schedules An array of non-default cron schedule arrays. Default empty.
	 */
	return array_merge( apply_filters( 'cron_schedules', array() ), $schedules );
}

常见问题

FAQs
查看更多 >