Check Quota plugin for SquirrelMail
===================================
Ver 1.2, Feb, 01, 2005

Copyright (c) 2005 Paul Lesneiwski and Kerem Erkan
 
Licensed under the GNU GPL. For full terms see the file LICENSE.


Original authors: Paul Lesneiwski       <pdontthink@angrynerds.com>
                  Kerem Erkan           <kerem.erkan@basari.com.tr>



For the plugins which were merged into this one:

Quota Usage Plugin: 

    - Original author:  Bill Shupp      <hostmaster@shupp.org>
    - Modifications by: Paul Lesneiwski <pdontthink@angrynerds.com>:

Disk Quota Plugin:

    - Original author:  Claudio Panichi <Claudio.Panichi@roma2.infn.it>
    - Modifications by: Kerem Erkan     <kerem.erkan@basari.com.tr>
                        Mike Smith      <mike@ftl.com>



Description
===========

This plugin includes the functionality of two plugins, which
are Quota Usage plugin and Disk Quota plugin.

It can retrieve the current quota usage from the IMAP 
server using the IMAP4 QUOTA extension.  It displays size-
based quotas and/or message-count quotas, as given by the IMAP
server. This function comes from Quota Usage plugin.

Also it can retrieve the current quota usage from UNIX quota
command for UNIX-quota based systems. It displays size-based
quotas and/or file-count quotas, as retreived from the quota
command. This function comes from Disk Quota plugin.

The quota can be displayed above or below the folder listing,
and optionally as a warning in the Message of the Day if the
user's quota is above a configurable "yellow" or "red" alert
level.

The plugin uses Flash, HTML or gd library graphics. You can
choose whichever you like.

For translating the plugin to your language, see the file
TRANSLATING.


Requirements
============

- IMAP server with QUOTA Extension support or UNIX based
  quotas enabled on the server filesystem.
- Quota set for user.  (if it's not set, nothing is displayed).
    NOTE:  Courier-IMAP may not report the quota if usage is 0%.  
           Try sending a message to the user if this is the case.
- Should work with versions of SquirrelMail as far back as 1.2.7 
  at least as well as version 1.5.1.  Please report problems and
  incompatibilities with these and other SquirrelMail versions.

The plugin was tested with Courier-IMAP 1.4.0 and Cyrus 2.2.10 and
above. If your IMAP server only deals with maildirquotas, you can
try UNIX-based quota checking for filesystem quotas.

One of the authors use it successfully with Vpopmail 5.1.4 and above,
a virtual domain package for Qmail. Also it is used with Postfix 2.1.5
and Cyrus 2.2.10 with no problems.


Installation
============

Please read the INSTALL file.


Configuration
=============

There are some configuration items, some of them are optional. They are
explained and found in the config.php file.  


Useful Links
============

Courier-IMAP        http://www.inter7.com/courierimap
Cyrus IMAP          http://asg.web.cmu.edu/cyrus/imapd
RFC 2087            http://www.cis.ohio-state.edu/cgi-bin/rfc/rfc2087.html
Maildir++           http://www.inter7.com/courierimap/README.maildirquota.html
Vpopmail            http://www.inter7.com/vpopmail       
sudo                http://www.courtesan.com/sudo


Help Requests
=============

Help requests are welcome at our personal email addresses, but we
request that you first post to the SquirrelMail Plugins mailing
list, where you'll get faster help from more people and other
people with the same problem will be able to see how your issue
was resolved.  If you don't get good answers that way, you may
try emailing us directly.

Info about the SquirrelMail Plugins mailing list can be found
on the SquirrelMail web site.  It is currently located at:

http://lists.sourceforge.net/mailman/listinfo/squirrelmail-plugins
squirrelmail-plugins@lists.sourceforge.net


Change Log (Change Log for the merged plugins can be found in the
            OLDCHANGELOG file)
=================================================================

1.2 Feb 01, 2005 - Changed the MOTD display. Now the plugin gives
                   2 line breaks before adding the warning messages
                   to avoid confusion
                 - Added automation for the paths for image and swf
                   files so now there is no need for setting
                   $cq_server, $cq_image_path and $cq_swf_path
                   variables in config.php. These have been removed
                   from configuration file (Thanks to Khedron Wilk
                   <khedron@wilk.se>)
                 - Added an option to align graphs left, center or
                   right
                 - Updated documentation
		 - Added Swedish (sv_SE) translations (Thanks again
		   Khedron...)

1.1 Jan 12, 2005 - Added override options for dynamic IMAP quota
                   users (Thanks to Michael D. Shook
                   <mike@megatower.com>)
                 - Changed display options so that the plugin
                   displays KBs for values below 1 MB, MBs for
                   values below 1GB and GBs for values over 1GB
                 - Updated Turkish translations

1.0 Jan 07, 2005 - Initial merged release
		 - Turkish translations added

