PHPEmailList

A PHP Newletter sysetm
======================

http://phpemaillist.sourceforge.net

Author:Michael Thompson michaelt@o2.ie

This software is licensed under the GPL. Please read LICENSE for more information.

PHPEmailList is a newsletter system that can be easily integrated with
an existing web site. Once logged into the administrative interace you
can create new lists and messages, then check what messages are queued
to be delivered, send them to different lists or delete them. The
Mails are sent when you click send on the queue page and a log is kept of
every email that is sent. A custom Header and Footer can be added to
every email.

Features
--------
-Login as root, password is root. You can change your password once you've logged in.

-Create a new newsletter, giving it a title and description.

-Subscribe your self to this list.

-Go to lists.php and click on your new newsletter to see who's
subscribed, if you click on your name you should be able to see your
userid.

-Click on the test list and type in your userid to subscribe to the test list.

-Create a message in compose.php.

-Go to queue.php to send the message.

-Go to messages.php to see what messages were sent, click on a message
to see who it was sent to and to re send it, to the same or different
lists.

-Send messages to the test list first and then to the main list once
they look OK.

-Edit config.php and change the header and footer lines. The footer
contains an example of how an unsubscrive url could look. Clicking on
this link will unsubscibe the user without any further interaction.

What you need to run this script
--------------------------------
PHPEmailList uses:

Smarty see http://smarty.php.net
phpmailer see http://phpmailer.sourceforge.net

These libraries have been included. You will also need MySQL and php.

Instalation
-----------
-Copy and upack these files on your web server.
 tar zxfp phpemaillist-0.3.tgz
-Make sure that the directory templates_c is writable by your web server, i.e. chmod 777 templates_c
-edit include/config.php to set up the name of the database etc.
-run setup.php from your web browser to initialise the database.

Tips
----
If you'd like to use your own user table it must have the following fields.

CREATE TABLE phpemaillist_users (
  id smallint(6) NOT NULL auto_increment,
  email varchar(255) default NULL,
  passwd varchar(50) default NULL,
  admin int(1) default 0,
 

Password is stored as the encrypted version and can be sent as part of
the email. To change the name of the user table useb by phpemaillist
use a command like,

perl -pi -e 's/phpemaillist_users/your user table name/g' *.php

Run this command in both the top directory and the include directory.

When subscribing the user will be prompted to fill any fields in this user table.