Wordpress主题技巧

如何在 WordPress 安排任务

如何在 WordPress 安排任务

WordPress 2.1 的发布带来许多的新的特性,其中一个就是 pseudo-cron – 预定义任务时序安排框架。这已经成为一些定时的通道,Scott Merrill 曾在2005年开发过一个插件叫做 wp-cron 的插件。在 WordPress 2.0 发布之后,在 wp-hachers 邮件列表有个关于在 WordPress 核心代码中添加 cron 类型的时序安排特性的讨论,最后这个特性在 2.1 版本中成形。

这个讨论结果中非常重要的一点是,并不是打算去取代 Linux 操作系统内建的真正的 Cron 特性,也不是打算去达到那种精确。

它所提供的是允许插件开发者能够定义事件发生在特定的时间内。它通过当每次页面被导入的时候,检测当前的时间是否在安排任务的时间上来实现这个功能。如果一个设定的时间刚好通过,一个任务(一个回调函数)就会被完成。

开始使用安排任务需要你拥有关于 WordPress 的 hooks, actions 和 filters 的相关知识,如果你还没有,推荐你去阅读下面的文章:

WordPress Codex: Plugin API
WordPress Codex: Filters
WordPress Hooks FlatEarth.org (在写这篇文章的时候,它还没有被更新到2.1的 hooks)
WordPress Codex: Hooks完整的列表,但是并不是每个 hook 都有一个文档。

如何预定义一个任务

在开始之前,需要注意两件重要事情:

    当你安排一个回调函数的时候,你实际上安排了一个会依次调用你函数的自定义动作,具体请查看下面的关于“定义你安排的事件”章节。
    和 actions 和 filters 不一样,预定的任务是永久的。add_action 和 add_filter 的调用需要页面导入,因为他们没有被存储。下面描述的预定的任务集合使用的函数是存储在数据库中,在 wp_options 表中。如果在每次页面导入的时候调用预定义的函数,你将以一个新的预定义的任务结束。因为这个原因,我建议你设置你的预定义任务到你的已激活的回到函数中,具体技巧查看:register_activation_hook。

时序安排允许你安排两种类型的时件:

    简单的未来的事件(如设定在未来的某个时间某篇文章被发表)。
    重复发生的时件,为一定期限内(如一天,一个星期,或者别的)发生的事情设置一个事件(如为 Verse of the day plugin 导入已经解析的 RSS 源)。

安排简单事件

安排一个简单的事件,使用下面的函数:

wp_schedule_single_event( $timestamp, $hook, $args )

$timestamp 是你想这个事件发生的时间戳。
$hook 是自定义的用来调用你的函数的动作技巧(大部分应该在1分钟内完成)
$args 是被传给你调用的函数的参数数组,这个参数是可选的。

安排重复发生的事件

使用下面的函数来实现:

wp_schedule_event( $timestamp, $recurrence, $hook, $args )

相同的参数含义和简单事件安排的一样。另加的参数含义如下:
$recurrence 用于表示重复类型的字符串。有两种内建的重复类型 — huorly 和 daily。但是如果你想别的类型,如 weekly?非常幸运的是你可以增加别的类型。cron 系统可以从函数 wp_get_schedules() 得到关于‘hourly’ 和 ‘daily’ 的信息。
使用 print_r() 输出这个函数的输出,得到下面的结果:

Array
(
    [hourly] => Array
        (
            [interval] => 3600
            [display] => Once Hourly
        )

    [daily] => Array
        (
            [interval] => 86400
            [display] => Once Daily
        )
)

就如你所见的,所有的都是用内部的时间(多少秒)去设置多频繁事件发生。查看 wp_get_schedules() 的源代码,你将发现它实际上合并了两个的 cron_schedule filter 的到一个数组,并输出它(这里翻译有点问题),这样子的话如果你能够实现一个 filter function 的话,那么就能 hooks 到 cron_schedules hook,你就能增加到列表中。

增加 weekly 和 fortnightly 作为一个可用的资源,使用下面的代码:

