This page last changed on May 18, 2005 by daniel@atlassian.com.

The IM presence macros allow you to show a graphic indication when someone is online.

The supported systems are

  1. Yahoo!
  2. AIM
  3. ICQ

Yahoo! Presence Macro

Usage: {yahoo:yahooID}
Description: Show a graphic indication of when someone is online
Example:
{yahoo:myYahooId}
Input: yahooID: is required and should be a valid Yahoo! account ID.
Output: An image indicating the online status of the specified user. eg: or
Bundled with Confluence?: Yes
Since: 1.4

AIM Presence Macro

Usage: {aim:screenname}
Description: Show a graphic indication of when someone is online
Example:
{aim:myScreenName}
Input: screenname: is required and should be a valid AIM screen name.
Output: An image indicating the online status of the specified user. eg: or
Bundled with Confluence?: Yes
Since: 1.4

ICQ Presence Macro

Usage: {icq:icqnumber}
Description: Show a graphic indication of when someone is online
Example:
{icq:12345678}
Input: icqnumber: is required and should be a valid ICQ UIN.
Output: An image indicating the online status of the specified user. eg: or
Bundled with Confluence?: Yes
Since: 1.4

yahoo-offline.gif (image/gif)
icq-online.gif (image/gif)
icq-offline.gif (image/gif)
aim-online.gif (image/gif)
aim-offline.gif (image/gif)
yahoo-online.gif (image/gif)

The icq presence macro also outputs an html link with the uin. Is it possible to disable this?
Nicer icons (for icq) wouldn't hurt either

Any plans for a jabber presence macro?
Cheers,

Posted by greg_greg at Aug 18, 2005 11:43
  • You currently can't suppress the display of the ID. I've filed an issue for this in JIRA and scheduled it to be fixed in the next release: CONF-3806
  • The icons we use for ICQ are the ones provided by the ICQ web service that tells us who is online. There were five or six different icons to choose from, and I picked what I thought was the least offensive.
  • There's no Jabber macro because AFAIK, there isn't a similar web service provided by Jabber servers – Confluence would actually have to log in to the Jabber network and issue a presence request, which is a whole extra level of complexity.

The source for the IM Presence macros is shipped with Confluence (in plugins/impresence), so you may be able to customise them to suit your needs better.

Posted by cmiller at Aug 18, 2005 19:44

Oh, thanks for the comments Charles.
For icq icons, I like #5/10 better: http://www.icq.com/features/web/indicator.html
I'll comment on the jira issue.

Posted by greg_greg at Aug 19, 2005 20:09

Hi,

At work, we use Lotus Sametime Instant Messaging. I was wondering is there any way macro can be developed so that users can see the status of sametime messangers for others ?

Can you please tell me how can I acheive this ?
thanks,
Rajendra

Posted by rakadam at Jan 03, 2006 17:17

Well, the YahooPresenceMacro works by asking Yahoo! to check for the user's online presence and return the appropriate online/offline image as described on this page:

http://messenger.yahoo.com/messenger/help/online.html

If you have something similar for Lotus IM, you can adapt the YahooPresenceMacro class (bundled in the Confluence source).

Hope that helps,
Dave

Posted by dave@atlassian.com at Jan 03, 2006 22:43

See CONFEXT:Sametime status macro.

Posted by bob.swift@charter.net at Jan 03, 2006 23:34
Document generated by Confluence on Mar 22, 2007 20:54