############################################################################### # Grizz's Free Links Script version 3.01F Modified 04/28/2004 # # This is a modified version of Cliff's Free Links Version 2.11 # # If you really need to remove the return links, go to # # http://www.rrudder.com/scripts/register.html # # Created 11/10/98 # # By using this script you agree to indemnify me from any liability # # that might arise from its use. In simple English, if this script somehow # # makes your computer run amuck, it's not my fault. # # Revision History # #04/28/2004 fixed bug in search script # #01/05/2004 added code to stop database corruption # #06/07/2000 Fixed Bad words code # #06/07/2000 Fixed corrupting of database # # 01/02/2000 Fixed Bug in Date for Y2K # # 06/23/99 Fixed bug in adding and removing sections # # 03/18/99 Fixed bug in badwords so it wouldn't pick up part of a word # # 03/18/99 Added code to check collected email addresses for doubles # # 03/18/99 Fixed bug for database getting corrupted by autosubmittals # # 03/06/99 Fixed Links Page to Refresh so new links will show up. # # 03/05/99 Fixed bug for search feature. # # 02/23/99 Fixed bug for html code after fixing email format. # # 02/19/99 Fixed bug for formatting the email and expiredemail files. # # 12/31/98 Added feature to change background color in tables # # 12/31/98 Reworked bademail addresses feature to make it work better # # 12/31/98 Added code to limit length of title & description to 60 Characters # # 12/31/98 Added code to block "|" Character to keep from corrupting database # # 12/31/98 Added code to keep autosubmittals from corrupting database # ############################################################################### Hello. These are the instructions for how to install the Free Links Script. You should have the following files... * links.cgi ---- the script that runs the links page * links.html --- the html file for the links page * admin.html -- the html file for administration of the links page * badurls.txt --- the file that holds the URLs you want blocked * bademail.txt --- The file that holds the email addresses you want blocked * lockout.txt -- the file that holds the bad words you want blocked * email.txt -- the file for the 'Thank You For Posting a Link' email you send to all visitors posting to your Grizz's FFA Links page. * readme.txt --- the file you're reading now If you're missing any of these files, you can download them from http://www.rrudder.com/scripts ****************************************************************************** * Installation ****************************************************************************** If you are upgrading from version 2.52 make sure you delete your setup.txt file. First of all, open links.cgi in a text editor. If perl is not located at /usr/local/bin/perl on your system, change the first line of it to #! and then the location of perl. If you don't know where perl is, ask your system administrator, or telnet in and type "whereis perl" at the command prompt. Scroll down to line 51. If you aren't planning on creating the data directory in the same directory as the script, change "data" to the server path (not the URL) to the the data directory. Do not include a trailing slash. Now scroll down to line 54. Enter the server path (not the URL) to links.html. Scroll down to line 57 and enter the full URL of links.html. Scroll down to line 60 and enter the URL of links.cgi. Scroll down to line 63, and enter the path to your mail program. This should actually be okay on most unix systems. If links.cgi cannot be found at /cgi-bin/links.cgi, open links.html in a text editor and replace the text /cgi-bin/links.cgi with the URL of links.cgi. Edit admin.html and replace http://www.yourdomain.com/cgi-bin/links.cgi with the URL of links.cgi BADURLS.TXT This file contains all bad, banned urls that are NOT allowed to post to your Grizz's FFA Links page. You can add any url here if you want. FTP this file to: Your data directory CHMOD to: 644 BADEMAIL.TXT This file contains all banned email addresses that are NOT allowed to post to your Grizz's FFA Links page. You can add any email address here that you want. If someone complains about getting email from your script, just add his email address here, and no ads are allowed to be posted using his address. This can also be done from the admin page. FTP this file to: Your data directory CHMOD to: 666 LOCKOUT.TXT This file contains all bad, banned words that are NOT allowed in any postings to your Grizz's FFA Links page. You can add any word here if you want. This can also be done from the admin page. FTP this file to: Your data directory CHMOD to: 644 COLLECT.TXT This file contains all email addresses you collect from visitors posting to your Grizz's FFA Links page. This file is only created if you want to collect email addresses. EMAIL.TXT This is the 'Thank You For Posting a Link' email you send to all visitors posting to your Grizz's FFA Links page. Edit this file as you want. FTP this file to: Your data directory CHMOD to: 644 Disable auto Links submittal The script is already configured to allow auto submittals. If you don't want to allow submittals to your page from auto submittal software you can go to line 155 and remove the # sign from that line and add it to the next line like this this is the original setup #if ($FORM{'action'} eq "add_link") { &add_link; } if (($FORM{'action'} eq "add_link") or ($FORM{'action'} eq "")) { &add_link; } Change to this to block auto submittals if ($FORM{'action'} eq "add_link") { &add_link; } #if (($FORM{'action'} eq "add_link") or ($FORM{'action'} eq "")) { &add_link; } Now upload all files (as ascii, not binary) and create directory named data. Set links.cgi's permissions to 755, links.html's permissions to 777, and the data directory's permissions to 773 (if this doesn't work on your system, try setting links.html's and the data directory's permissions to 777). Congratulations, you're done! You will need to go to the admin page now and play with the options. This needs to be done to make sure everything works Ok. To do so, go to the uploaded admin.html file. The password is "rrudder.com" (without quotes). Make sure you change this ASAP. Everything on the admin page is explained in plain English. ****************************************************************************** * Troubleshooting * If you're having problems with the script, please read the following before * asking me for help. ****************************************************************************** * Script returns 500 Internal Server Error * Make sure you've changed the first line of links.cgi to #! and then the path to perl on your system * Make sure you've uploaded links.cgi as ascii, not binary. * Make sure you've set the permissions for links.cgi to 755. * Password: rrudder.com does not work * Make sure you've entered it as all lower case * Make sure that you've either placed the data directory in the same directory as links.cgi, or entered the server path (not the URL) to the directory in links.cgi * Make sure that you've set the directory's permissions to 773, or if that doesn't work on your server, 777 * Links page is not updated * Make sure that you've entered the server path (not the URL) to the links page in links.cgi * Make sure that you've set links.html's permissions to 777 ****************************************************************************** If you have any questions, comments, suggestions, etc, email me at roy@rrudder.com