E-mail accounts

For the newsletter system to function properly, there must be several accounts setup. As well, each of these e-mail accounts must be configured to properly start the necessary scripts to handle incoming e-mails. On Unix-type systems, this can either be done by creating e-mail aliases in the /etc/aliases file, or by creating the necessary accounts and editing their .forward files.

To allow for multiple copies of the newsletter system to be installed on a single machine, each installation requires a prefix for each e-mail address. By default, this prefix is newsletter, but to change this value, simply edit the global-fcns.pl file and search for the line containing:

$EMAILPREFIX  = 'newsletter';

and change the value of this variable to the appropriate prefix.

The e-mail accounts required and their configuration requirements are:

newsletter-cancel: This e-mail account should be configured so that any e-mails coming in to it are passed through to the user-delete.pl script. Any e-mails sent to this account are deemed to be requests from subscribers to remove themselves from the distribution list.
newsletter-subscribe: This e-mail account should be configured so that any e-mails coming in to it are passed through to the user-verify.pl script. E-mails that are sent to it are confirmations from users that they would like to be subscribers to your newsletter. When a user is initially sent their confirmation message and they must reply to it to complete their registration, this is the account that those e-mails get sent to.
newsletter-ad-bounce: This e-mail account should be configured so that any e-mails coming in to it are passed through to the client-bounce.pl script. When advertisers initially register themselves with the newsletter system, if the e-mail account that they have provided is incorrect (and thus the e-mail bounces), this script will remove their advertisements from the system.
newsletter-bounce: This e-mail account should be configured so that any e-mails coming in to it are passed through to the user-bounce.pl script. When newsletters are delivered en-masse, any bounced e-mails will be sent back to this address and the subscribers account will be updated accordingly.
newsletter-ignore: This e-mail account should be configured so that any e-mails coming in to it are simply thrown away. There are other e-mail systems on the Internet aside from SMTP (e.g. UUCP), and even still, not all SMTP mail systems properly support the use of the 'Errors-to' and 'Reply-to' headers. To facilitate the possibility of any of these servers sending back spurious messages, they will be sent to this address.