[ Matt's Script Archive ] [ Readme's ] [ Random Link Generator ] Copyright and Header Overview rand_link.pl Necessary Variables $linkfile Options $uselog $logfile rand_link.html Copyright and Header ############################################################################## # Random Link Version 1.0 # # Copyright 1996 Matt Wright mattw@scriptarchive.com # # Created 7/15/95 Last Modified 7/30/95 # # Matt's Script Archive, Inc. http://www.scriptarchive.com/scripts/ # ############################################################################## # If you run into any problems while trying to configure this script, help # # is available. The steps you should take to get the fastest results, are: # # 1) Read this file thoroughly # # 2) Consult the Matt's Script Archive Frequently Asked Questions: # # http://www.scriptarchive.com/scripts/help/faq/ # # 3) If you are still having difficulty installing this script, send # # e-mail to: scripts-help@tahoenet.com # # Include any error messages you are receiving and as much detail # # as you can so we can spot your problem. Also include the variable# # configuration block that is located at the top of the script. # # # # Hopefully we will be able to help you solve your problems. Thank you. # ############################################################################## # COPYRIGHT NOTICE # # Copyright 1996 Matthew M. Wright All Rights Reserved. # # # # Random Link may be used and modified free of charge by anyone so long as # # this copyright notice and the comments above remain intact. By using this # # code you agree to indemnify Matthew M. Wright from any liability that # # might arise from it's use. # # # # Selling the code for this program without prior written consent is # # expressly forbidden. In other words, please ask first before you try and # # make money off of my program. # # # # Obtain permission before redistributing this software over the Internet or # # in any other medium. In all cases copyright and header must remain intact.# ############################################################################## Overview This Random Link Script was originally written to be part of my Free For All Links Script, but I thought that I could also break it down and send it out as a small script for those people wanting to run their own Random Link Page. It should be relatively easy to set up. There are three files included in this package. They are: README - This file. rand_link.pl - The Perl File that calls the Random Link. rand_link.html - An Example HTML of how to call the script. rand_log - A blank log file. rand_link.pl This is one of the more simple scripts that I have written and it only has one variable that you must set up and another if you choose to use the logging option. This file must be placed in the cgi-bin of your server and chmoded to 755, so that it is readable and executable by all users. There is one variable in here, described below: Necessary Variables $linkfile = ""; This is the database of links. Links must be placed in this database, without any markup, one per line. Options $uselog = ""; This determines whether you want to use the log or not. If you do you will simply get a log of the Remote Host and the time they took the random link. If you set this to '1' it turns logging on, otherwise it is off by default. If you do turn this option on you must also fill in $logfile below. $logfile = ""; This is the actual file system location of your log file. It must be chmoded read/write (666) for everyone and placed in a directory with like permissions. rand_link.html This is just an example of a random link html file. You can do whatever you want with it, hack it up, remove it, etc. It simply shows how you can call the script. The whole file really wasn't even necessary for me to place in this package. I could have just explained all you now need to do is point your html browser to the rand_link.pl file. So I could let users take a random link simply by having the line in my html file: <a href="http://scriptarchive.com/cgi-bin/rand_link.pl">Take a random link!</a> Its as simple as that. [ Matt's Script Archive, Inc. ] [ Advertising ] [ The CGI Resource Index ] Matt Wright - mattw@scriptarchive.com © 1995 - 1997 Matt's Script Archive, Inc.