Example Plugin

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

     

    Clearspace 1.X Plugin Files Attached Below