Nite


1 Product Information

Nite is a revolutionary product that we have developed which we believe is the first of its kind in the world. Nite is short for Navigation Favorites. Nite functions as your site's "Favorites" menu. It is activated the instance a visitor enters your homepage and as he browses your website and comes across a page to his liking, he can simply bookmark and organize it in Nite. Nite closes automatically when he exits your site (checked by domain name) and is reactivated the next time he visits your site when he can then simply zoom in to his favorite links (which are stored by Nite in cookies on the client's computer).

Nite makes surfing your website a pleasure for visitors by helping them target their favourite pages on your site easily and without having to navigate through a labyrinth of links. Nite truly increases the level of personalization and professionalism of your site to impress and encourage visitors to return again and again.

Nite is available in 2 versions: the freeware version and the registered version. The freeware version, which contains a link to our home page, is intended for non-commercial use by personal home pages. The registered version, in which the link is removed, may be purchased using the online order form. Additional information as well as the latest version of the software can be found at NavSurf.com.


2 Installing Nite on your web site

First, a brief description of how Nite works. Embedded in your home page is the button for launching Nite. Once clicked, the javascript function openNite() in your homepage is executed. This opens a new browser window and loads nite.html into it. The page nite.html contains the code to activate the Nite applet and also some javascript codes.

If you are new to Java applets, you would find it useful to follow the step-by-step installation instructions below:

1. Copy the necessary files to a subdirectory
2. Copy and paste the HTML code into your home page
3. Edit the applet parameters (if necessary)
4. Edit the icon graphics (if you wish)

2.1 Copy the necessary files to a subdirectory

For this step, we recommend that you create a subdirectory called "Niteapp" on your server. You would then need to copy the following files into this subdirectory:
a. nclass.zip
b. nite.html
c. The icon files : folderop.gif, foldercl.gif and page.gif

Note: nclass.zip contains the class files to run the Nite applet. There is no need to unzip this file, but if you do, please remember to keep the class files in the Niteapp subdirectory.

2.2 Copy and paste the HTML code

Next you need to paste some html code into your home page (or any page you want to use to activate Nite). The code serves two functions: (1) creates a javascript function which will be used to activate Nite and (2) inserts a button on your home page which when clicked will execute the above function

First, insert the following code somewhere in between the <body>…</body> tags of your home page. Please note the line in bold as you may need to change it to reflect your own relative url.

<script language="Javascript">
function openNite() {
  var isNS6 = (document.getElementById&&!document.all) ? 1 : 0;
  if (isNS6 == 1) {
    var jav_var;
    jav_var = (new java.lang.Boolean(true)).booleanValue() ;
  }
  this.name = "nite_parent";
  nite_window = null;
  nite_window=open('Niteapp/nite.html','nite','toolbar=no,status=no,width=210,height=390');
}
</script>

The above is the definition for openNite() which is a javascript function to load the file "Niteapp/nite.html" in a new browser window 210 pixels wide and 390 pixels tall.

Next, you need to embed the button in your home page which, when clicked will call openNite() to activate Nite. Find a suitable place on your page (between the <body>…</body> tags) and insert the following code:

<form>
<input type="button" value="Launch Nite" onclick="openNite()">
</form>

If you are familiar with html and javascript, you can experiment with different ways of activating Nite, such as replacing the button with an image.

2.3 Edit the applet parameters

By this stage, Nite should be up and running. You do not need to edit any applet parameters unless you want to store nite.html and nclass.zip in separate directories, and/or you wish to alter the physical dimensions of the applet. If so, use a text editor to edit nite.html which looks something like:

<html>
<head>
<title>Your Favorite Links</title>
</head>

<body topmargin="0" leftmargin="0" marginwidth="0" marginheight="0">
<script language="Javascript">
…..
</script>
<applet id="navfav" name="navfav" archive="nclass.zip" code="navfav.class" width="210" height="390" MAYSCRIPT>
</applet>
</body>
</html>

You need not be concerned with what is between the <script>..</script> tags. But please take note of the following values within the <applet> tag:

