编辑“WordPress常用函数wp schedule event”

<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>导航:</strong> 
[[WordPress常用函数(下)|
上一页]] | {{Template:WordPress导航}}</span>
<div style="clear:both;"></div>
==说明==
计划某个钩子（hook）的运行周期，用户指定时间周期后，WordPress动作（action）函数每一周期内执行一次该钩子。预定时间过去后，如果有人访问用户的WordPress网站，动作函数钩子会被触发。[http://www.wordpress.la/codex-%E6%8F%92%E4%BB%B6API.html 插件API]中有一份钩子（hook）列表。

==用法==
 <?php wp_schedule_event(time(), 'hourly', 'my_schedule_hook'); ?> 

'''参数'''

'''$timestamp'''

（整数）（必需）希望事件首次发生的时间，时间格式必须为UNIX时间标记格式

默认值：None

'''$recurrance'''

（字符串）（必需）事件再次发生与上一次发生的时间间隔。可用值包括：

*hourly 
*twicedaily 
*daily 

默认值：None

'''$hook'''

（字符串）（必需）需要被执行的动作钩子的名称

默认值：None

'''$args'''

（数组）（可选）传递给钩子函数的参数

默认值：None

==示例==
计划一个每小时发生一次的事件

在插件中计划使某个事件每小时发生一次，可以用wp_schedule_event激活该事件（否则最后会出现很多计划的事件）：

 register_activation_hook(__FILE__, 'my_activation');
 add_action('my_hourly_event', 'do_this_hourly');
 function my_activation() {	wp_schedule_event(time(), 'hourly', 'my_hourly_event');}
 function do_this_hourly() {	// do something every hour}
不要忘了取消激活，消除定时程序：

 register_deactivation_hook(__FILE__, 'my_deactivation');
 function my_deactivation() {	wp_clear_scheduled_hook('my_hourly_event');}

'''延伸阅读'''

其它定时进程函数请见[http://codex.wordpress.org/Category:WP-Cron_Functions WP-Cron functions]

完整WordPress函数列表请见[http://www.wordpress.la/codex-wordpress%E7%BD%91%E7%AB%99%E5%BC%80%E5%8F%91.html#function 常用函数]


==相关条目==
*[[Drupal]] 
*[[OBLOG]] 
*[[X-Space]] 
*[[SaBlog-X]] 
*[[Bo-Blog]]

[[category:WordPress中文文档|G]]
[[category:WordPress网站开发|G]]
[[category:WordPress开发文档|G]]