Java Applets   Register   Support   Java Help
  About us   Sitemap   Java Links   Extra - Free Java Applets to Improve your Website.
  Java problems     Installing     Customizing     Programming  
Applet of the month
Latest updates
Internal links
Contact us
Terms of use
Privacy policy :\ Help \ Installing_the_applet

Java(TM) is a programming language environment designed by Sun Microsystems. Applets are small programs, written in compiled Java code, that run inside a browser under security supervision. JavaScript is a script designed by Netscape and is not used inside Java applets.

Follow the following set of instructions to install an applet on your website.

1. Downloading the applet

You can download and use all our applets for free. Unregistered however, most of them will show a link back to us. Take a look in our archive to decide which applet(s) you want to use. Click on the download link and save them to your computer in a temporary directory (in Windows for example in C:\Temp\RealApplets\).

The file you downloaded is compressed in zip format to decrease download time. Create a working directory and make sure it is empty to avoid confusion with other files. With a tool to handle .zip files (cfr. links), you can extract the .zip archives into the working directory. You can now delete the original zip file you downloaded in the temporary directory, it is of no use any longer.

If you downloaded the zip file from another site than ours or the zip file is a little older, there might be a newer, improved version of the applet available for download on our site now!

2. Take a look at the applet and the documentation

Take a look at the list of the files in the working directory. There can be several types of files in it:

  • *.html or *.htm: webpages containing documentation and (an) example(s) of the applet.
  • *.class or *.jar: actual Java bytecode, needed by the webpages to show the applet.
  • *.java: java source code files, rarely included (not needed when running an applet in your browser).
  • *.gif, *.jpg or *.jpeg: image files used by the applet.
  • *.au: sound files used by the applet.
  • *.txt: (most likely) data files that can be customized by a defined structure in the documentation.
  • *.dat: compressed data files that need special editor programs to adjust.

Open index.html (if it isn't included, try AppletName.html, readme.html or some other .html file) to see the applet work offline. If the applet doesn't work offline, try downloading and extracting it again. Make sure you read the documentation on that webpage, so you understand what's possible with the applet and how to customize its parameters.

3. Customizing the webpage and the applet

Sometimes you won't want to customize anything, you'll just want to place a link to the applet page on your site.

Most of the time however you'll want to place the applet in another webpage than the one included. Open the applet webpage in a text editor (for example Notepad) and copy the complete APPLET tag: everything from <APPLET> until </APPLET>, including all (if any) parameters. Paste that in your webpage where you want the applet. You can add several attributes to the APPLET tag (don't delete any though), such as:

  • CODEBASE : this sets the codebase of the applet. The browser will get all the media, data, class and jar files from that directory.
  • ALIGN, ALT, HSPACE, NAME, VSPACE, ... (basic html attributes)

You can delete any other html files in the directory. If your new webpage is in a different working directory, copy all files from the old working directory in the new working directory.

A large part of our applets are highly customizable themselves too. That can include changing colors, fonts, size, language, ... Take a look at the customization chapter for more information. Afterwards there might be a few files in your working directory left that aren't used any longer by the applet, you can delete those.

4. Uploading

Before you start uploading it to your online website, make sure the applet works offline. If it doesn't work offline, it won't work online. Upload all the files from your working dir. If you have the ability to choose or set the transfer type, set it to "binary".

Once it is uploaded, take a look at the webpage online. If you have placed it over an older version, you might need to refresh or even wait a while to be able to view the newer version. This is because your ISP could have a proxy-server or the files are cached by your browser (in that case, clear your browser's cache and restart your browser).

If the applet does not work online (but it did work offline), the cause could be:

  • Not all the necessary files are uploaded. Upload the missing files.
  • There are file names with "$" and your server does not accept file names with "$". Try an updated version of the applet.
  • There was an error while uploading. Try uploading the entire directory again.

5. Bug report and support

If you think you have found a bug in an applet, download the latest version to make sure it isn't already solved. If it isn't, notify us by filling in the contact us form and we will try to solve the bug as soon as possible.

Customers can contact us with any problem in the support section or by sending an email to the programmer (privilege). If you're not a customer and you have read the entire help section and you still don't know how to solve the problem, contact us with the contact us form.