****************************
* Address Book Take plugin *
****************************

If you would like to add the sender of a message you're reading to your
address book quickly and easily without cutting and pasting, then this
plugin simplifies the process.  It scans the mail message you're reading
for any email address and lets you add it with a quick form.

Address Book Take plugin was written by Tyler Akins <fidian@tiny.net> for 
SquirrelMail webmail interface. It is bundled with SquirrelMail since 1.4.0 
version. This plugin version is bundled with NaSMail webmail interface and is 
maintained by the NaSMail Project developers.


Features
========
* Saves you the need to Cut & Paste
* Grabs addresses from To:, From:, Reply-To:, CC: and Sender: fields
* Address verification


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

By pulling down a list and selecting the address you want to add, you
are then presented with a familiar Add to Personal Address Book screen.
By filling out this form, you will then add the email address to your
personal address book.

The user can decide if the box is shown, where it is shown on the bottom
of the Read screen, and whether or not to attempt to verify that the
address works.


Future Work
===========
* Grab addresses from message body
* Search more headers (when they become available)
* Ignore user's IDs
* When trying to verify if the address works, checks to see if the host
  has any DNS record available. Main issue - lack of checkdnsrr() on Windows.


Installation
============
Enable plugin in NaSMail configuration

    $ cd /var/www/nasmail/config
    $ ./conf.pl --install-plugin abook_take

If you can't use conf.pl utility, check NaSMail documentation about other
configuration options.
