csSearch

Copyright 1999-2001 WWW.CGISCRIPT.NET, LLC - All Rights Reserved

THIS COPYRIGHT INFORMATION MUST REMAIN INTACT AND MAY NOT BE MODIFIED IN ANY WAY

When you downloaded this script you agreed to accept the terms? of this Agreement. This Agreement is a legal contract, which? specifies the terms of the license and warranty limitation between? you and WWW.CGISCRIPT.NET, LLC. You should carefully read the following? terms and conditions before installing or using this software.? Unless you have a different license agreement obtained from WWW.CGISCRIPT.NET, LLC, installation or use of this software indicates your acceptance of the license and warranty limitation terms contained in this Agreement. If you do not agree to the terms of this Agreement, promptly delete and destroy all copies of the Software.

Versions of the Software
Only one copy of the registered version of csSearch may used per domain. Multiple domain pricing is available, see the web site for details.
?
License to Redistribute
Distributing the software and/or documentation with other products (commercial or otherwise) or by other than electronic means without? WWW.CGISCRIPT.NET, LLC's prior written permission is forbidden. All rights to the WWW.CGISCRIPT.NET, LLC software and documentation not expressly granted under this Agreement are reserved to WWW.CGISCRIPT.NET, LLC.

Disclaimer of Warranty
THIS SOFTWARE AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH WWW.CGISCRIPT.NET, LLC MAY BE USED, NO WARRANTY?
OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER MUST ASSUME THE ENTIRE RISK OF USING THIS PROGRAM. ANY LIABILITY OF WWW.CGISCRIPT.NET, LLC WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE. IN NO CASE SHALL WWW.CGISCRIPT.NET, LLC BE LIABLE FOR ANY INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOSS, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR THE INABILITY TO USE EQUIPMENT OR ACCESS DATA, WHETHER SUCH DAMAGES ARE BASED UPON A BREACH OF EXPRESS OR IMPLIED WARRANTIES, BREACH OF CONTRACT, NEGLIGENCE, STRICT TORT, OR ANY OTHER LEGAL THEORY. THIS IS TRUE EVEN IF WWW.CGISCRIPT.NET, LLC IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO CASE WILL WWW.CGISCRIPT.NET, LLC LIABILITY EXCEED THE AMOUNT OF THE LICENSE FEE ACTUALLY PAID BY LICENSEE TO WWW.CGISCRIPT.NET, LLC.

?
Credits:?
Andy Angrick - Programmer -
Mike Barone - Developer -
?
For information about this script or other scripts please visit:?
http://www.CGISCRIPT.NET
?
Thank you for trying out our script. If you have any suggestions or ideas for a new innovative script please direct them to Thanks.?
?
Installation:
Unzip the csSearch zip file on your computer. Open csSearch.cgi in any ascii text editor and verify the path to perl is correct on the first line of the script. If you are not sure what your path to perl is, then leave it alone.. chances are its okay. Transfer the files and directories to the root of your web site retaining the directory structure in the zip file. For example, you should have the following directory structure:

/cgi-script <-- cgiscript.net script directory
/cgi-script/csSearch <-- csSearch directory
/cgi-script/csSearch/images <-- image directory for script.

CHMOD csSearch.cgi to 755. When this is complete, open csSearch.cgi in your webbrowser. Example: http://www.yourdomain.com/cgi-script/csSearch/csSearch.cgi

If all goes well, this will automatically configure the script and show you a setup page and the remaining installation instructions.

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 csSearch directory to 777.?

Definitions in the setup.cgi file:

$cgiurl = Full URL to the csSearch directory
$cgipath = Full PATH to the
csSearch directory.
$rooturl = URL to your website
$rootpath = Full PATH to your document root
$username = username to enter management screens
$password = password to enter management screens

The $rootpath and $rooturl must point to the same directory on your server and is the point where the searching starts. For normal operations, this would be the root directory of your website.

Normal Installation Instructions:
In most cases, the script
will be auto configured when you first open csSearch.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 csSearch 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 csSearch 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/csSearch/ directory and place csSearch.cgi, libs.cgi, and setup.cgi (if this file exists) in this direcory.

Create a directory outside your cgi-bin directory and copy all the remaining files and subdirectories there. For example, you could create a /cgi-script/csSearch and place the files there.

Manually configure setup.cgi to the following:
$cgiurl = URL to the csSearch directory INSIDE your cgi-bin directory (where the script is installed).
$cgipath = FULL PATH to the csSearch 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 csSearch directory OUTSIDE your cgi-bin directory (where the remaining files where installed)
$htmlpath = FULL PATH to the csSearch 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/
csSearch';
$cgipath='/www/vhosts/cgiscript.net/cgi-bin/
csSearch';
$htmlurl='http://www.cgiscript.net/cgi-script/
csSearch';
$htmlpath='/www/vhosts/cgiscript.net/cgi-script/
csSearch';
$rootpath='/www/vhosts/cgiscript.net';
$rooturl='http://www.cgiscript.net';
$username='myusername';
$password=',mypassword';
1;

(note: the '1' at the end is to prevent errors from perl if $password was left empty)

Instructions:
Once the script has been setup, you need to go in and configure the searching parameters. To get to the login screen, open csSearch.cgi in browser with ?command=manage at the end of the URL. Example:
http://www.yoursite.com/cgi-script/csSearch/csSearch.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':
(ONLY AVAILABLE IN csSearchPro)
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 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.</font></p> <p><font face="Tahoma" size="2"><b>Adding a search form to your page (or anyone else's website):<br></b> 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 csSearch and remove your domain. Enter this code on your page: <!--#include virtual="/cgi-script/csSearch/csSearch.cgi--> . Make sure the path to your installation of csSearch 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.</font></p> <p><font face="Tahoma" size="2">Have Fun!</font></p> <p><font face="Tahoma" size="2">If you have any comments, questions, concerns or new script ideas go to <a href="http://www.cgiscript.net">http://WWW.CGISCRIPT.NET</a> and submit Contact Form. Installation is available. This is only one of many cool scripts we have, check out <a href="http://www.cgiscript.net">http://WWW.CGISCRIPT.NET</a></font></p> <font face="Tahoma" size="2"> <script language="javascript" src="http://www.cgiscript.net/cgi-script/CSIncludes2/js/script_news.suggest_script.js"></script></font> </body> </html>