Read me file for the 100 Links Page # Might be easier if you print this # Copyright Information: This program was written by Ranson Johnson # Feel free to copy, change, reference, sample, or borrow, the contents. # The script is provided as is, there is no warranty expressed or implied. # If you would, email me and let me know you are using the script, so I can # show you on my list of links. # If you would like to support public domain freeware, contributions are # accepted. # Last but certainly not least, if you find a better way of doing something, # I would really like to know. Thanks and have fun. # Ranson scripts@rlaj.com http://www.rlaj.com/scripts #---------------------------- Features: There are many improvements (I hope) in the script than others I could find on the net. A built in page counter. A preview page so the user can check their entry and link before they submit, allowing them to go back and fix something they messed up. A 'black list' file that is checked to see if there is a URL there that you don't want on the page. Good for those who abuse your service, and put their link on 50 times. A file locking system so that it doesn't mess up when two people try to submit at the same time. The option of getting an email whenever someone makes an entry to your page. The option of sending an email to the person that just entered a link on your page. I find this very handy to get return links from their page. This is the email they get: Thank you for your entry to the 100 Links Page To: Who-Done-It http://www.some-site.com The information they entered. *----------------------------------------------* Please return the favor and add a link to my 100 Links Page from your pages. Copy the code below, and paste in an appropriate area of your page. --------------- Free for all 100 Links Page ___________________________________________________________________________ ___________________________________________________________________________ The files contained in this package are: add.htm Form for adding the new link to your page add.cgi Does all the real work 100links.cgi The opening page for the 100 links page (index.cgi) preview.cgi Allows the user to 'preview' their entry, and check the link top.htm The top portion of the opening page (don't ask yet) bottom.htm The bottom portion of the opening page blk_list.log Log those who abuse the service tmp_link.log This holds all your entries count.log The log file for the page counter 100-setup.pl All the configuration for athe program ------------------------------------- You will need to chmod all the CGI's to 755 You will need to chmod all the LOG's to 666 If you need an explanation of what chmod is go to: http://www.rlaj.com/scripts/faq ------------------------------------- To install the program, make a directory to hold the files. Copy all files to that directory. The program is set up to have all the files in one directory. (except for add.htm - can be anywhere you like) You may place the files anywhere on your server you like, you just have to make sure all the path statements are correct. The most common challenge in getting the program to work, is getting the path statements correct in the set-up. Also be very careful to leave any single quotes(') or double quotes(") and the semi-colon(;) that appears at the end of each line, just as they are, or you will get an error. CGI's must be up-loaded ASCII not binary. If it is up-loaded in binary mode it will not work! Once you have the program working, make spair copies of all the files and keep them in a safe place. * THINGS YOU WILL NEED TO CHANGE * top.htm: All the information that you want to tell the user before they read the links or add a link to your site. The body tag and background information, as well as any images you want on the page. After you unzip the file, look at the top.htm with your browser. Everything will work as is, I made it generic, but would be great if you customize for your site. I made the top.htm so it would be easier for a novice to edit without having to worry about messing up the cgi. bottom.htm: About the same as the top.htm except, you guessed it, it's the bottom of the page after the links. Using these two files there is no need to edit the HTML portion of the index.cgi. Configure the variables in the 100-setup.pl The 'remote_mail' option is really helpful if you want a lot of links to your page. The program sends an email to the user thanking them for using your page, and asks them to link back to you. The code for the link back is in the email. add.htm # Change this only if your 'preview.cgi' is in another directory.
Like if you are using a cgi-bin, it would be: action="cgi-bin/preview.cgi" Thats all the changes. Have Fun! For those who want to know how it works, here goes. The index.cgi(or opening_page.cgi) When the opening page is called(100links.cgi), the first thing it does is go and get the file 'top.htm', and prints that. Next we go and get the links from the 'tmp_link.log' and prints them. Then we count the hit, and print the new number to the 'pg_count.log'. Next we print the hit to the page. Finally we print the page bottom. I have seperated the Top of the page and the bottom of the page to make it easier for you to edit the HTML portion of this program. You can change the astetics of your page at any time without having to deal with the .cgi which can be tricky for someone who is not familier with cgi. A comma out of place in the cgi will shut the whole program down.