Posts by Mark Carey on Learning Movable Type tag:,2008-02-25:/5 2007-12-14T12:36:06Z Tutorials and helpful tips for the Movable Type web publishing system Movable Type Publishing Platform 4.01 Movable Type Scheduled Tasks tag:www.learningmovabletype.com,2007://5.1982 2007-12-12T20:53:56Z 2007-12-14T12:36:06Z Movable Type has a scheduled tasks system that is used to perform certain tasks on scheduled basis. Built-in tasks include expiring junk (spam) trackbacks and comments, and posting entries that were scheduled to to published at a certain date / time. Movable Type plugins can also use scheduled tasks, as... Mark Carey http://mt-hack.com Movable Type has a scheduled tasks system that is used to perform certain tasks on scheduled basis. Built-in tasks include expiring junk (spam) trackbacks and comments, and posting entries that were scheduled to to published at a certain date / time. Movable Type plugins can also use scheduled tasks, as some of my plugins do (including Visitor Stats Pro, Ajax Rating Pro, and Blog Janitor). One of the benefit of scheduled tasks is to improvement performance and user experience -- resource intensive functions can be run without making admins, authors, and commenters wait while they complete.

Triggering Scheduled Tasks

Scheduled task will only run when they are triggered. This is important. Even if a task is scheduled to run every hour, it scheduled tasks don't get triggered, the task will never run. By default Movable Type will trigger scheduled tasks in the following cases:

  1. You receive a junk (spam) comment or trackback. Note: this will only trigger the 'Junk expiration' task - it won't trigger plugin tasks.
  2. You view or download an XML "activity feed" (These feeds show up on with orange feed links on many screens of the admin MT interface, including entry and comment listings, and activity log).
  3. When the run-periodic-tasks script (found in the 'tools' directory of MT) is run via the command line or via cron.
]]> Testing Scheduled Tasks

Here is an easily method that I use to test scheduled tasks and make sure they are running correctly:

  1. Go to System Overview > Activity Log.
  2. Click the "Activity Feed" link on the right side of the page.
  3. After the XML feed displays, hit the back button.
  4. Now refresh the System Activity Log.
  5. Read the recent log entries. If tasks were just triggered, there should be a message stating that tasks were run, along with the names of those tasks. In addition, some plugin tasks may post custom log messages to the Activity Log, providing more information about the task completed.

Note that in some cases, depending of the task, you may have to rebuild your pages after the task has run, in order to see the results of the task. One example of such a case is my Visitor Stats Pro plugin, in which a scheduled task tallies the page views of each entry, so that they can be displayed in a "Most Read Entries" widget that lists the most popular entries.

Setting Up a Cron Job

To ensure that scheduled tasks get triggered on a regular basis, I recommend setting up a cron job to run the run-periodic-tasks script once per hour. If you are not familiar with setting up cron jobs, please read the following helpful article: Scheduled Postings and Cron Jobs.

]]>