Mailbox Usage v1.0

Written by Konrad Willmert <kwillmert@visionaryweb.com>
Copyright (c) 2005 Visionary Enterprises <info@visionaryweb.com>
Licensed under the GNU GPL. For full terms see the file COPYING.

*** Description

	This plugin prints out the percent mailbox usage next to INBOX.
	It was developed and tested on FreeBSD with Squirrelmail 1.4.4,
	Apache 1.3.33 and PHP 4.3.10.

*** Configuration

	Mailbox Usage depends on 2 things from your server:
	1. The 'du' command for determining file/directory sizes
	2. All your mailboxes are located in the same directory someplace

	Neither one of these requirements ought to cause any problems as
	most sensible server systems meet them.

	This plugin also currently assumes that the mailbox quota for all
	users is the same, so it would be best used with quota functionality
	in the mail server itself.

	Mailbox Usage is pretty simple.  There are 3 configuration options
	in config.php:

	- $PLUGIN_MAILBOX_USAGE_LIMIT_KB
		Set this to the maximum allowed size of your mailboxes in KILOBYTES.
		(1024 byte blocks)

	- $PLUGIN_MAILBOX_USAGE_MAILBOX_PATH
		Set this to the absolute path to your mailboxes including trailing slash.

	- $PLUGIN_MAILBOX_USAGE_PRECISION
		Set this to your desired decimal precision for the percentage.
		Zero is recommended.

*** Change Log

	1.0 - Initial release.  Thought up a simple hack, then wrote code in plugin form.

*** Future Ideas/Enhancements/To Do List

	- Add support for IIS web servers
	- Parse Postfix configuration file for mailbox size limit
	- Support for user quotas (of different sizes)
	- Optional use of the 'quota' command for determining users' quota
