calling findinsite-js

GREAT! You are now ready to link to findinsite-js from your web site.

Search page link

Your first option is simply to provide a link direct to findinsite-js. It is probably best not to use an absolute URL.
As described in the findinsite-js Installation Guide, the actual URL you must use to display the findinsite-js search page will vary. Here are a couple of possible URLs:

/findinsitejs/search

/servlets/findinsitejs

When you provide this link, you might call it Advanced search.

Search box

It is straightforward to add a search box to a web page... but see the charsets information below. In most cases, the following HTML will work:

<FORM METHOD=get ACTION="/findinsitejs/search">
Search for: <INPUT NAME="Text" TYPE="text" SIZE=20 MAXLENGTH=80>
<INPUT TYPE="SUBMIT" VALUE="Search">
</FORM>

You might need to change the URL used for the FORM ACTION attribute value.
If you want your search box to take up a small amount of space, try this HTML:

<FORM METHOD=get ACTION="/findinsitejs/search" STYLE="display:inline;">
<INPUT NAME="Text" TYPE="text" SIZE=15 MAXLENGTH=80>
<INPUT TYPE="SUBMIT" VALUE="Go">
</FORM>

Search box Character Set

If you use a search box, then you need to think about the character set (charset) of the page the box is in. If the page is in character set "ISO-8859-1" then the above forms will be OK.

However if the page is in a different charset, then the browser will return any characters using that charset. Unless you tell findinsite-js otherwise, findinsite-js will interpret these characters as "ISO-8859-1" and therefore might search for the wrong text. To fix this, tell findinsite-js the charset of the page using the cs runtime parameter. For example, if the page is in the Japanese "shift_jis" charset, then set cs by adding this code into your form:

<INPUT NAME=cs TYPE=hidden value="shift_jis">

The findinsite-js localised search pages always use the "UTF-8" charset which is able to represent all possible characters, while being recognised by virtually all recent browsers.

Subset searches

If findinsite-js is searching more than one search database, you can provide the user with a check box list of available subsets. See the Subsets page for details of how to set this up.