********************************************************************
                     D R U P A L    M O D U L E
********************************************************************
Name: phplist.module
Author: Aaron Welch <welch at advomatic dot com>
********************************************************************

** NOTES **
- This is a mailer engine, and requires massmailer.module to function
- This module will only run on a system that can execute a bash script
  from a shell_exec call from php
- PHPlist requires mysql, so this module also will only work with mysql

INSTALLATION:

1. Leave the phplist directory in the engines subdirectory of the
   massmailer module directory of your Drupal installation. That is
   modules/massmailer/engines.

2. Download http://www.phplist.com/files/phplist-2.9.4.tgz and copy
   the 'public_html/lists/admin' directory into
   modules/massmailer/engines/phplist/phplist with the texts directory.
   
3. Load the database definition file using the tool of your choice 
   (e.g. phpmyadmin). PHPlist requires mysql. For command line access use:
   
     mysql -u user -p drupal < phplist.mysql
   
   Replace user with the MySQL username, and drupal with the database
   being used. You will be prompted for a password. The password is
   the same that you used in setting up Drupal.

4. Now execute the following mysql statements after replacing "my.domain.invalid/directory"
   by your domain and any subfolders you should use:

   REPLACE INTO phplist_config (value, item) VALUES ('http://my.domain.invalid/directory/?q=phplist', 'preferencesurl');

   REPLACE INTO phplist_config (value, item) VALUES ('http://my.domain.invalid/directory/?q=phplist', 'unsubscribeurl');
   
5. Enable this module by navigating to:
        administer > configuration > modules
    
6. Select and save this module under the massmailer module settings page
        administer > settings > massmailer
   Once this engine is selected, use the same page to configure it
   in the engine settings section below the massmailer settings.

7. chmod the phplist file in phplist/bin to be world executable (0755)
