ClientSearch - Installation Instructions

ClientSearch.java

A Search Engine For Sites That Cannot Host CGI Scripts

Instalation Instructions

First read and understand How the applet works. This is often veryhelpful in configuring the applet in your site.

When you unzip ClientSearch20.zip or ClientSearch20.tar.gz, the files are extracted into a directory called 'ClientSearch'.
Under the ClientSearch directory you will find a file named 'README', a file named 'ClientSearch.zip', a subdirectory called 'doc' (which has a copy of the documentation in HTML) and a subdirectory called 'src' (which has a copy of the source code.
Unzip ClientSearch.zip. This will give you a bunch of .class files.
Copy all the '.class' files and the ClientSearch.zip file into the top-most level of your HTML tree.
ClientSearch.html is the template file. This is the file that invokes the ClientSearch applet. You have to edit the portions between (and including) <APPLET> and </APPLET>. It is suggested that you copy this portion out of ClientSearch.html into the HTML file where you want the search button to appear.
Edit the <APPLET> section.
The changes you would make would be in the VALUE section of the <PARAM> tags. For example, you would change
<PARAM NAME="totalPages" VALUE="30"> to
<PARAM NAME="totalpages" VALUE="40">
Each <PARAM> tag has a NAME and a VALUE. ClientSearch recogonizes the following NAMEs in the <PARAM> tags. Important <PARAM>s are marked in blue-
- NAME="wid" - The VALUE corresponding to this NAME should be an integer. This would be the width (in pixels) of the search window that pops up when the 'Open Search Engine' button is clicked. Default is 450.
- NAME="heig" - The VALUE corresponding to this NAME should be an integer. This would be the height (in pixels) of the search window that pops up when the 'Open Search Engine' button is clicked. Default is 450.
- NAME="font" - The font of the text in the search engine. It is suggested that you leave the VALUE of this as 'TimesRoman'. Default is 'TimesRoman'.
- NAME="fontsize" - The size of the text (in points) in the search engine. It is suggested that you leave the VALUE of this as '14'. Default is 10.
- NAME="bgcolor" - The background color (in RGB code) of the search window that pops up. The VALUE can be any RGB value seperated by commas. Default is 255,255,255 - White.
- NAME="fgcolor" - The foreground color of the search window that pops up. The VALUE can be any RGB value seperated by commas. Default is 0,0,0 - Black.
- NAME="totalPages" - The maximum number of pages that the search engine should search. The VALUE of this would be an integer. For example you can use the applet to search upto 40 pages by having the following tag -
  <PARAM NAME="totalPages" VALUE="40">
  Default is 30.
- NAME="isLocal" - If you are using the applet to search local files (as in a CD-ROM), then include a VALUE of "true". If you are using the applet to search pages in a web server, then delete this entire line.
- NAME="topPage" - The page at which the web-spider should start crawling. The VALUE of this should be the name of an HTML file. For example -
  <PARAM NAME="topPage" VALUE="index.html">
- NAME="server" - The URL of the site which the search engine should search. The VALUE of this should be a valid URL. For example -
  <PARAM NAME="server" VALUE="http://www.aunet.org/">
  If you specify <PARAM NAME="isLocal" VALUE="true"> the following
  <PARAM NAME="topPage" VALUE="index.html"> <PARAM NAME="server" VALUE="http://www.aunet.org/">
  then the applet would start its search with 'http://www.aunet.org/index.html'
  Be aware that that the applet only searches pages that are relative links from this page. So, the applet will search a page -
  <A HREF="foo/bar/blat.html">
  but not -
  <A HREF="http://www.myServer.com/foo/bar/blat.html">
If you have trouble understanding the above parameters, then visit one of the sites using ClientSearch and use your browser's 'View Source' function to see how people have specified their parameters.
If you are still having problems, you could try emailing me. Please try to provide a URL where I could take a look at your efforts. Please try a few times before writing to me. Usually, tweaking is much fun and very educational.

Maintained by Sudhakar "Thaths" Chandrasekharan