!!!''Much of this description is for the upcoming release, so if you download it to try it be warned!''

This plugin allows a live running JSPWiki to be visualized (much like the TouchGraphWikiBrowser).  There are three parts to this:
# A plugin, which just emits an __{{<applet>}}__ tag for:
# An applet which allows a user to launch the:
# Swing based visualization application (which can incidentally be used from the commandline if desired).

The visualiztion polls the wiki server for recent changes every {{update=}} seconds, so you can watch new pages and links spring into existance on the graph.

Inspiration was taken from the TouchGraphWikiBrowser, code in the {{graphview}} package is courtesy of [KAON OI-modeler|http://kaon.semanticweb.org/Members/motik/oimodeller]who heavily refactored and cleaned up the rough & ready [TouchGraph|http://touchgraph.sourceforge.net/index.html] code.

Here's what the applet looks like:
;:[applet.png]

And here's a sample screen shot of a mostly empty wiki:
;:[screenshot.png]

----
!!Installation
The VisualizerPlugin is bundled in the attached [visualizer.zip] __must be extracted into your root wiki directory__ (where the wiki.jsp and other non-template jsp's are located) for the applet and application to be runnable.  This will put the needed jar files in an applet accessable place.  Also your wiki must have XMLRPC enabled in it's deployment descriptor (WEB-INF/web.xml).  The McKessonApsWikiPlugins.jar file (included in the zip) must be present in the root for the visualizer to run __even if you don't want the plugins__.  Putting the McKessonApsWikiPlugins.jar in the root __does not__ enable those plugins for your wiki, it is required for download to the client for the applets use.

!!Plugin Parameters
This plugin has a bit more elaborate means of getting parameters beyond simple plugin invocation parameters.  See VisualizerDirectivesPlugin for full documentation.  There __are__ some basic parameters to use beyond the directives though:
* {{xmlrpc=}} - __Required__, The full url of the WikiRPCInterface to be visualized.
* {{update=}} = ''Optional'', polling frequency for updates, default is 10 seconds.
* {{unreferenced=}} - ''Optional'', True or False, show unreferenced pages in the visualization.  Unreferenced pages float as an island if shown.  Defaults to {{true}}.
* {{pages=}} ''Optional'', fed to a QueryPlugin instance, only pages returned by the query get visualized.

!![Visualizer Features]
A list of the features supported by the visualizer are kept over on the [Visualizer Features] page to keep this one shorter.

!![Visualizer Plugin Discussion]
Please keep most discussion about this plugin on [this|VisualizerPluginDiscussion] page.

!!Thanks...
I cannot say enough good thigs for the folks who refactored the TouchGraph code for the [KAON OI-modeler|http://kaon.semanticweb.org/Members/motik/oimodeller]. The {{graphview}} code is quite a nice framework for doing this sort of thing.  (I have a thing about clean code, and TouchGraph was a bit ickey, where as KAON's felt like home...)

!!Bugs
Two files in the ZIP are world writable!
{{{-r--r--r--    1 root     root         5380 Dez 23 10:22 BrowserLauncher.jar
-rw-rw-rw-    1 root     root       314158 Mär 15 09:59 McKessonApsWikiPlugins.jar
-rw-rw-rw-    1 root     root       234385 Mär 15 09:59 Visualizer.jar
-r--r--r--    1 root     root        59964 Dez 23 10:22 xmlrpc.jar}}}
Please fix that!

----
ContributedPlugins