Jivespace Community Blog

Translate Your Clearspace Content into Other Languages!

communities@jivesoftware.com — Fri, 18 Jan 2008 18:47:42 GMT

Do you have employees or customers who working in various locations around the world?

The Translations macro can help you easily translate documents into other languages only as the need arises. It will insert several flags into the document. When you click on one of the flags, a new window will open with the translated version of the current page.

Right now, it is using Google as the translation engine, and is fixed at having English as the original language. However, the source code is available if you want to tweak it to meet your specific needs (just don't forget to contribute back any enhancements)!

If you want to take a peek at the code to see how the translations macro was constructed, you can get the source from svn.

Easy Way to Embed Presentations or Other Media in Clearspace

communities@jivesoftware.com — Thu, 10 Jan 2008 18:59:14 GMT

If you are looking for an easy way to display slide shows in Clearspace, we have a SlideShare Macro plugin that lets anyone display a slide show presentation in documents, blog posts, and threads.

You can use this plugin to display SlideShare presentations, but it also provides a simple example code to illustrate how you can use a plugin to display media from other online sources in Clearspace as embedded content. You can learn more about the plugin or just download the code from svn.

A quick example:

Add Shiny New Features to Clearspace with a Simple Macro

communities@jivesoftware.com — Tue, 13 Nov 2007 22:15:47 GMT

Want to add a shiny new feature to your Clearspace community? It just might be easier than you think! A macro can be used for anything from embedding videos to displaying Jira Issues to adding bling

A macro class that extends com.jivesoftware.community.renderer.BaseMacro. This class will implement the methods that Clearspace calls to get the String value for display in the user interface where the user has inserted your macro.
Macros are technically plugins, so yours will include a plugin.xml file that describes the plugin to Clearspace, including which Java class is your macro class.

to your text. They are also an easy way to get started if you want to add some custom functionality to your Clearspace community.

The basics

For simple macros, you'll really need just two pieces of code:

The process

Set up your testing environment and project hierarchy.
Create your plugin.xml file, which tells Clearspace what's in the plugin -- in short, what Clearspace features you're extending -- and where to find code and other supporting files your plugin needs
Create a plugin class with the logic to tell Clearspace what to do when the user uses your macro.
Build, deploy, and test your macro.

Sounds pretty easy. If you still aren't sure, you can start with these documents and tutorials:

The specified document was not found.
The specified document was not found.
The specified document was not found.

And as always, you can post any questions here in Jivespace if you get into any trouble.

What's your craziest idea for a macro?

Want to Display Jira Issues from within a Clearspace Document?

communities@jivesoftware.com — Mon, 12 Nov 2007 17:06:35 GMT

Have you ever wanted to pull a list of issues from JIRA into a document? Tim Colson, the winner of our first plugin contest, has developed an awesome JiraIssues Macro that makes it easy to interact with JIRA issues from within Clearspace using a slick Flex interface!

Because the input of the macro is an XML feed URL, you can customize it to show almost any cut of the data from Jira (only open issues on a specific project owned by a certain owner, etc.) The interface gives you the flexibility to filter, show/hide fields, and interact with the data in a variety of ways.

Download the plugin or learn more about the JiraIssues Macro Plugin with Flex.

If you are interested in writing your own plugin or macro for Clearspace, you can find plenty of information in our documentation space.