# $
# $	(Cougalinks version 3.7)
# $
# $	Firstly I would like to thank you for using cougalinks, if you have given any
# $	tips or even more importantly bug tips ;) I would like to thank you !  Cougalinks
# $	has received a lot of praise over the last few years and I am glad to see so
# $	many people profiting from its use.
# $
# $	This code is distributed in the hope that is will be useful but WITHOUT ANY
# $	WARRANTY. ALL WARRANTIES, EXPRESSED 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: 3.7
# $	$Author: Paul Williams
# $	$Email: paul@rainbow.nwnet.co.uk
# $	$URL: http://www.cougasoft.org/
# $	$Created: 21/11/1996 13:06
# $	$Last Modified: 01/04/2000 18:14
# $
# $	Copyright 1996, 1997, 1998, 1999, 2000 Cougasoft.  All rights reserved.
# $

What's new in version > 3.5
	- Date routine finally sorted and is year 2000 compliant.
	- IP *filter* in that you can limit people to one link perl IP address.

What's new in version 3.0
	- Show / don't show the link confirmation page (only works when not confirming links)
	- Confirm links in admin before they are shown on the cougalinks page.
	- Ignore unusually long words in the site description.
	- Limit the amount of words entered in the site description.
	- New locking feature for platforms that support the flock() function.
	- Disallow words feature (Great for children link lists stopping swear words).
	- Help for each option now viewable in real time via the script.


Ok, you should of received the following files to get this script up and running :-

	1.	cougalinks.cgi
	2.	cl-admin.cgi
	3.	cl-data.ais
	4.	cl-disallow.dat
	5.	cl-pref.pref
	6.	readme.txt
	7.	cougalinks.gif

If you don't have all these please go back to
	- http://www.cougasoft.org/

README CONTENTS
---------------
	1.	Installation
		-------	Change perl location(s)
		-------	Upload + Chmod

        2.	Administration Overview
		------- Extra Options
		------- Update Links
		------- Preferences

        3.      Wish List
                ------- A few things I would like


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.
        If you immediately run into errors please make sure perl is up to date, I test
        all my scripts with perl5 which should be available on your server.

        ---- Please do this for cougalinks.cgi & cl-admin.cgi

  	If you don't know where it is you can either :-
		1. Type -[ which perl ]- on the telnet screen.
		2. E-mail administration 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.	cougalinks.cgi		/cgi-bin/		755
		2.	cl-admin.cgi		/cgi-bin/		755
		3.	cl-data.ais		/cgi-bin/data		666
		4.	cl-pref.pref		/cgi-bin/data		666
		5.	cl-disallow.dat		/cgi-bin/data		666
		6.	cougalinks.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 ;)

	When uploading graphics do not upload them into your cgi directory (unless you
	know they will work inside it) or any of its subdirectories because some cgi dirs
	treat files with any extension as CGI files.


	[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 ;)

#
# $--------------------------------------------------------------------------------------------
#
#  A  D  M  I  N  I  S  T  R  A  T  I  O  N,    U  P  D  A  T  E  -  L  I  N  K  S
#
# $--------------------------------------------------------------------------------------------
#

   	Use this to view or delete any of the links added to your database. I added this 
        option because I was getting too many duff + unwanted links.  Just check the checkbox
        next to the link(s) you would like to delete and press the delete button. Simple as :)
        You can also edit your links now like alter the category or edit their description.

   	I have fixed a major bug here, the script used to delete the link by line number, now
        it checks each link to delete and prevents you from accidentally deleting more than
        you wanted by pressing reload.

#
# $--------------------------------------------------------------------------------------------
#
#  A  D  M  I  N  I  S  T  R  A  T  I  O  N,    P  R  E  F  E  R  E  N  C  E  S
#
# $--------------------------------------------------------------------------------------------
#

	If you would like more information on each of the preferences, in the tables, each
	option which has help information also has a link.  I believe each option which
	warrants further information has been covered but if there is one missing please
	let me know.

#
# $--------------------------------------------------------------------------------------------
#
#  W  I  S  H  -  L  I  S  T
#
# $--------------------------------------------------------------------------------------------
#

        As I have a collection of CGI scripts with more in the works I am always looking
        for contributions so I put together my wish list.  If you can help me out with
        anything I would love to hear from you, I don't expect to get anything but as I
        said, its just a wish list :)

                Computers;
                As I program in a few languages I need to test my free programs on different
                Os's so I am looking for complete computer donations, esp. NT, LINUX and BSD
		and any other type of OS would be a big plus.

                Web Space;
                As some multi user versions of my scripts are nearing completion I will
                soon be requiring some free web space with the following: at least 50MB,
                telnet access, access to a C compiler (GCC Preferably), mySQL, perl5, *NIX
                OS, php and any other bells and whistles you care to mention :)

                Dedicated Internet Line;
                I think this one is a long shot but if there is anyone out there who could
                sort me out with a dedicated internet connection that would be excellent,
                after 3 years of programming CGI scripts on the internet my modem is just
                not doing the trick, recently I had been looking at getting a cable modem but
                after the initial tests my cable company decided to pull the plug on it.

        Other stuff I'm looking for;

                FILM: The black caldron, I have never seen this cartoon yet and also can't
                        seem to find it anywhere.
                Pool table
                Dart board - You have to take your aggression out somehow.
                Aston Martin Vantage - If you've never heard of this car, look it up!
                LANNGUAGES: Anything to do with learning new languages, dictionaries
                	audio cassettes, books anything at all...
                Anything to do with the Simpsons :)

#
# $--------------------------------------------------------------------------------------------
#  ===========================================================================================
# $--------------------------------------------------------------------------------------------
#
