# $ # $ (Guestbook version 4.8) # $ # $ Thank you for using my guestbook script, this has been popular with the web community # $ and I have noticed many people using it on the internet, especially 2 sites that I # $ know of that have been offering use of it for free. This means a lot to me because # $ they have chosen it over the many other guestbook scripts out there. # $ # $ This code is distributed in the hope that is will be useful but WITHOUT ANY # $ WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY DISCLAMED. This includes # $ but isn't limited to warranties of MERCHANTABILITY or FITNESS FOR A PARTICULAR # $ PURPOSE. The RESELLING of this code is STRICTLY PROHIBITED. # $ # $ $Revision: 4.8 # $ $Author: Paul Williams # $ $Email: paul@rainbow.nwnet.co.uk # $ $URL: http://www.cougasoft.org/ # $ $Created: 05/07/1996 17:16 # $ $Last Modified: 01/04/2000 18:16 # $ # $ Copyright 1996, 1997, 1998, 1999, 2000 Cougasoft. All rights reserved. # $ -- ' This script has undergone the similar script design as cougalinks, I have added a -- ' few routines and code to help me with my scripting, in doing so, it has reduced the -- ' code a bit but the comments have put the size back up again ;) -- ' -- ' The main additions include the TARGET options and now the script checks for 'fake' -- ' posts, this basically means text over 28 characters in length are deleted. This -- ' has stopped those posts which people just repeat a character and put the table size -- ' out of whack (did I really just say out of whack ?) Ok, you should of recieved the following files to get this script up and running :- 1. igb.cgi 2. igb-admin.cgi 3. igb-pref.pref 4. igb-data.ais 5. README 6. guestbook.gif If you don't have all these please go back to - http://www.cougasoft.org/ README CONTENTS --------------- 1. Installation [igb.cgi + igb-admin.cgi] ------- Change perl location ------- Upload + Chmod 2. Administration help ------- Email|User Pref ------- Update Guestbook ------- Layout|Data Pref N.B. If you have any problems with getting this script to work please :- 1. Exhaust this README file. [No Luck ?] 2. Email me with the problem (Be as specific as possible) [No Luck?] 3. Paul Install option has been taken away, if you email me really nicely with your ftp server, username & password I might install / check a script for you but I have recently been abused by people taking advantage of my kind offer. Register the script ;- Please Visit : http://www-register.cougasoft.org/register.cgi # # $-------------------------------------------------------------------------------------------- # # I N S T A L L A T I O N # # $-------------------------------------------------------------------------------------------- # Change the first line -[ #!/usr/bin/perl ]- to the path your perl interpreter is located on your server. The most common location is as its set at the moment but some servers I have been on have perl located at #!/usr/local/bin/perl. ---- Please do this for igb.cgi & igb-admin.cgi If you don't know where it is you can either :- 1. Type -[ which perl ]- on the telnet screen. 2. E-mail admin and ask where perl is located. 3. If you are admin, go rent a movie ! ;) # # $-------------------------------------------------------------------------------------------- # # U P L O A D I N G - S C R I P T S # # $-------------------------------------------------------------------------------------------- # Upload the following files:- No. Script|GIF Where Chmod to ---- ---------- ----- -------- 1. igb.cgi /cgi-bin/ 755 1. igb-admin.cgi /cgi-bin/ 755 2. igb-pref.pref /cgi-bin/data 666 3. igb-data.ais /cgi-bin/data 666 5. guestbook.gif /imx/ - NOTE: - Make sure your CGI-BIN is chmodded to 731 (not necessary) - Make sure the DATA files are chmodded to 666 NOTE: - When you upload the preference file you can do one of two - things, upload it to the data dir (recommended) or place it - in the same directory as the script. Either way the script - will still work the same ;) [Ques: So Paul, how do you upload your scripts ? ]. [Answ: Good question :) here is how and what I use :- 1. I open WS_FTP95 [http://www.ipswitch.com] 2. Log on to my server 3. Upload script|data files to my directory in ASCII mode. - If you upload in binary the script may not work. 4. Chmod the script|data files to the correct permission. Follow these stages to chmod :- - Got to the DIR with the script (data file) in. - Right mouse click in the white box on the right under 'Mkdir' - Click on FTP Commands - Select 'SITE' - It should then ask you to enter a 'SITE STRING' Type there chmod 755 cougalinks.cgi 5. Check the script in my browser for any errors. 6. Log off. 7. Have a nice cup of coffee and bask in my uploading glory :) # # $-------------------------------------------------------------------------------------------- # # A D D I T I O N A L - I N F O # # $-------------------------------------------------------------------------------------------- # NOTE: Once these stages have been completed correctly the script should work ! Now, go to administration [cl-admin.cgi] and you will be prompted to make your password, and change all the necessary locations & info needed to start the script. The script needs to set a few valuable preferences to get it to work successfully. One last thing, DON'T PUT YOUR OWN PASSWORD STRAIGHT INTO THE PREFERENCE FILE. It's encrypted by the script so if you set it to 'daniel' it just will not work ;) Also, if you check the top of the scripts there are certain $variables $US variable; If you are outside the US, you don't need the state field inside the sign guestbook section, because of this, if you set this variable to 0 or comment it out, the state field is not used; $SLOW variable; Set this to a zero value or comment it out to speed the script up, I suggest doing that only after everything is working, basically, my script checks the locations of the data file and sendmail program, if they are wrong the script will not continue, skipping this will speed it up a little $CHECK_MAILPROG variable; On some servers there is a problem in which I have confirmed the sendmail program location on the server yet perl says it doesn't actually exist, what the.... ? SunOS 2.? was the OS this happened but I am not sure if it happens on other scripts so I added this. # # $-------------------------------------------------------------------------------------------- # # A D M I N I S T R A T I O N, E M A I L ( P R E F ) # # $-------------------------------------------------------------------------------------------- # EMAIL PREF ---------- Name - Your name Email - Your E-mail E-mail thanks - If this is checked, each signatory gets a thank you email from you which is set in the Mail Them What textarea Notify you - If this is checked, the script lets you know every time someone signs your igb . It sends you their name, email address, time they signed and the original post () Subject - This is the subject of the email that is sent to the signatory. Be creative ;) Mail them what - Again, if email thanks is set, what ever is typed here is sent to the signatory, the key holds certain variables that can be used (%n == first name) USER PREF --------- Update your username || password at any time, although it is crypted, I suggest you change it every now and again. # # $-------------------------------------------------------------------------------------------- # # A D M I N I S T R A T I O N, U P D A T E - I G B # # $-------------------------------------------------------------------------------------------- # Read every comment and decide wether or not you want to keep it, or if you just want to delete oldish messages.... just check the signing you want to delete and press the delete button. simple as :) Fixed a bug which deleted each signing by line number, that was a bad move in the last version because if you reloaded the page ? It was deleted. # # $-------------------------------------------------------------------------------------------- # # A D M I N I S T R A T I O N, L A Y O U T ( P R E F ) # # $-------------------------------------------------------------------------------------------- # LAYOUT PREF ----------- Guestbook Name - This is the name used in the title of igb.cgi, set it to something like "Paul's" and the title will come out as [Paul's Guestbook]. Your URL - Change this to the URL of your homepage, it is put on the main guestbook page. Guestbook GIF - Change this to the URL of my guestbook GIF, or the URL of your own graphic you would like to use. [Body text Page BgColor Background GIF Link Visited Link Active Link Table BgColor] - With the exception of Background GIF, these are all colours which you can alter to suit your needs. [ Must be in hexadecimal format i.e. #C0C0C0 ] Disallow HTML - If this is checked, people can not add HTML to their post. I suggest ticking this because a lot of people post their banners etc... and when your guestbook loads its SLLLOOOWWW. Order - Select how you want the messages to be displayed. Signing Amount - Stop the guestbook from getting out of hand by setting this to a fixed amount. Stops an overflow of signings. Target - Link Target for sign-guestbook and HOME (if it is left blank, _self is defaulted to it. URL Target - Target for the random links in your database, I set this as NEW so the guestbook page stays as is and the link opens in a new browser. (defaults as _self if left blank) DATA PREF --------- IGB Data File - The location of igb-data.ais on your server. e.g 'data/igb-data.ais' '/usr/home/mysite.com/public_html/cgi-bin/data/igb-data.ais' Mail Program - This script requires [SENDMAIL] Type in the full location. e.g. /usr/sbin/sendmail If you don't know where it is, e-mail admin and ask where sendmail is located. Alternatively, if you know that the location you are entering is correct but the script keeps telling you its not there (a problem on some servers) look at the top of the scripts and edit accordingly. # # $-------------------------------------------------------------------------------------------- # =========================================================================================== # $-------------------------------------------------------------------------------------------- #