PHP mailing list script v1.0
(c) Kai Blankenhorn
www.bitfolge.de/en
kaib@bitfolge.de


LICENSE
=======

This program is free software; 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 (at your option) 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.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.



FEATURES
========
- needs no web interface
- majordomo-like mail commands
- open or members-only lists
- supports multiple mailing lists
- subscripients stored in mySQL database



HOW IT WORKS
============
Unlike many other PHP mailing list scripts, this one doesn't need a web interface.
Everything, including sending messages, subscribing and unsubscribing, can be done
through a simple mail interface, similar to majordomo.
To do this the script checks a specified POP3 account and sends all messages it
finds in the inbox to all list subscribers.



REQUIREMENTS
============
- mySQL database
- access to create cron jobs
- any POP3 account



HELP
====
There are two tables in the database dump. The more important one is lists, where
all mailing lists are configured. Here's a short explanation of the table's
columns and what they do:
- ID			only used internally
- prefix		the prefix used for this mailing list on the subject line
			(eg. "[PHP-Dev] Re: what was I saying?" - "PHP-Dev" is
			the prefix)
- topic			the list's topic
- description		a longer description of the list
- adminAddress		the email address of the list's administrator
- adminPassword 	the administrator's password (not used yet)
- address		email address where mails to this list should be sent to
			(e.g. phpdev@somehost.com)
- server		the POP3 server of the list's account
			(e.g. pop.somehost.com)
- account		the POP3 account the fetch mails from (e.g. phpdev)
- password		the password for this POP3 account
- membersOnly		0 or 1; sets if anyone can post on this list or only list
			subscribers
- inviteMembers		0 or 1; sets if an invitation mail should be sent to
			unauthorized senders
- approveMembers	0 or 1; sets if authorization is required for sending to
			this list. Authorization is done by the list admin.
- moderated		0 or 1; sets if only the admin can send messages; all
			other messages are sent to the admin for approval
			(not yet implemented)




INSTALLATION
============
1. Download the pop3 class by Manuel Lemos
   (http://freshmeat.net/projects/pop3class)
2. Create the database tables needed using the db dump in list.sql
3. Using some db admin tool create your mailing list in the lists table
4. Set up a cron job to run list.php every once in a while.