|
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, ...
last
update : 01/12/2004
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">
</APPLET>
|
+
config file : jads.ini
|
###################################
# J-Ads V2.1.3 Configuration file #
# Copyright JavaZOOM - 2000
#
# http://www.javazoom.net
# ###################################
#---------------------------------#
# 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
safe=yes
|
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">
</APPLET>
|
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 :
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....
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:
1.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.
I
can't get rid of the "UNREGISTERED" message ?
To remove the "UNREGISTERED"
message you have to register to get your unlock file.
If you already have an unlock file then be sure that it
matches to the domain name where the applet is running.
Note : Some people had problems with Front Page
they got rid of the unregistered message once the applet
was uploaded.
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">
</applet>
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">
</applet>
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.
Registration :
Registered
version of J-Ads V2.1 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 is possible if you register more than three domain.
|