Bypass Trash plugin for SquirrelMail
====================================
Ver 1.0, 2009/04/21


Copyright (c) 2009 Paul Lesniewski <paul@squirrelmail.org>



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

This plugin provides configurable means to allow users to
quickly purge one or more messages without moving them to
the trash first.  A button (typically labeled "Wipe") can
be shown on the message list screen for any folder (configurable
by the administrator and/or the users), as can a "Wipe" link
on the message view screen.  For SquirrelMail versions 1.4.x,
a "bypass trash" checkbox can also be displayed, which modifies
the "Delete" button as such (this is natively supported in
versions 1.5.x).

If the administrator allows user configuration of where these
items are displayed, the user can navigate to the "Folders"
link from the main SquirrelMail navigation to configure this
plugin as needed.



License
=======

This plugin is released under the GNU General Public
License (see COPYING for details).



Donations
=========

If you or your company make regular use of this software, please
consider supporting Open Source development by donating to the authors
or inquire about hiring them to consult on other projects.  Donation/
wish list links for the author(s) are as follows:

Paul Lesniewski: https://sourceforge.net/donate/index.php?user_id=508228



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

  * SquirrelMail version 1.4.11



Troubleshooting
===============

  * If changes to the configuration file don't seem to be
    having any effect, ensure that you are editing the correct
    configuration file.  If one is located in the main SquirrelMail
    config directory (named "config_bypass_trash.php"), it will
    always be used.  Otherwise, "config.php" in the bypass_trash
    plugin directory will be used.



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

Before looking for help elsewhere, please try to help yourself:

  * Read the Troubleshooting section herein.

  * Look to see if others have already asked about the same issue.
    There are tips and links for the best places to do this in
    the SquirrelMail mailing list posting guidelines:
    http://squirrelmail.org/wiki/MailingListPostingGuidelines
    You should also try Google or some other search engine.

  * If you cannot find any information about your issue, please
    first mail your help request to the squirrelmail-plugins
    mailing list.  Information about it can be found here:
    http://lists.sourceforge.net/mailman/listinfo/squirrelmail-plugins
    You MUST read the mailing list posting guidelines (see above)
    and include as much information about your issue (and your
    system) as possible.  Including configtest output, any debug
    output, the plugin configuration settings you've made and
    anything else you can think of to make it easier to diagnose
    your problem will get you the most useful responses.  Inquiries
    that do not comply with the posting guidelines are liable to
    be ignored.

  * If you don't get any replies on the mailing list, you are
    welcome to send a help request to the authors' personal
    address(es), but please be patient with the mailing list.



TODO
====

  * Ideas?



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

  v1.0  2009/04/21  Paul Lesniewski <paul@squirrelmail.org>
    * Initial release

