This page last changed on Jun 01, 2009 by ggaskell.

The IM Presence Macro indicates graphically when a contact is signed into an Instant Messaging (IM) service. The IM presence macro appears as a small icon on the page, like this image: .

On this page:

Usage with the Macro Browser

To insert the IM presence macro into a page using the Macro Browser,

  1. Open your desired Confluence page, then click the 'Edit' button. The 'Edit Page' mode opens.
  2. Next, click the Macro Browser icon on the editor toolbar. The Macro Browser will open in the middle of the screen.
  3. In the Macro Browser, type the name of your desired macro into the search box at the top right of the window. Macros with a matching name will appear in the centre pane. Click on the desired macro to see its options screen. Here, you can set the macro parameters then click 'insert' to put the macro into the page.

Once you've found the IM presence macro, enter values for 'User ID/Screen Name' and select the service from the drop-down list. Finally, click 'insert' to add the macro to your page.

Usage with the Wiki Markup Editor

The following instant messaging services are supported:

Yahoo! Presence Macro

What you need to type What you will get
{yahoo:myYahooId} If online
{yahoo:myYahooId} If offline

AIM Presence Macro

What you need to type What you will get
{aim:myScreenName} If online
{aim:myScreenName} If offline

ICQ Presence Macro

What you need to type What you will get
{ icq:icqnumber} If online
{ icq:icqnumber} If offline

Parameters

Parameters are settings for Confluence macros that allow the user to control their content or presentation. The table below lists relevant parameters for this macro.

Parameter names are displayed differently in the macro browser interface and in wiki markup. Below, parameter names used in the macro browser are indicated in Bold text, while their equivalents in wiki markup are indicated in (bracketed) text. If the latter is not shown, then in wiki markup, the parameter's name should be omitted and only its value should be added immediately after the colon symbol (:).

Parameter Default Description
aim
(aim)
None AOL Instant Messenger: Specify the user's Screen Name.
gtalk
(gtalk)
None Google Talk: Specify the user's Google account name.
icq
(icq)
None ICQ: Specify the user's ICQ number.
msn
(msn)
None MSN Instant Messenger: Specify the user's MSN account name.
sametime
(sametime)
None IBM Lotus Sametime: Specify the user's Sametime account name.
skype
(skype)
None Skype: Specify the user's Skype account name.
skypeme
(skypeme)
None Skype: Specify the user's Skype account name.
wildfire
(wildfire)
None Openfire Server: Specify the user's Jabber/XMPP account name.
yahoo
(yahoo)
None Yahoo! Messenger Yahoo! Instant Messenger: specify the user's Yahoo! ID.
Show User ID
None Shows or hides the User ID of the contact.



RELATED TOPICS

Working with Macros

Take me back to the Confluence User Guide.

Document generated by Confluence on Nov 05, 2009 23:35