With this Plugin for [JSPWiki|http://www.jspwiki.org] you can use [Image Maps|Google:Image Map Tutorial] on your pages in a very easy way. The plugin can be used the same way like the normal [ImagePlugin|JSPWiki:Image]. The map points and links can be edited by a simple web based wizard, or you can type the map points in the plugin text.

If you click on the edit-link at the right bottom corner of the picture, you will jump to the image map wizard, just try it.

!Example

[{ImageMap image='deutschland.png'

NordrheinWestfalen;50;170;20
http://www.berlin.de;217;115;20
http://www.bayern.de;165;273;20
http://www.hessen.de;91;204;20

Oslo;83;294;20
www.google.com;95;106;20
xxx;112;101;20
yyy;172;153;20
ggg;170;131;20
ccc;151;196;20
http://44wo.com;184;63;20
www.44wo.com;217;345;20
www.446.com;207;341;20
2;158;156;20
perak;179;92;20
;0;0;20
aaa;0;0;20
GoHere;169;137;20
www.bb.com.br;100;98;20
www.bb.com.br;107;101;20
Sachsen;215;183;20
}]

is created by the following plugin definition:

{{{
[{ImageMap image='deutschland.gif'

NordrheinWestfalen;50;170;20
http://www.berlin.de;217;115;20
http://www.bayern.de;165;273;20
http://www.hessen.de;91;204;20
}]
}}}

!ImageMap-Plugin-Parameters
|| Name || Description || Necessity
| image | URL or attachment name of the image | required
| align | center, left, right | optional (none)
| width | size of the image | optional
| height |size of the image | optional

It is important that the plugin text has a body part, that is the text after the blank line under the {{ImageMap}} definition. Here the wizard stores the link and point parameters in the form {{link;x;y;r}}. So an empty ImageMap must have a blank line before the closing brakets.

By default a circle with radius r is used. Link can be any wiki link. You can specify other shapes like {{link;polygon;x1;y1;x2;y2;...;xn;yn;}} or {{link;rect;x1;y1;x2;y2;}} but at the moment the wizard just creates circle shapes with radius 20. Other shapes are working but must be edited by hand in the page text for the time beeing.

!Installation

1. The following jars must be copied to {JSPWiki}/WEB-INF/lib:

* [SBaltesPlugins.jar|SBaltesPlugins/SBaltesPlugins.jar]

2. The following must be added to {JSPWiki}/WEB-INF/web.xml:

{{{
<servlet>
<servlet-name>ImageMapServlet</servlet-name>
<servlet-class>
com.ecyrd.jspwiki.plugin.ImageMapServlet
</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>ImageMapServlet</servlet-name>
<url-pattern>/ImageMapServlet</url-pattern>
</servlet-mapping>
}}}

!Known Bugs

* The __Referenced By__ tag does not recognize ImageMap links.
* The old plugin syntax {{{[{INSERT .... WITH param}]}}} is not supported by the wizard.

!Source Code

The source code is part of the SBaltesPlugins.jar.

!License

ImageMapPlugin a JspWiki Plugin for using html image maps.
Copyright (C) 2004 Sebastian Baltes

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

[GNU LESSER GENERAL PUBLIC LICENSE Version 2.1|http://www.gnu.org/copyleft/lesser.txt]