Please Rate this Script @ The CGI Resource Index.  Really, it makes us feel good and then we think that maybe we are doing something useful.  It's a form of gratitude for giving away a script which we put a fair amount of time into developing.

License

SCRIPTS ARE PROVIDED WITHOUT WARRANTIES OF ANY
KIND, WHETHER EXPRESSED OR IMPLIED. THIS PROGRAM IS
PROVIDED WITHOUT WARRANTIES AS TO PERFORMANCE, OR 
MERCHANTABILITY OF THIS PROGRAM. 

SCRIPT MAY BE MODIFIED, BUT NOT REDISTRIBUTED IN 
ANY WAY, SHAPE, OR FORM. IN ANY CASE, COPYRIGHT AND
SCRIPT INFORMATION MUST BE KEPT IN PLACE

You must keep the "powered by" and script copyright
information in place. Make sure it is somewhere on 
the page(s) and is visible. You must register the script.
This script may. This script may not be redistributed in
any way, shape or form without permission from Castellum.net.
Selling this code in any way, shape or form is not permitted.
By downloading, installing or using this script you agree to 
indemnify the author, Castellum.net, Castle-CGI.com, and all 
other parties involved from any loss or damage incurred by 
this script no matter how it was caused. The script is provided
"AS IS". We make no guarantees about this script.  We do not 
guarantee technical support. We reserve the right terminate the
license to use the script for any reason or for no good reason 
at all. We reserve the right to change the TOS at any time 
without notice. We reserve all rights to the script.

No matter what, all copyright, contact, and terms of use 
information must stay in place. If you do not agree to the
above statements you do not have permission to use this script.

Installation

If you have trouble with the installation or just don't have the time, you might want to look at our free installation service.

1. You need to unpack the zip file into a directory.  Make sure you let it maintain the directory structure.  It will create a directory called "clinks" and its should leave you with files in the directory as well as three new sub-directories.
   

• clinks
  • admin.cgi
  • admin.html
  • admin_setup.pl
  • clinks_setup.pl
  • global.pl
  • install.cgi
  • readme.html (this file)
  • data
    • categories.dat
    • links.dat
    • addition_email.txt
  • templates
    • add.htm
    • category.htm
    • error.htm
    • category.htm
    • master.htm
    • thankyou.htm
    • search_results.htm
    • search.htm
  • templates/admin
    • _admin_main.htm
    • _admin_complete.htm
    • _admin_change_admin_info.htm
    • _admin_error.htm
    • _admin_backup.htm
    • _admin_mnulinkmanagement.htm
    • _admin_display_links.htm
    • _admin_edit_link.htm
    • _admin_mnucategory_management.htm
    • _admin_mnuemail_options.htm
    • _admin_edit_category.htm
    • _admin_mnucheckversion.htm
    • _admin_size_waring.htm
    • _admin_cleanup.htm
    • _admin_maintenance.htm
    • _admin_system_setup.htm
    • _admin_script_setup.htm
    • _admin_delete_category.htm
    • _admin_add_link.htm
    • _admin_editadd_email.htm
    • _admin_display_addresses.htm
    • _admin_send_email.htm
      

It may seem like a lot of files, but it really isn't.  You'll never have to ever touch most of them.

2. Now, open the file "install.cgi" in a text editor, use notepad if you have too.  Please don't use Word or another fancy editor, they have a habit of messing it up big time, unless you know how to save it correctly.  Change the first line of the file to reflect the location of your perl interpreter.  If you aren't sure, ask your host, they should know, and if they don't, you really don't want to be hosting with them anymore.  The default is "/usr/bin/perl".
3. Next, fire up your ftp program and log on.  Make sure you are uploading in "ASCII" mode, if you upload in Binary, nothing will work.  Go to your cgi-bin, or wherever you are going to put the script.  Now, select the "clinks" folder and upload it.  If prompted, say yes to uploading the entire directory structure.  This will ensure that all of the files are uploaded and that the directory layout is maintained.
4. Now that it is uploaded you have to consider some things.  Different servers have different permissions that are needed to run something.  Usually the default will work, but some are picky.  Ask your host what permissions you need to use for a cgi script, and what you need to use for data files (files that can be read and written too by a script), and what directories should be set too. Again, if they don't have a clue about what your saying, leave them because they are "stupid", for lack of a better word, and you don't want to be with them.  Generally, 755 will give you all the permissions that you need to execute a script.  So, chmod the "install.cgi" file to 755.  You can do this in most FTP programs (search their help for it), or you can use the Unix command in telnet (type 'man chmod' for more on that).  Now, you don't have to worry about setting the other scripts because they will be set by the install script.  But, you do have to set the directories and the data files, and the templates.  Really, the default should work, but if not try these.  755 for the directories, 755 for all the template files, and 644 for the data files (categories.dat, and links.dat).  If you aren't familiar with what permission settings should be used, ask your host, or use our free installation service.  If you ask your host, you can give them the directory layout above and step number 4.  They should be able to figure it out from there.
5. Now, open install.cgi in your browser.  It should bring up a install screen.  Follow the instructions and you should be alright from there on in.  If you have any questions, you can email us at: castlecgi@castellum.net .  We don't mind helping, we confuse ourselves sometimes :)

Other

Castle CGI: http://www.castle-cgi.com/
Castle Links: http://www.castle-cgi.com/scripts/CastleLinks/
Castellum.net: http://www.castellum.net
Email: castlecgi@castellum.net

Version History

• 4.0
  • Decided that the script was worth improving.  Why?  Because we have watched our rating at CGI Resources slowly go up and up.  It's fun to watch it, so, if you haven't already, make it go up some more: Rate this Script @ The CGI Resource Index
  • Complete rewrite of the main script.
  • Changed file layout and split up the clinks.cgi file into separate files.  This should help reduce server load and overhead.
  • Added sub-category support -- FINALLY!
  • Fixed all the nasty bugs in the admin script -- hopefully.
  • Removed the edit template feature, that was a hassle.
  • All main templates are now renamed - the old naming scheme looked ugly.
  • Added support for a master template (master.htm).  This allows you to use one file to determine the general layout and looks of the others.
• 3.05
  • Added the ability to order the links alphabetically.
  • Removed the Check Version feature.  It caused a lot of problems on servers without the correct module.
  • Removed the "Edit Template" for the _add_template.htm file.  This is temporary until we figure out how to solve the problem.
  • Recreated the backup menu routine.  Somehow this got removed so clicking backup would give you a Invalid Command error.
  • Changed link file structure.  Files must be converted from previous versions.
  • Refined some of the email functions.
• 3.03
  • Fixed a issue with Netscape.  Categories with spaces in them were getting mangled in the query string by Netscape.  The category names are now URL Encoded prior to being printed, so Netscape won't complain.
• 3.02
  • Fixed the routine ViewEditLink, which would cause a invalid link id error when you tried to edit a link.
• 3.01
  • Fixed "Script Setup" problem which caused the disabling of referrer checking to not stay checked.
  • Added a option for entering email addresses.  You can now have the script send a thank you email to the user and a email to you notifying you of the new link.
  • Added "Email Options" which allows you to send emails to link owners.  You can also find the addresses by searching, categories, or just display all.
  • Added a "Edit Template" option.  You can now edit the templates online instead of offline and then uploading them.

• 3.0
  • Complete rewrite, major improvements in all areas.
• 2.x
  • Nothing useful, 3.0 is a complete rewrite

©1999-2000 Castellum.net & Castle-CGI.com, All Rights Reserved