Composer: developers

# Developing a sidebar for Composer

To offer new sidebar content to Composer users, you have to distribute your application as an installable extension to Composer, a *.xpi file.

The application id for Composer is `{8fa6f1b4-7ed3-4895-bac6-01f1cc206ab3}` .

1. How to register a new sidebar
2. Make your sidebar observe editor events

## How to register a new sidebar

Your extension should add elements to chrome://bluegriffon/content/xul/bluegriffon.xul through a XUL overlay :

- append a new `sidebaritem` element to `<sidebaritems id="sidebaritems">`
- that element must have an ID, unique in the ID name space of bluegriffon.xul
- that element must have a `name` attribute, representing your sidebar content ; that sidebar should be a NAME ; it is recommended that the ID and that attribute have the same value
- that element must have a `src` attribute, containing the URL of the document to be shown in your sidebar content; this is typically going to be a chrome URL in your XPI
- that element can have a `title` containing a (possibly localized) string representing the sidebar item. That string will be used in the sidebar to list the available sidebar items or title the visible sidebar items. If absent, the value of the `name` attribute is used.

## Make your sidebar observe editor events

TBD

#### History

Last Update:
  2007-oct-29, 10:18am CEST
2007-oct-29, 10:18am CEST
  initial revision (dglazman)