A kind of smorgasbord, this plugin includes several simple examples designed to show how plugins and macros work.
What's Included
What the Samples Do
The samples here include:
An macro that displays the name of the user currently logged in.
To test: Create a wiki document, add to the document, then publish the document.A "Hello World" tab in the admin console.
To test: Display the admin console, then click the Hello World tab. You'll get a new "Hello World" page.An "Example Test" menu in the user bar.
To test: Display the Clearspace UI, click the Example Test menu, then click the Example command. You'll get a new page displaying results from actions included in this plugin.An "Example Plugin" link in the community Actions box.
To test: Display the Clearspace UI, navigate to a sub-community, then click the link. You'll get a new page displaying results from actions included in this plugin.An "EchoService" web service that returns text submitted to it.
To test: Write a web service client that calls the echo operation with some string. The service returns that string, prepended with the name of the user who sent it.
Java Source
ExamplePlugin.java
HelloWorldAction.java
IncludedPageAction.java
SimpleAction.java
AuthorsNameMacro.java
EchoService.java
Resources
examples.css
example.ftl
helloword.ftl
included-page.ftl
Building and Deploying the Code
The Ant build.xml file at the root of the plugin includes a build.plugins target you can use to compile the code and package it into a JAR file. There's also a deploy.plugins target that copies the JAR into the <jiveHome>/plugins directory that accompanies your Clearspace distribution. Paths into your test Clearspace distribution assume that this plugin project is in the standalone Clearspace distribution at: <root>/plugins/plugins/helloworld. Be sure to update the targets if you're testing another way, such as with the Clearspace WAR distribution.
Be sure to read the notes below about dependencies. The JAR files you'll need are included as part of Clearspace.
If you'd rather deploy the plugin manually, you can do that in one of two ways:
Just copy the plugin JAR file into the <jiveHome>/plugins directory. Your running Clearspace instance will deploy it automatically.
Open the admin console and navigate to System > Settings > Plugins, then browse for your plugin JAR file.
Dependencies
In addition to requiring Java 1.5, this code requires a few of the libraries you'll find in the WEB-INF/lib directory of your Clearspace installation, listed below.
clearspace-<version>.jar
webwork.jar
xwork.jar
rife-continuations.jar
xfire-jsr181.jar
Clearspace 2 Plugin Files