Netscape Compass Server Administrator's Guide

[Contents] [Previous] [Next] [Index]

Chapter 6
Customizing the User Interface

The end-user search interface for Netscape Compass Server is created with templates, giving you a great deal of control over the presentation of the search page and the results page.

The following tasks are available for configuring the user interface:

To customize the templates or create entirely new user interfaces, you need to do some programming, as described in the Netscape Compass Server Programmer's Guide.

Setting Search Preferences

The Search Preferences form allows you to configure a number of aspects of the end-user search screen.

The end-user configuration options are:

To set search preferences, do the following:

  1. Check, uncheck, or select the options you want to change.

  2. Click OK to commit the changes.
If you change the Template option, you will also need to restart the server.

Enabling End-User Access

Enabling end-user access allows end users to access and search the Compass Server normally. When you disable end-user access, you can keep the server running, but instead of the search screen, users get a message indicating that the server is not available.

The primary reason you would disable end-user access is to use the Compass Server as a robot-only server in a distributed indexing environment. In such a setup, you deploy one or more robot-only servers to generate resource descriptions, then import those resource descriptions into a central Compass Server that end-users search. This can distribute the network traffic and processor loads more efficiently than running both the end-user search and the robot on the same system.

The contents of the "server not available" message come from a standard HTML page called the "No Login" file. The location of the file is listed below the checkbox that enables end-user search access. You can customize the message by editing the indicated file. You cannot change the name of the file, but you can change its contents with any HTML editor.

When you disable end-user access, the Compass Server copies the No Login file into the server's document directory. When you enable access again, the server deletes the copy of the No Login file from the document directory, leaving the master copy available for future use.

Setting Search/Browse Preferences

Netscape Compass Server comes with several standard sets of user interface templates. By default, it uses a search-and-browse set.

To choose a different search/browse template, do the following:

  1. Choose a template from the pop-up menu.

  2. Click OK.

  3. Stop and start the server.
You can choose from the following standard sets of templates:

Template Description
Search Only (default)

Uses the simple search interface as the default, providing a link to the Advanced Search screen.

Search Only (advanced)

Uses the Advanced Search interface as the default, providing a link to the simple search screen.

Search and Browse

Provides both simple searching and category browsing.

Search and Browse (advanced)

Provides for Advanced Search with category browsing enabled.

Example: Simple Search Only

A very simple template with only simple searching enabled. Uses no JavaScript.

If your Compass Server does not have a set of categories defined (as described in Setting Up Categories), or if you don't want users accessing categories for any reason, you can choose one of the search-only templates.

Choosing a search-only template removes all reference to categories and subcategories from the search screen, including disabling the Browse Categories button.

You can also create your own search and browse templates or modify the ones provided with the server. This process is described in the Netscape Compass Server Programmer's Guide.

Generating Search Statistics

The Compass Server tracks the searches users make, and can generate a sorted list indicating the kinds of searches that are being performed. You can generate this report both to track the search patterns of your users and to provide feedback to server users.

The server maintains only the most recently generated report, so you should periodically run the statistics report to update the results.

To generate search statistics, do the following:

  1. Check Exclude My Compass Queries if you want to exclude queries made by the My Compass profiler when it creates its newsletters.

  2. Click Generate Report.

Providing Information About the Server

It is helpful for a search service such as the Compass Server to provide some information about the contents of its database, so that users can set their expectations about what they can search for and the kind of results to expect.

In its default configuration, the Compass Server provides an About Compass button across the bottom of each user screen, which links to a standard "about" screen.

The contents of the about screen for the Compass Server are controlled by the HTML file called about.html in the server's document directory. You can edit the file with any standard HTML editor.

The default about.html contains an "About Compass" heading, followed by links to one or both of the following reports, if they exist:

If either of the reports has not been generated, the link to it will not appear. If you provide that information to users, you should keep the reports up-to-date, for instance by running the database analysis report after each robot run.

The default about screen also contains a link to authoring guidelines that tell document authors how the Compass Server indexes their documents.

Customizing Your About Screen

You should customize the text on the about screen to indicate in general terms what is in the system. For example, you might include some of the following:

You can incorporate this information in the about.html file in your server's document directory. The server includes all the text of file, and uses special comment lines to indicate where to include the query and site reports, if at all.


[Contents] [Previous] [Next] [Index]

Last Updated: 02/12/98 13:34:30


Copyright © 1997 Netscape Communications Corporation

Any sample code included above is provided for your use on an "AS IS" basis, under the Netscape License Agreement - Terms of Use