Debugger plugin for SquirrelMail
================================
Ver 1.2, 2005/06/22


Copyright (c) 2004-2005 Paul Lesneiwski <pdontthink@angrynerds.com>



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

This plugin helps system administrators find any PHP problems
in their SquirrelMail installation without the need for 
changing the php.ini file or touching their Web Server.  It
is helpful when you get blank pages from SquirrelMail or when
a plugin does not seem to be working, etc.

This plugin also provides a handy way for developers to see
current request and server state, which can help with coding
as well as debugging.

IMPORTANT: Unless you use the Virtual Host Login plugin to 
enable this plugin for just some users or domains (note that 
you can use that plugin to do so even if you don't need any 
of its other functionality), this plugin should usually remain 
DE-activated in a production environment!

NOTE: If you enable this plugin in the normal way (not by
using the Virtual Host Login plugin), it can in some cases
be helpful if it is the first plugin in the plugin list.
You can make it the first plugin by manually editing 
config/config.php or by deactivating all plugins and then 
adding them back, making sure to activate this plugin first.



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

Unlike other plugins, the configuration of this plugin is all
located at the top of the setup.php file.  Note that you will
have to reconfigure the plugin whenever you upgrade to a new
version.

Note that if this plugin is located in the plugin list such that 
the Debugger link is the last one on the menu bar in the SquirrelMail
interface, it will not wrap the menu bar.



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

Help requests are welcome at my personal email address, but I
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 me 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



License
=======

This program is licensed under the BSD License because some 
portions of the source are already licensed under it; typical 
SquirrelMail code is licensed under the GNU General Public
License.  See COPYING for details.



Change Log
==========

  v1.2  2005/06/22 Paul Lesneiwski <pdontthink@angrynerds.com>
   * Fix header output bug in popup window.

  v1.1  2005/05/04 Paul Lesneiwski <pdontthink@angrynerds.com>
   * Added "Debugger" link to SquirrelMail menu bar that
     pops up window with the GET, POST, SESSION and SERVER 
     state from the page where the link is provided (the GET,
     POST and SERVER are not for the popup, they are for the
     parent window).

  v1.0  6/05/04  Paul Lesneiwski <pdontthink@angrynerds.com>
   * Initial version

