Any Question ?
Try our Forums !

Here is the J-Ads 2.1.3 Applet. A solution for web advertisements !
It's a "roller banner" based Applet. It allows to display many classic banners in the same 468x60 screen. J-Ads is easy to install on your web page. You just have to fill basic parameters for a simple use. Extra parameters like GIFcontrol or click reports are also available for advanced users.

Browser support : J-Ads 2 is best viewed with IE 4.x or Netscape 4.x (or higher) but it works under any Java™ capable browser (e.g: Netscape Gold), Mozilla, ...

What's NEW ? How to install J-Ads 2 ? How to setup PARAMETERS ?  F.A.Q

What 's NEW since 2.1.1 ?

  • HTML parameters can override file parameters through configsrc parameter.
  • firstad parameter added.
  • Multiple licenses support added.
  • Both file and HTML parameters support.
  • waitmode parameter added.
  • Bug fixes : Screen refresh while wait time. Java 1.1.2 support (for netscape 4.03 to netscape 4.05). Java 1.3.0 support (for netscape 6 preview). safe parameter added.
  • What 's NEW since 2.0 ?

  • Random features added !
  • Jpeg format supported.
  • Nice options added. See Note in image parameter and displaymode parameter.
  • Bug fixes : You can now display up to 256 banners (V2.0 was limited to 32). All URLs are supported in alink parameter (Links were dropped off after the "=" sign in V2.0 )
  • What 's NEW since 1.0 ?

  • Animated GIF supported !
  • Configuration file added.
  • Nice banners loading management (no need to wait last banner before starting J-Ads). While first banner is loading, J-Ads uses bgcolor parameter to display empty screen, then it displays the first banner. Others banners are loaded in a background process.
  • Hand cursor added for link.
  • Banners dimension constrains removed.
  • Server-side click reports added.
  • How to install J-Ads 2 ?

    Download the full demo package v2.1.3 here (81.4 KB - zip file) :
    (Old package v2.1.2 here ,81.0 KB - zip file)

    First you have to copy all class files in the directory of your web page. Then you have to fill the applet tag in the HTML source code and setup the configuration file. The J-Ads example above is the result of :

    HTML code :
    <APPLET CODE="jads2.class" CODEBASE="./" WIDTH="468" HEIGHT="60">
    config file : jads.ini

    # BackGround color during loading #
    bgcolor = FFFFFF

    # Banners Parameters #
    image_0 = computerbanner.jpeg
    alink_0 = http://www.javazoom.net

    image_1 = shiftboard.gif
    alink_1 = http://www.javazoom.net

    image_2 = cartoon.jpg
    alink_2 = http://www.javazoom.net

    image_3 = casino.gif
    alink_3 = http://www.javazoom.net

    image_4 = java468x60.gif
    alink_4 = http://www.javazoom.net

    image_5 = armoire.gif
    alink_5 = http://www.javazoom.net

    # Misc #
    wait = 2000
    randomlevel = firstone


    How to setup PARAMETERS ?

     Applet Parameters :

    You can choose the width and the height of J-Ads through the WIDTH and HEIGHT parameters.

    config parameter defines the name of J-Ads applet configuration file. Default is jads.ini. J-Ads parameters have been moved to this file to make configuration step more convenient for static web pages.

    <APPLET CODE="jads2.class" CODEBASE="./" WIDTH="468" HEIGHT="60">
    <PARAM NAME="config" VALUE="myconfigfile.ini">


    configsrc parameter allows to use <APPLET> parameters instead of ones from the jads.ini file. It's more convenient for dynamic (JSP, ASP, PHP) web pages. Enable it with: <PARAM NAME="configsrc" VALUE="html">
    You can also override parameters from jads.ini by HTML parameters. To do so use : <PARAM NAME="configsrc" VALUE="filefirst">

     Basic Parameters :

    You have to know that empty lines and lines starting with # (comments) are ignored.

    You can choose the background color of the applet when the first banner is loading through bgcolor parameter. Default is white. This parameter is useful when your first banner is an heavy GIF.

    You must have TWO or more banners (GIF or JPEG format) to fill image_0, image_1, ... parameters. Note that JPEG files shoud have .jpg or .jpeg as extension. Animated GIF are supported !.
    Note : If you want to remove one or more banner from the jads.ini you don't need to rename all image_i parameters. Just comment out the parameter.

    Links matching to banner should be filled through alink_0, alink_1, ... parameters. They are displayed in the Status Bar when active. During transitions links are not active.

    wait parameter defines sleep time (in milliseconds) for static banners (default is 3000). You can mix animated GIF with static GIFor JPEG. Animated one will follow their own sleep time values (use any GIF constructor tool - as Microsoft GIF Animator- to change them) whereas Static one will use the wait parameter.

     Extra Parameters (for advanced users) :

    Extra parameters allows an user to choose his own transistions, target frames and refresh rate. GIF iteration can also be controled.

    You can choose the target frame of any link through frame_0, frame_1, ... parameters. frame_x should be :

  • "name of the frame" : To load the link into the FRAME named in the HTML code.
  • "_blank" : To load the link in a new blank unnamed browser window.
  • "_self" : To load the link into the same window the applet occupies.
  • "_parent" : To load the link into the immediate FRAMESET parent.
  • "_top" : To load the link into the top body of the window.
  • You can force your own transition by filling all the following three parameters :

    grid : NbLinesxNbCols defined in banners.

    transition : Transition between features of the grid. You can choose between circleout, fade, leftright, updown, rollup and rolldown.

    direction : direction (propagation) in grid transitions. You can choose between updownleftright, updownrightleft, downupleftright, downuprightleft and empty (no propagation).

    Here is an example :

    grid =
    transition =
    direction =

    As you can see possibilities are many, who dares try them :). If you don't use these three parameters, the applet will choose them randomly.

    You can choose the number of frame per second for transitions effects through the fps parameter (default is 15). The more fps is high the more applet use CPU.

    You can force J-Ads to use GIF loop (or iteration) flag through useGIFIteration parameter. Value should be yes or no.
    Warning : If you use GIF with high iteration value you will wait for a very long time to see the next GIF....

    You can display banners randomly by using the randomlevel parameter. Values could be firstone or all. "firstone" means that banners are displayed with a random one for the beginning. "all" means that all banners are displayed in a random order.

    You can choose the way to display banners, if they have not the same dimensions, through the displaymode parameter. Values could be center (all banners will be centered) or left (top-left align).

    You can select how J-Ads should wait between banners transistions through the waitmode parameter. This parameter is linked to the wait parameter. After one loop iteration J-Ads could wait for wait time expiration before displaying next banner.
    - waitmode = 0 means global wait time disabled (default)
    - waitmode = 1 means global wait time enabled - no loops.
    - waitmode = 2 means global wait time enabled - loops.

    You can force the first image that will displayed when random mode is enabled through firstad parameter (e.g. firstad=2 match to image_2).

     Server-Side Parameters (for advanced users) :

    Optional click counter is available for web servers that support CGI and PERL. This feature is usefull to make click reports.

    You can now count clicks on banners if your web server or ISP supports CGI. Fill in the clickcounter parameter with the url PATH to jads.cgi (e.g http://www.company.com/ads) then configure the server-side of J-Ads. To do so :

  • Adjust the PERL path matching to your web server (e.g #!/usr/bin/perl or #!c:\perl\bin\perl.exe) in jads.cgi
  • Upload jads.cgi and check that it is readable and executable (chmod 755).
  • Create an empty file : jadslog.txt with RW right (chmod 766) in the same directory as jads.cgi. If you manage multiple J-Ads Applets then create as many files jadslog_ID.txt as applets, each must have RW right access.
  • Default HTTP connection port with web server is 80 but you can force it through the port parameter.

    You can specify the ID extension of log filename (only for multiples J-Ads Applets) through the ID parameter. (i.e. id value is 402 then jadslog_402.txt will received click info).

    Download the perl script jads.cgi (Win32 or Unix oriented)

    F. A. Q. :

    J-Ads does not work when I upload it on the server ?

    First of all check that you uploaded all class files in BINARY mode. Secondly check location and filename (check case twice !) of uploaded banners (warning only GIF and JPEG formats are supported for banners).

    How to use J-Ads with external banners ?

    You must host the banners, Java does not allow connections with servers different from the one hosting Applet (Security Policy). Anyway if you try load external banners through J-Ads you will get: "Error loading banners, check location" or a Security exception !

    How to choose the server which host J-Ads ?

    Fill in the CODEBASE parameter in the Applet tag (i.e. CODEBASE="http://www.theDomain.com/theDirectory/"). Default is "./".

    Which browser do you support ?

    J-Ads 2 applet should work under any java capable browser that support AWT. That is to say 99% of browsers (Netscape 3.x, Netscape 4.0x, 4.x, IE4.x, 5.x or higher, Opera with the Java plugin, NeoPlanet, ...).
    Note that Netscape 4.61, under Mac OS only, does not support AWT correctly. Previews version of Netscape 6 might also have problem.

    I'm behind a Firewall/Proxy, J-Ads can't load banners ?

    Yes, this problem could appear under Netscape only. It comes from the proxy security preferences of Netscape. To fix this, do the following:

    Quit Communicator completely.
    2.Edit the Preferences file
    (The name and location of the file varies depending on your platform. On Windows 95 and NT, \Program Files\Netscape\Users\prefs.js. On UNIX, ~/.netscape/preferences.js. On Macintosh, "System Folder:Preferences:Netscape f:Netscape Preferences").
    3.Add the line: user_pref("security.lower_java_network_security_by_trusting_proxies", true);
    4.Restart Communicator.

    The clickcounter doesn't work ?

    First all of check that you web server allow CGI and PERL. Secondly edit jads.cgi to fill in the PERL path (i.e. #!/usr/local/bin/perl). Then check jads.cgi is "chmod 755" and jadslog.txt is "chmod 766". Finally check that the clickcounter parameter is the absolute path to jads.cgi.

    jads.cgi doesn't work on Windows Web Server ?

    Check that you downloaded the Win32 oriented Perl Script. Unix oriented jads.cgi script use "flock functions" not implemented on Windows 9x/NT.


    How to setup applet with J-Ads and HTML files in different directories ?

    Assuming that GIF files, class files, jads.ini, *.oxw are under jads/ and HTML file is under /, then use the following lines in your HTML file :
    <applet code="jads2.class" codebase="jads/" width="468" height="60">
    <param name="config" value="jads/jads.ini">

    Next, check that all banners and regfile paths start with jads/ in your jads.ini
    (i.e. image_0 = jads/computerbanner.jpeg, regfile = jads/javazoom.oxw)

    Can I use parameters from HTML applet tag instead of jads.ini ?

    Yes, simply use configsrc parameter to load parameters from HTML file :
    <applet code="jads2.class" width="468" height="60">
    <param name="configsrc" value="html">
    <param name="bgcolor" value="FFFFFF">
    <param name="regfile" value="mydomain.oxw">


    Do you provide a JAR version of J-Ads ?

    Yes. Click here to download it. JAR file is about 20KB (bandwidth-friendly) but it only works for 4.x browsers or higher.

    Do I need to enable the safe parameter?

    Yes and no. Multithreaded banners loading could cause Netscape hung in very particuliar configuration (not easy to reproduce). safe=yes disables multithreaded loading so banners come up a little bit slowly. (Default : safe=no).

    Is J-Ads support GIF iteration flag ?

    Yes. Use useGIFIteration = yes to do so. Infinite loop are ignored.










    Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U. S. and other countries.
    All other company and/or product names are the property of their respective owners.