WP-Crontrol

Home » Projects » WP-Crontrol

WP-Crontrol lets you take control over what’s happening in the WP-Cron system. Complete documentation can be found below.

Downloads

Download Latest Version 0.3 for WordPress 2.1 — 2.5

The source code can also be found in the WP-Plugins SVN repository at http://svn.wp-plugins.org/wp-crontrol/.

Description

WP-Crontrol lets you take control over what’s happening in the WP-Cron system.

Installation

  1. Upload the wp-crontrol directory to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Goto the Options->Crontrol panel to add some new cron schedules.
  4. Goto the Manage->Crontrol panel to see what cron entries are scheduled and to add some new ones.

Frequently Asked Questions

What’s the use of adding new cron schedules?

Cron schedules are used by WordPress and WordPress plugins to allow you to schedule commands to be executed at regular intervals. Intervals must be provided by the WordPress core or a plugin in order to be used. An example of a plugin that uses these schedules is WordPress Database Backup. Out of the box, only daily and hourly backups are supported. In order to do a weekly backup, a weekly cron schedule must be entered into WP-Crontrol first and then the backup plugin can take advantage of it as an interval.

How do I create a new cron entry?

There are two steps to getting a functioning cron entry that executes regularly. The first step is telling WordPress about the hook. This is the part that WP-Crontrol was created to provide. The second step is calling your function when your hook is executed. You’ve got to do that on your own, but I’ll explain how below.

Step One: Adding the hook

In the Manage->Crontrol admin panel, enter the details of the hook. You’re best off having a hookname that conforms to normal PHP variable naming conventions. This could save you trouble later. Other than that, the hookname can be whatever you want it to be. Next run is the next time that the hook will execute. This can be entered in using GNU Date Input Formats, but often now is good enough. The entry schedule is how often your hook will be executed. If you don’t see a good interval, then add one in the Options->Crontrol admin panel.

Step Two: Writing the function

This part takes place in PHP code (for example, in the functions.php file from your theme). To execute your hook, WordPress runs an action. For this reason, we need to now tell WordPress which function to execute when this action is run. The following line accomplishes that:

add_action('my_hookname', 'my_function');

The next step is to write your function. Here’s a simple example:

function my_function() {
        wp_mail('scompt@scompt.com', 'WP-Crontrol', 'WP-Crontrol rocks!');
}

Do I really need the entire `wp-crontrol` directory?

Nope! The only file that you really need is wp-crontrol.php. Toss this file in your wp-content/plugins directory and you’re good to go.

How do I ask a frequently asked question?

Email me.

Screenshots

  1. New cron entries can be added, modified, and deleted. In addition, they can be executed on-demand.
    New cron entries can be added, modified, and deleted. In addition, they can be executed on-demand.
  2. New cron schedules can be added to WordPress, giving plugin developers more options when scheduling commands.
    New cron schedules can be added to WordPress, giving plugin developers more options when scheduling commands.

Future Plans

Coming up in Version 0.4!

Version History

Version 0.1

Version 0.2

Version 0.3