This page last changed on Jul 16, 2009 by rosie@atlassian.com.
The gadget directory displays all the gadgets that are available to users. These are the gadgets that users can add to their dashboard.
You need to have administrator privileges to add a gadget to the directory. If you have permission to add gadgets to and remove gadgets from the directory itself, you will see the 'Add Gadget to Directory' and 'Remove' buttons on the 'Add Gadget' screen, as shown below.
If you have administrator privileges, you can add gadgets from Atlassian applications such as Confluence, JIRA and others. You can also add gadgets from other websites such as iGoogle. Many public gadgets will work on an Atlassian dashboard. Some gadgets may rely on specific iGoogle features that will not work properly on Atlassian dashboards. In that case, you can simply remove the gadget from the directory.
On this page:
 | Security implications Add only gadgets from sources that you trust. Gadgets can allow unwanted or malicious code onto your web page and into your application. A gadget specification is just a URL. The functionality it provides can change at any time. |
There are two types of gadgets: those that must be installed as plugins, and those that can be added as simple gadget URLs.
Adding a Gadget that is Not a Plugin
If the gadget is hosted on another server and can be added to the directory as a simple URL, then you can simply add it via your dashboard's 'Add Gadget' option.
To add a gadget to your directory,
- First you need to find the URL for the gadget's XML specification file. A gadget's URL looks something like this:
http://example.com/my-gadget-location/my-gadget.xml
Gadget authors and publishers make their gadget URLs available in different ways. Below are the instructions for a Google gadget and an Atlassian gadget.
- Follow the steps below to find the URL for a Google gadget:
- Go to the Google gadget directory. (You can also get there by clicking 'Add Stuff' from your iGoogle home page.)
- Search for the gadget you want.
- Click the link on the gadget to open its home page.
- Find the 'View source' link near the bottom right of the page. Right-click the link and copy its location to your clipboard. This is the gadget's URL.
- Follow the steps below to find the URL for a gadget that is published by an Atlassian application, such as JIRA or Confluence:
- Open the host application, such as JIRA.
Currently, only JIRA 4.0 has a dashboard that supports gadgets.
- Go to the host application's dashboard by clicking the 'Dashboard' link or the 'Home' link at the top left of the screen.
- Click 'Add Gadget' to see the list of gadgets in the host application's directory. The list will look something like screenshot 1 below.
- Find the gadget you want, then copy the location of the 'Gadget URL'.
The URL will have this format:
http://my-app.my-server.com:port/rest/gadgets/1.0/g/my-plugin.key:my-gadget/my-path/my-gadget.xml
For example:
http://mycompany.com/jira/rest/gadgets/1.0/g/com.atlassian.streams.streams-jira-plugin:activitystream-gadget/gadgets/activitystream-gadget.xml
- Now you can add the gadget to your directory. Go to the dashboard by clicking the 'Dashboard' link or the 'Home' link at the top left of the screen.
- The dashboard will appear. Click 'Add Gadget'.
- The 'Add Gadget' screen appears, showing the list of gadgets in your directory. See screenshot 1 below. Click 'Add Gadget to Directory'.
You will only see this button if you have administrator permissions for your dashboard.
- The 'Add Gadget to Directory' screen appears. See screenshot 2 below. Type or paste the gadget URL into the text box.
- Click 'Add Gadget'.
- The gadget appears in your gadget directory. (It will be highlighted for a short time, so that you can see it easily.)
Screenshot 1: Gadget directory with 'Add Gadget to Directory' button
Screenshot 2: Adding a gadget to the directory
Adding a Gadget that must be Installed as a Plugin
If the gadget must be installed as a plugin, you cannot add it via the gadget directory user interface.
Instead, you will need to follow your application's plugin management instructions.
RELATED TOPICS
Gadgets and Dashboards User Guide
Gadgets and Dashboards Administration Guide
Plugin management for Confluence
Plugin management for JIRA
|