JAustIRC Applet Installation Instructions

 
There are two ways you can use the JAustIRC applet on your site.

  • You can upload the provided sample page and java file to your website, and use the chat immediately 'as is'; OR
  • You can include code in your existing page, configure the JAustIRC applet to match your site requirements, then upload the java file to the site, and chat.

The .jar file
A jar file is a java archive file, similar to a zip file. It contains all the classes needed for the applet to run on your website. It is very important that you put the jar file in the same directory as the webpage that contains the applet tags (discussed next). If you do not put these two files in the same directory, the applet will not load.

The jaustirc.html file
For those people who do not want to customise anything or are not familiar with html, you can use the provided jaustirc.html on your website to connect to AustNet. Make sure that when you upload the files (jaustirc.html and sjavairc.jar) to your webspace, you put them in the same directory. You will now be able to view the applet in your web browser. The unmodified jaustirc.html joins to #austnetwebsite as it's entry channel.

Using an existing/custom html file
You might already have a webpage created that you want to put the applet onto. If this is the case, you will need to insert the applet tags somewhere in your html code, between the <BODY> and </BODY> tags.
Copy and paste the following code:

<OBJECT
classid = "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
codebase = "http://java.sun.com/products/plugin/autodl/jinstall-1_4-windows-i586.cab#Version=1,4,0,0"
WIDTH = "600" HEIGHT = "400" NAME = "javaIRC" ALIGN = "middle" VSPACE = "0" HSPACE = "0" >
<PARAM NAME = CODE VALUE = "javaIRC.class" >
<PARAM NAME = CODEBASE VALUE = "." >
<PARAM NAME = ARCHIVE VALUE = "sjavaIRC.jar" >
<PARAM NAME = NAME VALUE = "javaIRC" >

<!-- INSERT YOUR CUSTOMISATION PARAMETERS HERE -->
<!-- For example, -->
<!-- <PARAM NAME = COLOURS VALUE = "" > -->


<!-- EMD OF CUSTOMISATION PARAMETERS-->

<PARAM NAME = "type" VALUE = "application/x-java-applet;version=1.4">
<PARAM NAME = "scriptable" VALUE = "false">

<COMMENT>
<EMBED
type = "application/x-java-applet;version=1.4"
CODE = "javaIRC.class"
JAVA_CODEBASE = "."
ARCHIVE = "sjavaIRC.jar"
NAME = "javaIRC"
WIDTH = "600"
HEIGHT = "400"
ALIGN = "middle"
VSPACE = "0"
HSPACE = "0"
scriptable = false
pluginspage = "http://java.sun.com/products/plugin/index.html#download">
<NOEMBED>

</NOEMBED>
</EMBED>
</COMMENT>
</OBJECT>

Note: You can change the height and width values in this tag.
This will display the applet if a user has a java enabled browser. If not, a brief message will be displayed showing the user where to download the latest version of the java machine. You can customise the applet by adding PARAM tags in between the <APPLET> and </APPLET> tags. More details can be found on the configuration page.

The main channel
You can set up the java IRC applet so that it joins a channel of your choosing automatically. The user will not be able to part this channel, and will stay there unless kicked/banned.

Specify the main channel parameter tag like this:
                  <PARAM NAME = MAIN VALUE = "#rahhh" >
Replace #rahhh with your channel name. This tag goes before the end </APPLET> tag.
Note: You cannot specify more than one channel name in the MAIN parameter tag.
If you don't specify a channel, JAustIRC will just join to AustNet, and wait for the user to type /join #channelname to join a channel.

Other customisation
For full customisation details, see the configuration page. You can specify such things as colours, user's full name and quit message.

Supported Commands
For full command set, please see the supported commands page or the readme.txt file.

More help
If you have any problems with the applet, or have a bug to report, email sophie@austnet.org with as much information about the problem as possible. Please note, that this is only for help with installing or using the applet, and not for help with any of AustNet’s services. You can also join #austnetwebsite on the AustNet IRC Network, and we will attempt to help you.