###################################################################### # Autoresponder and Mailing List Manager # # Version 4.19 # # Last modified 12/05/2005 # ###################################################################### # COPYRIGHT NOTICE # # # # # # This script can be used as long as you don't change this header # # or any of the parts that give me credit for writing this. # # # # By using this script you agree to indemnify me from any liability # # that might arise from its use. # # # # Redistributing\selling the code for this program without prior # # written consent is expressly forbidden. # # # # Use for any unauthorized purpose is expressly prohibited by law, # # and may result in severe civil and criminal penalties. # # Violators will be prosecuted to the maximum extent possible. # # # # YOU MAY NOT RESELL OR RELEASE THIS PROGRAM TO OTHERS # # # ###################################################################### 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: CRON (if you want to use it): Absolute path to your Broadcaster directory:_____________________________ (eg., /hsphere/local/home/yourname/mydomain.com/cgi-bin/amlm) 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.========== 1.1 Setting up CRON (Optional) If you want to set up CRON you need to read this section. If you prefer or if you do not understand this, you can set up an activation link (Section 4). Firstly you need to set up script through the CRON: In the 'startercron' script in 'cron' folder in zip distribution, edit the line below "put there absolute path to your broadcaster directory": $yourdir='/hsphere/local/home/yourname/mydomain.com/cgi-bin/amlm'; Change it to your own directory path (refer to Sectio 0 above). Secondly, you must log into your webhost's control panel and do this: For some web hosts, click the FTP Manager and then CRONTAB to edit CRON */25 * * * * perl /hsphere/local/home/yourname/mydomain.com/cgi-bin/amlm/cron/startercron What this means: */25 * * * * (minute, hour, day, month, day of week) This will run a cron every 25 minutes. The following line runs perl (Notice the space after perl): perl /hsphere/local/home/yourname/mydomain.com/cgi-bin/amlm/cron/startercron If you do not know how to do this, ask your web host to do it for you. 1.2 Upload all files using FTP 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/amlm/ 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. If you do not want to use cron jobs to start broadcast you can remove your 'cron' directory from installation. HINT: A good FTP client you can use is CUTEFTP. 2.========== Using your FTP client set the permissions of the following 12 files to CHMOD '755' broadcaster sender conf.cgi func.cgi install.cgi register.cgi responder.cgi logpng.cgi starter.cgi xmlimport.cgi xmlexport.cgi r.cgi bounce.cgi CHMOD '666' to the file 'broadcast.log' - script will write broadcaster logs there if you will check option "Save broadcast logs" in the "Statistics" - "Current broadcast log". Check that all the above files have attributes changed to "-rwxr-xr-x". You do not have to do anything to the other files which will have permission CHMOD '644', exept 'cnf.rd'. While installing file 'cnf.rd' must be set to '666' permission after that you can change permission to '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/amlm/ you would enter http://www.mydomain.com/cgi-bin/amlm/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 4 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. The script will not work properly if you use a wrong registration key or if you ask for a refund (we will disable the script remotely). It will also not work properly if you exceeded the number of domains and copies you purchased. Refer to the website for details of the version you purchased. --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. NOTE: If you receiving error like: "Can not write to cnf.rd file: permission denied", please set '666' permissions to it. 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: Database installation. The script will check existing tables on your database. If tables with same prefix exist, you can skip database installation. If you are updating script from Lite or old version please look at update*.txt file for instructions. -------------------------------------------------------------------------------- !ATTENTION: If you chose to install database all existing tables will ! !be dropped. ! -------------------------------------------------------------------------------- --Step 4: 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. ===================== AFTER INSTALLATION YOU CAN REMOVE install.cgi and update.cgi scripts from server. Please backup and change permissions to '644' to your 'cnf.rd' file. ===================== 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. Alternative method is to set up script through the CRON: See Section 1.1 above for steps. 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/amlm/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 and update.cgi from your server. Leaving it in place is a very serious potential security issue. Also, CHMOD 777 to directory 'backup' - script will write MYSQL backups there. 6. ======= Add New Account: Press "Add New Account" to set up your accounts. Press clone to copy an existing account. 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. -------------------------------------------------------------------------------- P.S. The latest version of manual for the AMLM you can find at the http://www.DrQuek.com/perl/autoresponder/manual/index.htm -------------------------------------------------------------------------------- If you have any questions, suggestions, or find a bug, please let us know at http://www.DrQuek.com/perl/autoresponder If you like the script, please provide a link back to us :) See you at the bank, http://www.DrQuek.com/perl/autoresponder 050617amlm