################################################################## # Autoresponder and Mailing List Manager AMLM # # Version 4.0 Lite # # Copyright 2005 # # Last modified 23 May 2005 # ################################################################## # COPYRIGHT NOTICE # # # # Copyright 2005 # # # # Please read license.htm or license.txt file # # before proceeding with installation. # # # # You are granted permission to use this Software as long as: # # # # - You do not modify the Software in any way # # - You do not modify this agreement in any way # # - You do not claim ownership of any ammended files # # - You do not remove any copyright notices # # - You do not change/remove the 'AMLM 4.0 Lite' name in any # # of the source files, generated URLs and outgoing emails # # # # Modifying, selling the code for this software over the Internet # # or in any other medium is forbidden. # # # # If you really need to remove the return links, go to # # http://www.DrQuek.com/perl/autoresponder # # and upgrade to the Pro version # # # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, # # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES # # OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND # # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT # # HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, # # WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR # # OTHER DEALINGS IN THE SOFTWARE. # # # ################################################################## INSTALLATION Please read this document completely before proceeding with installation. 0.========== Summary of important information you need from your web host. You can log into your web host's control panel to obtain the information below. Alternatively, you can contact them via email to request for the information (copy and paste them into your email). Record it below: MYSQL: Database server:_________________________ Database name:___________________________ Database username:_______________________ Database password:_______________________ Database prefix (optional):______________ Mail Program Setting: Sendmail path (eg, /usr/sbin/sendmail):___________________ Send through (eg, sendmail):______________________________ SMTP server (eg, mail.mydomain.com):______________________ 1.========== Upload all the files contained in this archive (retaining the directory structure) to the /cgi-bin/ directory on your server or hosting account. Tip: I suggest you to create a new subdirectory in your /cgi-bin/ For example /cgi-bin/amlmlite/ All files should be uploaded in ASCII mode. If you are unfamiliar with what this means please refer to your FTP client documentation. In most cases this is all handled transparantly by your ftp client but if you encounter problems later you should be sure the files were uploaded correctly as described here. HINT: A good FTP client you can use is CUTEFTP. 2.========== Using your FTP client set the permissions of the following files to CHMOD '755' conf.cgi func.cgi install.cgi register.cgi responder.cgi broadcaster starter.cgi Check that all the above files have attributes changed to "-rwxr-xr-x". All other files will have permission CHMOD '644' HINT: To change the file permissions, right click and select "change file attributes" in your FTP client, enter the number into the Manual box. 3.========== Once all the files have been uploaded and permissions set you should point your browser to the install.cgi file. For example if your domain name is www.mydomain.com and you placed AMLM in a directory http://www.mydomain.com/cgi-bin/amlmlite/ you would enter http://www.mydomain.com/cgi-bin/amlmlite/install.cgi into your browser. When you have done this you should see the Installation screen appear. Before proceeding with installation you should ensure you have a database available. Most good hosting accounts now come with at least one database as part of the basic package although it may need to be setup before first use. Ask your provider for details if you are unsure whether you do or not. Once you have reached the installation page you need to fill out several fields. There are 3 steps. --Step 1: To start installation please enter your registration key (license code). It will be in the email you received during registration at our site. --Step 2: Database connection If you do not have or do not know the database server, database name, database username, database password, please check with your hosting provider. The database server is typically localhost but this is not universal! The database prefix allows you to enter a few characters, short name, etc. which all tables used by this installation will be prefixed with. The default (swd_) will usually be fine. However if you have more than one copy of AMLM using the same database be sure to alter it or you will receive errors during installation. HINT: Go to the Control Panel of your web host, click MYSQLSERVER to do the above changes. Note you must set the database user role as: dba. Record the following information: Database server:_________________________ Database name:___________________________ Database username:_______________________ Database password:_______________________ Database prefix (optional):______________ --Step 3: Password to access to administration page. You will need to choose a password for the initial administration account. You will be able to change it later. Write down your password here for record purpose:________________________ The installation script will create and populate all the necessary tables. 4.========== Now you MUST set up the activation link. You place a 1-pixel "image" on a well viewed web page, which activates the script periodically. If there even one visitor a day it will work fine. When activated, it checks the POP3 email accounts you specified and sees if it needs to send a confirmation e-mail to your contacts and adds them to your mailing list. The syntax of the activation "image" follows: You can even place the activation image on another domain. It will activate the script everytime somebody visits that page. However, in my experience, I suggest that you place it on the entry page to your site. 5.========== Now login to the admin area using the password you specified during installation. To run the admin area, just point your browser to the responder.cgi file Like this: http://www.mydomain.com/cgi-bin/amlmlite/responder.cgi After you logged in please go to "GLOBAL SETTINGS" and enter all required information. Personal: Here you can set your admin email and admin name. Admin email:________________________________ Admin name:_________________________________ SMTP/sendmail: Here you should specify your server's mailing program Information required: Sendmail path (eg, /usr/sbin/sendmail):___________________ Send through (eg, sendmail):______________________________ SMTP server (eg, mail.mydomain.com):______________________ Access: Here you can change your password Time Synchronization: Change time depending on your time zone Once you have completed the installation, you need to delete out install.cgi from your server. Leaving it in place is a very serious potential security issue. 6. ======= Add New Account: Press "Add New Account" to set up your accounts. Press clone to copy an existing account. Next, click the new account name under "Your Accounts". Then Select: Account Options- set up double opt-in, subscribe/unsubscribe features. Your need to set up three webpages on your site as follows: Redirect subscriber: subscriber.htm ("Please check your email to confirm your subscription!") Redirect removals: removal.htm ("Your subscription is removed!") Double Optin: optin.htm ("Congratulation, your subscription is now confirmed!") HTML Form- copy the html code to use as form on your webpage. Subscriber Manager- view/edit your subscribers. Edit Messages- edit your sequential messages. Links- link tracking statistics. -------------------------------------------------------------------------------- If you like the script, please provide a link back to us :) See you at the bank, http://www.DrQuek.com/perl/autoresponder updated:5-8-2005