J-Ads

What 's NEW ?

How to install J-Ads 2 ?

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 :

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.

 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 usefull when your first banner is an heavy GIF.

You must have TWO or more banners (only GIF format) to fill image_0, image_1, ... parameters. Animated GIF are supported ! .

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 GIF. 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 = 10x10
transition = circleout
direction = downuprightleft

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

 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 format 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 "./".

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.

Is J-Ads support GIF iteration flag ?

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

Registration :

Registered version of J-Ads V2.0 cost $19 US per domain name.
( e.g : www.mydomain.com or www.myisp.com/mypage )
Full support is included (this documentation + email support).
Update are free.
Discount are possible if you register more than three domain.