archive="nclass.zip" tells the browser to look for the applet class files in this archive. If you have stored this in a different directory from nite.html, you can specify the full path by archive="http://yourserver.com/dir/nclass.zip". If you decide to extract the class files and use them instead of the archive, then you may omit the archive parameter from the <applet> tag.

code="navfav.class" tells the browser to load this class file from the archive first. If you are not working with the archive AND you have stored the class files in a different directory from nite.html, you may specify the full path of the class file by code="http://yourserver.com/dir/navfav.class".

width="210" height="390" are the dimensions of the visible applet. Usually these values are set equal to the dimensions of the window containing the applet (see 2.2) so that the applet fills up the window completely. If, however, you wish to put some banners in the window, you may specify a smaller applet.

2.4 Edit the icon graphics

The following three files are used as icons in the menu. You may replace them with your own gifs. The dimensions of the graphics are 20 pixels by 20 pixels. They must be placed in the same directory as nclass.zip (or the extracted class files).

folderop.gif : Open folder icon
foldercl.gif : Closed folder icon
page.gif : Hyperlink icon


3 Frequent Issues

3.1 Removing the link to NavSurf.com

The link is absent in the registered version of Nite that can be purchased at NavSurf.com. Removing the link by any other means constitutes a copyright infringement and is illegal.

3.2 Opening Nite at a specific position on the screen

This can be done by appending the screen position parameters to the following line in openNite() (see 2.2):

nite_window=open('Niteapp/nite.html','nite','toolbar=no,status=no,width=200,height=390,screenX=400,screenY=400,top=400,left=400');

Note that there are two sets of parameters: (screenX, screenY) and (top, left). The former works for Netscape and the latter for IE. Include both to ensure maximum compatibility.

3.3 Speed up Nite loading

The loading speed of Nite in IE may be improved by zipping up the image files (foldercl.gif, folderop.gif and page.gif) together with the class files in nclass.zip. As Netscape cannot detect gif files in archives, you would still need to keep individual copies of the gif files in the Niteapp directory.


4 Technical Support

The answers to most user enquiries can be found in this documentation. Additional information, tips and articles can be found at NavSurf.com. If you experience problems configuring Nite, you could send us an email describing the problem, together with the URL of the web page or an attachment of the necessary files. All the files should be placed in a zip file to facilitate easy retrieval.

Feedback and suggestions are most welcome. Users are encouraged to give comments to help us to improve on the product and documentation.


5 Order Information

The terms and condition of the purchase as well as its procedure can be found at the order page of NavSurf.com. Besides online credit card payment, other forms of payment such as checks and postal orders are accepted. More information can be obtained by clicking on the product you wish to purchase at the order page. The payment link will load in a new window. If you do not wish to pay by credit card online, other payment options are available at the top section of the page.


6 License Agreement

All copyrights to the software are exclusively owned by NavSurf. You may not use, copy, emulate, clone, sell, modify, distribute, decompile, disassemble, reverse engineer or transfer the software, or any portion of it, except as provided for in this agreement. Any unauthorized use of the software will result in criminal and civil prosecution. All rights not expressly granted in this license are reserved by the author. The unregistered version of the software may be freely distributed provided that the distribution package is not modified in any way.

The copyright owner and author of the software disclaim all warranties either expressed or implied, including, but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to the software or documentation. In no event will the author or copyright owner be liable for any damages whatsoever (including without limitation to damages for loss of business profits, business interruption, loss of business information and the like) arising out of the use or the inability to use this product.

Installing and using this software signifies acceptance of these terms and conditions. If you do not agree with the terms of this license, you must cease to use the product and remove the files immediately.

Back to Nite

How to Add Java Applets to Your Site

New on the Java Boutique:

New Review:

Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling API boasts simplicity, ease-of-integration, a well-rounded feature set, and it's free!

New Applet:

Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA sequences into three useful formats.

Elsewhere on internet.com:

WebDeveloper Java
Lots of Java information on webdeveloper.com

WDVL Java
Thorough Java resource at the Web Developer's Virtual Library.

ScriptSearch Java
Hundreds of free Java code files to download.

jGuru: Your View of the Java Universe
Customizable portal with online training, FAQs, regular news updates, and tutorials.