**************************************** * NP Subscriber 2.0 * * Author: Brandon Stewart * * * * * **************************************** * Even though you probably won't, I * * STRONGLY reccommend reading this * * entire README file before you use * * the script! * **************************************** ************************* CONTENTS +WHAT THIS SCRIPT DOES+ +USER AGREEMENT+ +HOW TO INSTALL AND USE+ +HOW TO UPDATE+ +FREE SUPPORT+ +NOTES+ +VERSION HISTORY+ ************************* **************************************** [][][][][][][][][][][][][][][][][][][][] **************************************** +WHAT THIS SCRIPT DOES+ NP Subscriber is your basic mailing list manager with some very powerful features. These features include automatic subscribing/unsubscribing, banned addresses, message archiving, confirmation of email addresses, and a COMPLETE web interface (only 2 things need to be manually configured, which are covered below). **************************************** [][][][][][][][][][][][][][][][][][][][] **************************************** +USER AGREEMENT+ NP Subscriber is available for free because it contains a small credit (saying "Powered by..." on almost every page/message created by the script. DO NOT REMOVE IT!! Also, if you really like the script, and want extra features, please consider upgrading to NP Subscriber PRO or purchasing the registered version of NP Subscriber. **************************************** [][][][][][][][][][][][][][][][][][][][] **************************************** +HOW TO INSTALL AND USE+ 1. Open up firstrun.cgi in a text editor (like Notepad) and edit the path to Perl (this is the first line in the code). Make it the path to Perl on your server (such as #!/usr/bin/perl). Do the same for subscriber.cgi. 2. Make the "$pass" variable in subscriber.cgi to what you want your admin password to be. 3. Upload firstrun.cgi and subscriber.cgi via ASCII mode, not binary! This is very easy to do with a program such as WS_FTP (which you can get at free). 4. Load up firstrun.cgi in your browser and follow the onscreen intructions on configuring your script. 5. After you are done with configuration, immediately delete firstrun.cgi. Failure to do so can cause anybody to access it and reconfigure your script at any time!! This is very important!! 6. Load up http://your-path/to/subscriber.cgi?admin and you're ready to go! NOTE: You MUST add the "?admin" after the script's name anytime you want to access the admin screen! **************************************** [][][][][][][][][][][][][][][][][][][][] **************************************** +HOW TO UPGRADE+ If you've installed and are currently using a version of NP Subscriber to manage your mailing list, here's how you can upgrade to 2.0 without losing any data: 1. Open up subscriber.cgi and make sure the path to Perl is correct. 2. Upload subscriber.cgi so that it replaces your current one. 3. Log in to NP Susbcriber and go to Edit Variables. 4. Make sure all variables are set correctly (new variables have been introduced over versions). 5. Click edit. 6. You're done... :) **************************************** [][][][][][][][][][][][][][][][][][][][] **************************************** +FREE SUPPORT+ If you absoultely cannot get the script to work and you've done everything possible, you can still get free support. Just email with a detailed description of EXACTLY what is wrong with as much server info as possible. URLs are helpful as well in some cases. **************************************** [][][][][][][][][][][][][][][][][][][][] **************************************** +NOTES+ The included "htmlfragment.html" contains the HTML code you need to use to create the form that people will enter their addresses in. You will need to change the "form action" in "
" to reflect the path to subscriber.cgi on your server. You can use this script to manage multiple lists, sort of. For each script you want, you need to have the files in different directories. For example, let's say you have three lists you want to manage. You'd simply have a different directory for each list: http://ser.ver/list1/subscriber.cgi, http://ser.ver/list2/subscriber.cgi, http://ser.ver/otherlist/subscriber.cgi, and so on. But, if you want to be able to manage multiple lists without the above trouble, consider purchasing NP Subscriber PRO. **************************************** [][][][][][][][][][][][][][][][][][][][] **************************************** +VERSION HISTORY+ 01/05/04 -- v2.0: New Features: > Spam Guard: Requires a wait period between subscribe requests. > Safety Net: Catches bad symbols in the header/footer and address variables > Unsubscribe Link > (Registered) Message Templates Bug Fixes: > All screens encountered by an admin or user should now be fully formatted (no more blank pages) > No more dupes in the banned list. > List name is displayed in unsubscribe mail now. 03/29/02 -- v1.5: New features: > HTML Messages > Filter bad addresses. > More secure. Script is now form driven and checks IP address of anybody trying to access admin functions. The old version put the password in the URL, which made it viewable to anybody that could see server logs. > Preview Message > Address confirmation is now optional. > Screens users see now (should) all have the header and footer displayed. Bugs Fixed: > Archiving now works properly... Previously, line returns didn't get translated into
s to allow them to be displayed in the HTML correctly. Oops.. > Header/Footer editing no longer gets you extra line returns in the text field. This didn't affect what users saw, but to the webmaster that edited script variables a lot, it was quite annoying. > Some other small things... 03/05/01 -- v1.0: First release! **************************************** [][][][][][][][][][][][][][][][][][][][] ****************************************

Valid XHTML 1.0! Valid CSS!
©1999-2007 Brandon Stewart
"It is not only possible, it is essential!"