=====  Automatic Message Pruning Module v5.2.1.00   =====
Created by Joe Curia (azumandias _ at _ hotmail.com)
Original phorum coding by the Phorum Development Team (http://www.phorum.org)

========            Brief Description            ========
This module allows an admin to automatically close, hide, or delete posts in 
selected forums after a selected period of time.  Each forum can be configured
individually.  Sticky posts can be excluded.

========                  Settings               ========
On the settings page for this module you can set each forum to have its own
custom actions on selected messages.  You can choose to close, hide, or delete
posts based on the age of either the starting topic or the last post in the 
topic.  You can set any number of hours, days, or months (30 days) after which
to process the posts.

You must use a cron job to process posts with this module.  You have two options
to do this.  If your host supports cron jobs on your server, you can set your
own cron job using the "scheduled" hook.  If your host does not support cron
jobs, you can use a third party service, such as www.setcronjob.com or
www.cronless.com.  I don't endorse any particular service and others can be
found on Google with a search for "free cron jobs."

In either case, I would advise running the cron job once per hour.  If your
site receives more than 1000 posts per hour and you are having posts
automatically deleted then the cron job should be run more often.

========   Setting up a Cron Job on Your Server  ========
Your hosted cron job should call the Phorum "scheduled" hook from the Phorum 
script.php file.  The module will handle any time-outs or errors which 
otherwise could cause the cron job to run two instances of this module.  This is
one example cron job:

0 * * * * cd your/phorum/root && /usr/bin/php ./script.php --scheduled

There should be no output from this script unless there is an error.  If 
possible I would also advise that you have the output from this script either 
logged or emailed.

========         Setting up a Cron Job           ========
========     Through a Third Party Service       ========
Each third party service will have its own setup instructions but all of them
should ask for a url which will be opened on a regular schedule.  The url to 
use for this module is provided at the top of the settings page.  Simply
highlight and copy the entire url in the text box.  This url includes a unique
certificate for your site, generated the first time you open the settings page.

========                   Todo                  ========
 - Add features as they are requested.
 
========                   Files                 ========
\automatic_message_pruning\
    automatic_message_pruning.php
    automatic_message_pruning_scheduled.php
    constants.php
    info.txt
    README
    settings.php
    settings_forum_functions.php