folder_sizes -- Version 1.4
By Robin Rainton <robin@rainton.com>
http://rainton.com/fun/freeware

Description
===========
Shows a the list of folders in the same order (should be!) as the default left
hand frame. Included are message count, unread count and total message size
for each folder so you can tell where all your storage has gone.

The details are shown either buy clicking a link that appears under the
folder list (left frame), or when the 'On Folders page' option is selected,
they appear after 'Subscribe/Unsubscribe' box on the 'Folders' page.

Optionally (not by default though) shows totals for each sub-folder in a
mailbox.

Has been tested (not very thoroughly - sorry) with SquirrelMail 1.2.5 and
PHP 4.1.2 with single and multi-level folders. Version 0.4 was confirmed
to work with folders that may contain both messages and subfolders.

Usage
=====
There are three options that are listed on the 'Folder Preferences' page.
One is to place a link on the left hand frame, under the standard folder
list, that when clicked displays your folder usage in the right frame. The
default perference is to show this link.

The next option is to include the folder size list on the 'Folders' page. I
orignially had the list on the bottom of the 'Folders' page - but then
realised that if you had a lot of folders, and wanted to add more this would
be a real pain in the butt if your system was slowed down.

The third option determines whether totals for each sub-folder are shown.

Admin Options
=============

From v1.2 onwards there is a configuration option file, folder_sizes_config.php.

Edit this to make the link (under the folder list in the left frame) appear
as a button instead of text. I think this looks nicer when this is installed
in conjunction with my jump_to plugin. Personal preference of course though,
that's why it's an option.

To Do
=====

1. Suggestions welcome.

Changes
=======

v0.1     1-Apr-2002     Initial version
v0.2     2-Apr-2002     Handles hierarchies (folders hold messages or
                        other folders - not both).
v0.3     7-Apr-2002	Parent folders are determined better with the
                        'noinferiours' flag. Uses blank column for
			indentation and include </TR> and </TD> for
			browsers that can't understand stuff without them.
			Added subtotals as an option. Added Unread count.
v0.4     8-Apr-2002     Correctly shows folders that may contain both children
                        and messages by using 'noselect' flag to exclude
			counts, not 'noinferiours' as before.
v1.0	27-Apr-2002	Fixed missing </TD> in header. As there are several
			hundred downloads and only this one error reported I
			think we can call this version 1.0 now.
v1.1	17-Oct-2002	Works with register_gloabls on or off. Incorporated
			Frode Nordahl's il8n support.
v1.2	 9-Feb-2003	Works with Squirrelmail 1.4. Uses unformatted-disp
			folder names so when all folders are under INBOX
			things look nicer. Introduced option of having link
			as a button instead of text.
v1.3	13-Mar-2003	Solves small problem with config include conflicting
			with some other plugins by using SM_PATH.
v1.4	 7-Apr-2003	Works with official 1.4 release. Fetches messages in
			batches to avoid PHP memory size problems. Also hoped
			this fixes performance problems on some servers (UW).

Thanks
======

Thanks go to Edward Alfert, Gregory Gee, Julian Gomez and Christian Kleitsch
for their testing efforts.

Copyright
=========
Copyright (C) 2002 Robin Rainton

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

A copy of the GNU General Public License can be found on the
Free Software Foundation website: http://gnu.org/