function more_reccurences() {
return array(
'weekly' => array('interval' => 604800, 'display' => 'Once Weekly'),
'fortnightly' => array('interval' => 1209600, 'display' => 'Once Fortnightly'),
);
}
add_filter('cron_schedules', 'more_reccurences');

再次使用 print_r() 输出这个函数的输出,得到下面的结果:

Array
(
    [weekly] => Array
        (
            [interval] => 604800
            [display] => Once Weekly
        )

    [fortnightly] => Array
        (
            [interval] => 1209600
            [display] => Once Fortnightly
        )

    [hourly] => Array
        (
            [interval] => 3600
            [display] => Once Hourly
        )

    [daily] => Array
        (
            [interval] => 86400
            [display] => Once Daily
        )
)

定义你要安排的事件。

关于这点,为了创建一个列子,让我们设想安排一些每天都发生的事件,并把这个每天发生的事件叫做 my_daily_function()。所以我们将增加下面这些代码到我们的插件:

if (!wp_next_scheduled('my_daily_function_hook')) {
wp_schedule_event( time(), 'daily', 'my_daily_function_hook' );
}

就像上面所说的,我在这里做的是每天 ‘my_daily_function_hook’ 会被调用,并且这是非常重要这个函数只需调用一次,这就是这个原因去检查 wp_next_scheduled('my_daily_function_hook') 返回的结果是否为否。那个函数将返回下次安排的时间,如果没有被安排返回否,我们要确保那个事件只被安排一次。

我们现在需要定义一个动作去调用 my_daily_function(),我需要定义一个自定义动作。

add_action( 'my_daily_function_hook', 'my_daily_function' );

和函数本身

function my_daily_function() {
print "I was just called. I'll be called at the same time tomorrow"; }

就这些。在每天相同的时间(当这个插件第一次被导入),第二个浏览站点任何页面的人将看到有文字显示在页面上。查看一个正在被使用的时序安排的列子,请查看 wp-votd plugin code。在那里你将看到安排的时间调用 inside _install() 方法以致它只被调用一次。

就是上面所说的,wp_schedule_event 还可以有第四个可选的函数,就是给回调函数传递一个数组参数。

打包所有

时序安排的功能是一个对插件开发者来说非常棒的 WordPress 新特性,它能够使我们所做的变得更简单,它能保持一个最新版的计时器在 wp-option 表中,并能比较现在的和预定义之间的区别。主要荣誉应该给与把它加入核心代码中的开发者,还有Scott Merrill,他开发了原始版的 cron 插件

我希望这个教程能够对你有所帮助,请把该修正的地方,问题,使用方法和想法在留言中告诉我,让我们大家一起分享吧!

本文翻译自:Timing is everything: scheduling in WordPress,翻译的不是很准确,请大家帮忙修正。谢谢!

标签:WordPress 技巧

Wordpress主题技巧

更多有关于 Wordpress主题技巧

域名解析教程

Metaslider幻灯片使用详解!

塔克网整站模板 安装使用指南

WordPress如何备份网站数据库和文件?WordPress整站搬家操作流程。

WordPress网站安全设置教程

国外英文广告联盟网站模板,WordPress主题整站演示地址列表

WordPress主题开发:开启文章缩略图功能

WordPress 自定义头像插件:WP User Avatar

WordPress 后台管理界面UI自定义插件:WP Admin UI Customize

本人擅长Ai、Fw、Fl、Br、Ae、Pr、Id、Ps等软件的安装与卸载,精通CSS、JavaScript、PHP、ASP、C、C++、C#、Java、Ruby、Perl、Lisp、Python、Objective-C、ActionScript、Pascal等单词的拼写,熟悉Windows、Linux、OS X、Android、iOS、WP8等系统的开关机。

通过下面的方式来联系我们:

电邮:138762189@qq.com

联系QQ:点击这里给我发消息

官方站:www.tadke.com

※ ※ 联系请加我的企鹅号 ※※

※ ※技术支持请微信联系站长 ※※

Copyright © 2016 Tadke.com. Powered by Wordpress.