Contact clean squirrelmail plugin
http://www.ContactClean.com/download/squirrelmail/

By Ian Rogers <ian.rogers@ContactClean.com> May 2007


Installation
============
As with other plugins, just uncompress the archive in the plugins
directory, go back to the config directory and run conf.pl


SM Version Compatability
========================
V3.x of this plugin was developed under Squirrelmail version 1.4.8, and had some
minor testing in 1.4.4, but should also works with subsequent versions in the 
1.4.x branch.

Uses sq_change_text_domain() so requires the compatibility plugin v2.0.7 if used in 
Squirrelmail versions less than 1.4.10 or 1.5.2

Questions and comments etc. can be sent to the ian.rogers@ContactClean.com


Description
===========
This plugin adds a link into the personal options page and the 
addressbook page so the user can, respectively, register their new and 
previous email addresses with the ContactClean.com database (so that 
long-lost contacts can find them again) and verify that their addressbook 
is up-to-date.

When a user verifies an address book, each address is one-way encoded with md5 
and  sent to the ContactClean SOAP server. The ContactClean system obviously can't 
decode this list, so the addresses can't be harvested, but if a target address 
is *already* registered with ContactClean then the server makes a match against 
its own, stored, md5 encoding. 

If the target has authorised immediate returns then their new address is 
presented back to the user with a button to update the addressbook 
(a useful comment is added to the comment field when an address is updated). 

If the target has opted to vet searches then the user's address is stored in 
the ContactClean system and an email sent to the target to notify them that 
someone is trying to get in touch - security and privacy are top priorities 
at ContactClean.com!

See http://www.ContactClean.com/docs for more details of the free service.


Future Work
===========
* Currently only one ContactClean license can be assigned to the default
  identity. In the future ContactClean will support multiple identities in 
  one account.

* Detect if installed on a PHP5 site and use the native soap instead
  of nusoap library

Copyright
=========
This program is free software (as in both "free doughnuts" and 
"free speech") - 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
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.

