Confluence

The {aim} macro shows the online status for a specific AOL Intant Messenger user...

Overview

This macro displays a graphic to indicate whether an AIM user is online or not.

Usage

Add the macro to your page as follows:

{aim:ScreenName|showid=true}

Parameters

Parameter	Required	Notes
default		A valid AIM ScreenName is required for this macro to work, for example: JoeBlogs10
showid		Set to false to stop the ScreenName 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 Screen Name to the user's profile:

{aim:JoeBlogs10}

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

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

Hiding the Screen Name

{aim:JoeBloggs10|showid=false}

Which results in:

Creating a User List #1

{aim:JoeBloggs10|showid=false} Joe
{aim:MarkSmith|showid=false} Mark
{aim: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 AIM):

Joe
Mark
Fred

Creating a User List #2

||AIM||Name||
|{aim:JoeBloggs10|showid=false}|Joe|
|{aim:MarkSmith|showid=false}|Mark|
|{aim:FredBassey|showid=false}|Fred|

Results in:

AIM	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
• yahoo macro