Anti-Spam Scripts 3.40 BETA Setup Guide

Setup Notes for Version 3.40

Upgrading from versions 3.XX

If you are upgrading from a previous version you can use the same database (db.txt) so you won't lose any guestbook entries You should also delete or overwrite all the existing configuration files. You can back them up before doing this and copy over any custom HTML.

Setting up the Guestbook 3.40 is identical to version 3.32 and up with these additional steps.

Files and Locations
File	Location	Description
asgbv3b.pl	cgi-bin	The Guestbook script
asconfig.pl	cgi-bin	The configuration script
dbase.pl	cgi-bin	Database routines used by guestbook and config scripts
Zone.pl	cgi-bin	TimeZone functions used by Guestbook and Config Scripts Thanks to Grahm Barr
ColorPicker2.js	HTML directory	a javascript color picker used by the configuration script
datafiles.zip	cgi-bin or other directory	configuration files used by all the scripts
IMAGES/	HTML Directory	Images used by the Guestbook

If your OS does not usually allow scripts to create or even write files in the cgi-bin folder, you will have to select a folder outside of the cgi-bin folder where the script can read and write files. Preferably in a folder that is not accessible from a web browser.

In the distribution is a zip (or tar.gz) file called datafiles.zip that contains all the configuration files that the script uses.If your distribution didn't have this file download it here.
Place these in that folder, if your OS does allow file creation these files will be created automatically by the script.

NOTE: Even if the script can create the files you will need to put the file "English.txt" from the zip file in the datafiles directory that you choose.

Now you are going to have to tell the script where these files are. Open up the file asgbv3.pl in a text editor, scroll down and find the lines that read:

require $Bin."/Zone.pl";
require $Bin."/dbase.pl";

############# These lines have to point to your installation ###################
################################################################################
my $TEMPFOLDER="/tmp/";
my $DATAFOLDER= $Bin."/";

The first 2 lines need to point to location of the dbase.pl and Zone.pl files. It Should be the same directory as the other script files. If it is not then you will have to edit these lines otherwise you can leave them as they are.
The next line $TEMPFOLDER HAS to point to a directory where files can be created /tmp/ on linux and C://Temp// on Windows will usually be ok.
The next line $DATAFOLDER must point to the location of the datafiles. If you choose a location that has permission to create files then the script will create them the first time you run the script.
If you can't use a directory that allows file creation then you will have to place the files from the datafiles archive in the directory that you choose to use. If the datafiles will be in the same directory as the script you can leave this line as it is.

DO NOT use a directory that can be accessed from a web browser like in a folder on your website!

Once you have done this then open up the file asconfig.pl and do the same thing.
You must now repeat this process for the asconfig.pl file.

Now open the file called dbase.pl. Find the line that reads:
my $TEMPFOLDER="C://Temp//";
and change this to the location of a folder that you can create temp files, usually C:\Temp

Once you have completed these steps upload all the files to the proper locations on your server. You can then run the configuration script from your browser and set everything up.

Setting up version 3.40

I will list here what is different or has been added to 3.40 in setup and configuration for each section.
All other setup options will be the same as v3.30 and up

Section 1. Setp Script Variables
Variable	What it does	Default Value
USE SMILIES	Do you want to use SMILIES (emoticons) in your post	YES or NO Default: YES
MAX SMILIES	Maximum number of SMILIES to allow in a post. ( more than this number the script will ask the person to not spam Smilies)	1 to 100 Default: 4
IMAGE URL	The full URL to the location of the images (Smilies etc)	ie. http://www.myweb.com/images/
TIME ZONE	The timezone you want the guestbook to show the time for. This can either be EST CST etc or an offset from GMT in seconds ie -18000	The Script will try to determine the local offset and Time Zone
BAN ACCESS	IF set to YES any IP address that is in the BAN LIST will not be able to view the Guestbook or Add Guest page	YES or NO Default: YES
Section 2. Setup Messages
There are no changes in this menu
Section 3. Setup Entries
Different Entry Templates can be selected from the drop down menu. Select "SAVE" to use that format. You can also create a template and then enter a name for it and select "Save As Template". The new Template name will now show up in the drop down list.
Section 4. Guestbook Colors
There are no changes in this menu
Section 5. Guestbook Submission Page
You can select from this menu editing the Info Message and Title or the raw HTML for the submission page. You can also select a different template from the drop down menu. NOTE: Some ISP's limit the amount of data that can be sent from a script. If you get an error message from the ISP when you try to save the submission page you will have to edit the HTML.dat file manually.
Section 6. HTML Templates Advanced Editor
There are no changes in this menu
Section 8. Setup Error Messages
There are no changes in this menu
Section 9. Setup Word Filter
This is basically the same as previous versions. The main differences being you can now also edit the scan filter file. Selecting "Update Filter" will connect you to Anti-Spam scripts and update your word filter and Scan Filter (if selected) with the latest additions automatically.
Section 10. Setup Blank Insertions
There are no changes in this menu
Section 11. Setup Must Have Word File
There are no changes in this menu
Sections 12 & 13. Script Maintenance
There are no changes in these menus