This is preliminary documentation and is subject to change.  Social Status is available for developers from Firefox 26* and is tentativly scheduled for general availability in Firefox 27.  *developers must set the boolean preference social.allowMultipleWorkers to true.

A service provider may choose to provide a Social Status button that allows them to provide a notifications style panel in the user's toolbar.  The provider may use the social worker to update the button badge using the social.ambient-notification API.  The panel otherwise contains an iframe that loads a page from the service provider.

Status URL

To support the Status button, the provider must include a url in the manifest:

"statusURL": "https://yoursite.com/status"

How to properly size your status panel

Your status panel is presented in a door hanger from the browser toolbar.  While it can be flexible in size, there is a minimum and a maximum size that the panel will allow.  You also need to implement a couple items to help the browser identify the size you need for your panel.  There are a few ways you can define the proper size for your panel, here are some examples:

Styling the BODY element

By default the browser will look at the body.style.width and body.style.height, also taking into account the margin.  It will try to size the panel to show your full page.

<html>
<body style="width: 300px; height: 400px">
</body>
</html>

Identifying a content element

The browser will also look to see if you have defined a primary content element.  If you have, then it will use the width and height styles from that element to size the panel.  You will need to make sure that your content element is properly placed.

<html>
<body contentid="content">
<div id="content" style="width: 300px; height: 400px; top: 0; left: 0;"/>
</body>
</html>

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, kylewmahan, Sheppy, Mixedpuppy
 Last updated by: chrisdavidmills,