Revisions for sam/lib/Driver.php

[cjh] Allow setting default values in config/attributes.php (Request #5597).

Also move forms to lib/Forms/.

SAM -> Sam

Add support for SpamAssassin 3+.
Bug: 3071
Submitted by: cgreen@sentex.ca

References.

ws

Remove extra stuff from @var lines in phpdoc.

Remove "optional" from phpdoc and fix spelling/ws.

Loosen the required parameters for SQL drivers and update phpdoc to reflect that.
Bug: 1796
Submitted by: selsky (at) columbia (dot) edu

Fix package names.

PHP 5 fixes.

Here she be! The things that aren't listed in the changelog are:

- rename spamassassin.php to spam.php (for consistency with the
registry name).
- blow away the now-unneeded template files.
- standardize on SAM (instead of Sam).
- the horde_id field in the sql driver is no longer needed --
just use the mapped username for everything.

Hopefully I didn't forget anything.  Still need to write up the
help for all the known attributes and add the amavissql driver.

Let all driver based applications use Horde::getDriverConfig().

private variable naming, is_a().

Some more include/require consistency fixes in factory methods.

Rename String::strtolower() to String::lower() and strtoupper() to upper().

Add String:: class and move all string manipulation methods from NLS:: to
String::

Simplify a lot of driver code; serialize() is faster than md5(), so we
can remove some code. Add a bunch of missing basename() calls, fix
some places where we shouldn't have returned a base class object, etc.

More strtolower() replacements.

BIG update.  Now properly loads global defaults (including whitelist and
blacklist).  Admins may now choose 'Save as Default' to set the global
preferences for users.

There have been a lot of changes and not a ton of testing.

1) Fix earlier fix (select 1 isn't a typo)
2) Create a defaults member array for storing the defaults and fix loading
   of the defaults
3) Only store prefs that differ from the defaults.

fix silly scope error

use a username hook (if desired).

Remove most instances of @ before include_once or require_once. We'll
probably want to trap some of these potential errors and handle them
more gracefully, but hiding them this way can make things like a
syntax error in a config file _very_ opaque and hard to debug.

Lots of code cleanup - on a closer look, a lot of things didn't make
sense to me, and the code in its previous state didn't seem to work at
all. This is simpler, corrects a bunch of style and coding errors
(inappropriate use of htmlspecialchars(), etc.).

Cleaned up the UI, too.

phpdoc/commenting fixes.

Several new features added to the spamassassin.php screen, a new help
system is working has been implemented (using the horde functions).

A bug was fixed with the database tables. Horde uses the full email address
as the username, whereas spam assassin only using the prefix of the email address.

I have added a field to the table to correct this problem.

initial SpamAssassin module commit.

Submitted by: Chris Bowlby <excalibur@hub.org>