CGI Scripts:: FAQ

UPOINT:: CGI Scripts: FAQ

Title: @1 Quote Publisher: Script installation
Steps of installing the script.

Installation:
The installation procedures described below are the default setup. You may rename the filenames or folders or even change the folders' location if you are sure what you are doing:

quote-admin.cgi and quote-show.cgi:
1) Change the first line (path to Perl) of the script.
2) Go to STEP 2 in the "quote-admin.cgi" script. Read the instruction there and modify the variables accordingly.
3) Create a folder "quote" (chmod to 777) under your root directory. Upload the script to this "quote" folder. Chmod the script to 755.
4) Open "quote-show.cgi" and set the variables. Upload the script to the "quote" folder.

* You may also rename the script or upload it to your cgi bin (in case your hosting ISP does not allow scripts to be run outside the cgi bin - remember to configure the script accordingly under STEP 2).

5) Upload "quotedata.txt" and "quotecounter.txt" to the "quote" folder and chmod both to 777. If you want to start from fresh without using the default 60 quotes, do not upload these two files as they will be automatically created when you add the first quote.

6) Open "quote-admin.htm" and "template.htm" and change the form action and images URLs. Upload to the "quote" folder. Be reminded that images SHOULD NOT be placed INSIDE the cgi bin.

- You may re-create your own admin template. Place +++ (three plus signs) at the location where you want the script results to be printed. See STEP 2 in the script for details.

Calling the events via an SSI tag:
This is how you call the events via SSI. Please note that "quote-show.cgi" in the SSI tag
must be changed to something like "../../quote-show.cgi", "../somefolder/quote-show.cgi", "quote/quote-show.cgi" ... or so on if it is not placed in the same folder as the script.



Use of limiters in SSI tags:
If you are displaying the quotes in multiple SHTML web pages and wish to display the quotes of a category, call the script via SSI using the following formats:

- To show all events under the category "Computer":
...quote-show.cgi?Cateogry=Work

- To show all events with the phrase "PC Fair" in the title:
...quote-show.cgi?Category=Lousy%20Jokes

Note: Replace space with %20