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.
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
- *.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
- *.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
- *.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.
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.