This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

IM Presence Macro

All Versions

Confluence 3.0 Documentation

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.

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Apr 11, 2006

    richard chang says:

    Can you add the msn here?

    Can you add the msn here?

  2. Oct 11, 2006

    Christian Løverås says:

    This noe has support for MSN: http://confluence.atlassian.com/display/CONFEXT/IM...
  3. Dec 05, 2007

    Bill Callahan says:

    How about Google Talk?

    How about Google Talk?

    1. Dec 05, 2007

      Choy Li Tham says:

      Hi Bill, The IM Presence macro does not support for Google Talk. However, you m...

      Hi Bill,

      The IM Presence macro does not support for Google Talk. However, you may want to give a try to the IM Presence Plugin, which does support the Google Talk.

      Regards,
      Choy Li

  4. Jun 13, 2008

    Charles Reimers says:

    Our company uses YMess for internal messaging, so everyone had the YMess applica...

    Our company uses YMess for internal messaging, so everyone had the YMess application installed.  Is there a way to create a

    ymsgr:sendIM?<userID>

    link instead of the default webmessage link?  I've tried to create my own links, but confluence doesn't seem to like the ymsgr: tag.

    Any suggestions?

    Thanks,

    Charles

    1. Jun 17, 2008

      Mei Yan Chan says:

      Hi Charles, You will need to customise the macro in order for you to implement ...

      Hi Charles,

      You will need to customise the macro in order for you to implement your own links.

      Regards,
      Mei

  5. Jul 17, 2008

    Anonymous says:

    the Macro here has no Version! in my Version 2.2 the ICQ presence does not ...

    the Macro here has no Version!

    in my Version 2.2 the ICQ presence does not Work!

    HELP please -> rsc@cybits.de

    we evaluate confluence and Jira

    rgds

    rsc

    1. Jul 21, 2008

      Azwandi Mohd Aris says:

      Hi rsc, A more detailed information about this macro can be found at Confluence...

      Hi rsc,

      A more detailed information about this macro can be found at Confluence Extension space:

      Have you tried turning on the setting to allow other users to see your ICQ status? Also, it might be helpful to hold the shift key when you reload the page to renew the browser's cache.

      Hope this helps.

      Cheers,
      Azwandi

Add Comment


Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.