Normal Installation Instructions:
In most cases, the script will be auto configured when you first open csSearchPro.cgi in your browser. Change the $username and $password variables to your liking and click 'Save'. If the setup portion of the script cannot find your site variables automatically, you will have to enter those in the text area. If you click 'save' and you come back to the setup page, then your server doesn't have write access to your directories. You can solve this problem by chmod'ing the csSearchPro directory to 777.

WinNT installations:
The script has been tested and works on an NT IIS webserver. You will, however, have to manually enter the cgipath and rootpath variables. For example, your rootpath might look something like 'c:/inetpub/wwwroot' (Note: the back-slashes '\' normally associated with Window's file paths has been changed to a forward-slash '/')

CGI-BIN Installation Instructions:
The preferred method is to install csSearchPro in a directory outside your cgi-bin directory as described above, however, if your hosting service will not let you run scripts outside your cgi-bin directory, then follow these procedures:

Copy all the *.cgi files to a directory in your cgi-bin directory, making sure they are chmod'd to 755. For example, you could create a /cgi-bin/csSearchPro/ directory and place csSearchPro.cgi, libs.cgi, and setup.cgi (if this file exists) in this direcory.

Manually configure setup.cgi to the following:
$cgiurl = URL to the csSearchPro directory INSIDE your cgi-bin directory (where the script is installed).
$cgipath = FULL PATH to the csSearchPro directory INSIDE your cgi-bin directory (where the script is installed).
ADD THE FOLLOWING VARIABLES TO THE ABOVE CONFIGURATION OR MANUALLY EDIT setup.cgi:
$htmlurl =  FULL URL to the csSearchPro directory OUTSIDE your cgi-bin directory (where the remaining files where installed)
$htmlpath = FULL PATH to the csSearchPro directory OUTSIDE your cgi-bin directory (where the remaining files where installed)
For Example, your new setup.cgi file might look something like this:
$cgiurl='http://www.cgiscript.net/cgi-bin/csSearchPro';
$cgipath='/www/vhosts/cgiscript.net/cgi-bin/csSearchPro';
$htmlurl='http://www.cgiscript.net/cgi-script/csSearchPro';
$htmlpath='/www/vhosts/cgiscript.net/cgi-script/csSearchPro';
$rootpath='/www/vhosts/cgiscript.net';
$rooturl='http://www.cgiscript.net';
$username='myusername';
$password=',mypassword';
1;

Instructions:
Once the script has been setup, you need to go in and configure the searching parameters. To get to the login screen, open csSearchPro.cgi in browser with ?command=manage at the end of the URL. Example:
http://www.yoursite.com/cgi-script/csSearchPro/csSearchPro.cgi?command=manage
enter the login and password you configured the script with to enter.

This will bring up a screen that has your site's directory contents. To skip or ignore certain files or directories, click the appropriate button next to the listing. To skip or ignore multiple files or directories, check the box next to the name and click the appropriate button at the bottom of the management page. To un-skip or un-ignore files or directories, repeat the procedure when you originally skipped or ignored the files. This will act as a toggle for skipping and ignoring.

'Skip' will only 'skip' this instance of file or directory in a search.
'Ignore' will 'ignore' all instances of that file or directory name. For example, if you are ignoring a directory named 'images'.. all directories on the server named 'images' will be ignored in searching.

Click the 'Advanced Settings' button to enter the advanced settings section. Read the options on this page carefully. Instructions are next to each item.

A word about 'use index':
Indexing will greatly improve the speed and efficiency of your searches. If you select this item, you must click the 'reindex now' button to create the index. Also, if you have made any chances in the search options such as excluding <title> tags or parsing for server side includes, you must save these changes and then go back and reindex to have the changes take affect. Also, if you make any significant changes on your website, you will want to go back into the advanced settings area and reindex the site to reflect the changes as far as a search is concerned.

Adding a search form to your page (or anyone else's website):
There are 2 ways to place the search form on your web page. On the management screen in the advanced section, you will see text areas that contain links to the search form. You will also see 3 different search form styles you can select from. Select any of these styles by clicking the appropriate radio button (don't forget to save your changes). Then copy/paste the Javascript code where you want the form to appear on your page. This technique uses javascript. If you want to use SSI (server side includes), take the direct URL to csSearchPro and remove your domain. Enter this code on your page: <!--#include virtual="/cgi-script/csSearchPro/csSearchPro.cgi--> . Make sure the path to your installation of csSearchPro is correct. The javascript technique would be the preferred technique since you don't have to have server side includes to be running on your server. Also, you can call the javascript code from any page or domain. You can offer clients or affiliates the ability to put a search field on their web page to search your site.

Have Fun!

If you have any comments, questions, concerns or new script ideas go to http://WWW.CGISCRIPT.NET and submit Contact Form. Installation is available. This is only one of many cool scripts we have, check out http://WWW.CGISCRIPT.NET