Link Directory installation documentation.

• Version
• Features
• System requirements
• Installation and configuration from the script
• Add categories and links
• Create the web pages
• Template programming
• 5 star rating
• Terms of Use
• Copyright information
• Warranty disclaimer

Open all the files with a .pl file extension in your favorite text editor and look for the line.

#!/usr/local/bin/perl

Make a directory in your cgi-bin directory something like link. Upload everything from the cgi-bin directory (from the zip file) in the same context to your cgi-bin/link directory. Upload everything in ASCII mode (be sure of that other why the script is not working)

Make a directory in your main directory something like docs. Upload everything from the docs directory (from the zip file) in the same context to your docs directory.

You can add categories and links in the administrator control panel, open the admin.pl (http://www.yourdomain.com/cgi-bin/link/admin/admin.pl) script in a browser. On the left side you see a menu where you can add the categories [Add Category] and links [Add Link], before you can add links, you need to create the categories before.

After you have create the categories and links you can build the pages in the administrator control panel by pushing the [Build All] link. All pages and directories are created automatically by the script.

The templates located in the 'admin/templates' directory can be edit to change the look from the site. Advanced template programing can be use to display different result, depending the value/condition.

Extra template are located in the 'extra/templates' directory.

<%if CATEGORY%>
<h2>Categories</h2>
<%CATEGORY%>
<%endif%>

In this case the variable 'CATEGORY' is displayed only when the variable 'CATEGORY' is set.

<%if Popular eq Yes%>
<sup class="popular">pop</sup>
<%endif%>

In this case the word 'pop' is displayed only when the variable 'Popular' is equal to 'Yes'.

<%if DAYS_OLD_NEW eq 1%>
new today

<%elsif DAYS_OLD_NEW < 8%>
new this week

<%elsif DAYS_OLD_NEW > 7%>
new older than 1 week
<%endif%>

When the variable 'DAYS_OLD_NEW' is equal to '6' the words 'new this week' is displayed.

<%if DAYS_OLD_NEW eq 1%>
new today

<%andif Popular eq Yes%>
and popular
<%endandif%>

<%elsif DAYS_OLD_NEW < 8%>
new this week

<%andif Popular eq Yes%>
and popular
<%endandif%>

<%elsif DAYS_OLD_NEW > 7%>
new older than 1 week

<%andif Popular eq Yes%>
and popular
<%endandif%>

<%endif%>

When the variable 'DAYS_OLD_NEW' is equal to '6' the words 'new this week' is displayed, if also the variable 'Popular' is equal to 'Yes' the words 'and popular' is also displayed.

This script have a 5 or 10 star rating display options, with this option you can display the rating in a graphic matter.

<img src="http://www.yourdomain.com/images/<%5STAR_RATING%>.gif" border="0" alt="">

<img src="http://www.yourdomain.com/images/<%10STAR_RATING%>.gif" border="0" alt="">

You need (for the use of the 5 star rating option) also to replace the rating form in the 'rate.html' template with the form below.

<form action="<%RATE_SCRIPT%>" method="post">
<input type="hidden" name="do" value="rate_link">
<input type="hidden" name="id" value="<%ID%>">
<input type="radio" name="rate" value="10"> Excellent!<br>
<input type="radio" name="rate" value="8"> Very Good<br>
<input type="radio" name="rate" value="6"> Good<br>

<input type="radio" name="rate" value="4"> Fair<br>
<input type="radio" name="rate" value="2"> Poor<br>
<input type="submit" value="Cast Vote!">
</form>

This script is being offered as shareware. It may be used and modified free of charge for personal and non-profit use under the following conditions:

1. All copyright notices in the script remain unmodified.
2. The 'Generated with Link v1.xx by Widexl.com' text is placed on the link pages.
3. The text 'Link v1.xx' is linked to: http://www.widexl.com/scripts/links/
4. The text 'Widexl.com' is linked to: http://www.widexl.com/

Commercial use must register the script for a fee of 89.95 USD. Scripts that has been registered do not have to display the links back to Widexl.

Selling the code for this program, or a program derived from Link, without prior written consent is expressly forbidden. Similarly, redistributing this program, or a program derived from Link, over the Internet, CD-Rom or any other medium is expressly forbidden without prior written consent. By using this program you agree to conditions above.

THIS PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY. WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.