Confluence

The {yahoo} macro shows the online status for a specific Yahoo Instant Messenger user...

Overview:

This macro displays a graphic to indicate whether an YIM (Yahoo Instant Messenger) user is online or not.

Usage:

Add the macro to your page as follows:

{yahoo:YahooID|showid=true}

Parameters:

Parameter	Required	Notes
default		A valid YIM YahooID is required for this macro to work, for example: JoeBlogs10
showid		Set to false to stop the YahooID being displayed after the graphic. Default is true.

Notes:

The "showid" parameter was added in Confluence 1.5 - it will not be available if you are using an earlier version of Confluence.

If you are using Confluence 1.4.x, as this site is currently, the macro output will always appear as shown in the first example below.

Examples:

Standard Use

This uses the default image set and shows the hyperlinked YahooID to the user's profile:

{yahoo:JoeBlogs10}

If the user is online, the following will be shown:

JoeBloggs10

If the user is offline, the following will be shown:

JoeBloggs10

Hiding the Yahoo ID

You can hide the Yahoo ID if desired:

{yahoo:JoeBloggs10|showid=false}

Which results in:

Creating a User List #1

You can create simple user lists showing YIM status for each user:

{yahoo:JoeBloggs10|showid=false} Joe
{yahoo:MarkSmith|showid=false} Mark
{yahoo:FredBassey|showid=false} Fred

This will create a nice little user list on your page, showing the online status of each user (assuming they have YIM):

Joe
Mark
Fred

Creating a User List #2

This version uses a simple table to "box in" the user list:

||YIM||Name||
|{yahoo:JoeBloggs10|showid=false}|Joe|
|{yahoo:MarkSmith|showid=false}|Mark|
|{yahoo:FredBassey|showid=false}|Fred|

Results in:

YIM	Name
	Joe
	Mark
	Fred

Hints and Tips

Place this macro in your personal profile so that people can easily see whether you are online or not.

Frequently Asked Questions

See Also

• Altassian's online IM Presence documentation
• icq macro
• aim macro