IntroductionThe script is designed to be installed via FTP to a remote server running PERL 5 or higher. Designed for easy setup and configuration, AFFA is capable of powerful filtering that can prevent undesirable links being added to your site. Download and InstallationTo install AFFA, first click on your choice of download method and file format (see below) and download it to your computer. You will need to decompress the files that are contained in the AFFA archive. You can edit the top of the affa.pl file to reflect the directory path to your perl compiler and sendmail script. (You may turn off the email autoresponder by changing the "$mailon = 1 ;" to "$mailon = 0 ;" at the top of the affa.pl file) Then edit the affa.cfg file to reflect the settings you need to run AFFA. Pay particular attention to the directory paths for the required files.
The archive contains 10 files. affa.pl - The perl script. affa.cfg - The configuration file. header.htm - The header is attached to the top of the link list. footer.htm - The footer is attached to the bottom of the link list. db.txt - An empty file used to store the links. email.txt - A template to change to modify the email autoresponse. affanow.gif - AFFA gif file to be uploaded to the site if left in the header.htm manual.txt - The instruction manual for AFFA. history.txt - The release and revision history of AFFA. licence.txt - The software licence for using AFFA. The last 3 files are not required to make the script work and should not be uploaded to your website. It is advised that you place all the files in the one directory. You must ensure that the directory chosen is permitted to run CGI or PERL scripts. The email.txt file must be placed in the same directory as the affa.pl and affa.cfg files (the affanow.gif file should also be in this directory if used). The db.txt, header.htm and footer.htm files may be placed in any directory as long as the directory path is set in the affa.cfg file. When the files have been placed on your server, you must CHMOD the affa.pl file to 755. The db.txt file must then be set to CHMOD 666. The script can be loaded in your web browser in one of 2 ways. The first is calling the affa.pl file directly. For example: http://www.yourdomain.com/directory/affa.pl In which case, do not supply a target file in the affa.cfg file. Or you can load a page created by AFFA, like this: http://www.yourdomain.com/directory/links.htm To install the script like this, you must specify a target file in the affa.cfg file and then create an empty file called links.htm and upload it to the server so it is the same path as set in the affa.cfg file. Then CHMOD the links.htm file to 666. You must then change the HTML in the header.htm file. |