NAME

Chronicle::Plugin::PostSpooler - Autopost entries in the future.

DESCRIPTION

This plugin is designed to allow new posts to be scheduled automatically.

Rather than writing a post with a date: header you should instead write a post with a publish: header. When such a post is found it will be added to the blog only if the publish-date is in the past.

This allows you to write a post such as the following, confident it will not be included until the target date is reached:

Publish: 10th March 2076
Subject: I'm a 100 years old
Tags: life, birthday, fiction

<p>Hello, I am old.</p>

METHODS

Now follows documentation on the available methods.

on_insert

The on_insert method is automatically invoked when a new blog post must be inserted into the SQLite database, that might be because a post is new, or because it has been updated.

The method is designed to return an updated blog-post structure, after performing any massaging required. If the method returns undef then the post is not inserted.

If the post we're being invoked upon does not contain a publish header then this plugin will do nothing.

If there is such a header the post will be ignored unless that header is in the past - if the post refers to a future time it will be skipped.

LICENSE

This module is free software; you can redistribute it and/or modify it under the terms of either:

a) the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version, or

b) the Perl "Artistic License".

AUTHOR

Steve Kemp <steve@steve.org.uk>