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

Description
===========
A user may now build a list of rules that will be used to determine if unsafe
images will be shown in HTML messages. If a message matches any of the rules and
contains images that would normally be initially hidden, then they are now shown
by default.

The user may choose to always show unsafe images, for all message. This is
obviously not recommended by the core Squirrelmail Development Team - or
they wouldn't have built this functionality to begin with. See the following:

http://www.squirrelmail.org/wiki/UnsafeImages

Usage
=====
A new section is added to the options page titled, 'Unsafe Image Rules'. Within
this page the user may define a number of rules to determine when messages are
from a trusted source.

These options are very similar to the core message filters plugin. A message field
(To, From, CC, Subject) can be matched either against a regular expression, or
simply searched to see if the given string is within the field. If a match is
found then unsafe images are always shown for this source.

Four options are seen above the rule list which are unchecked by default:

- The first states that all sources are to be trusted, not recommended as
  discussed above.
- The second option ('Trust sources in address book') will show unsafe images
  from any address listed in your personal address book.
- Third option ('Trust anything I send') will show unsafe images sent by
  any of your defined identities (useful if you are looking at your 'Sent'
  folder).
- The final option ('Trust defined sources') will search the options added below
  (entered by clicking the 'Add New Rule' link). If this option is unchecked
  then adding your own rules below is pretty pointless.

To Do
=====

1. Perhaps add a link to the bottom of a message to 'Always show unsafe images
   from this source'. Trouble is - if we did that then how would we know which
   field to take? Also - people would be tempted to just press that when they
   hadn't actually looked at the images yet, which might not be so good.

2. Suggestions welcome.

Changes
=======

v0.1    10-May-2002     Initial version.
v0.2	25-May-2002	Added address book and identities matching. Made
			'regexp' and 'contains' check separate. Added
			admin option to remove the 'Trust all sources'
			user option.

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/
