Confluence

The {icq} macro shows the online status for a specific ICQ user...

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

Usage

Add the macro to your page as follows:

{icq:12344563|showid=true|image=2}

Parameters

Parameter	Required	Notes
default		A valid ICQ UIN is required for this macro to work, for example: 12344563
showid		Set to false to stop the UIN being displayed after the graphic. Default is true.
image		Selects the image set to use.

Notes

The "showid" and "image" parameters were added in Confluence 1.5 - they 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.

The default value for the "image" parameter is 2 for Confluence 1.4.x and 5 for Confluence 1.5 onwards.

Examples

Standard Use

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

{icq:12344563}

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

12344563

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

12344563

Note: The images above are the defaults for Confluence versions prior to 1.5

Alternate Image Set

It looks a lot nicer if image set 5 is used (this is the default from Confluence 1.5 onwards):

{icq:12344563|image=5}

Looks like:

 12344563

Hiding the UIN

If you're hiding the UIN display, image set 3 looks quite good:

{icq:12344563|image=3|showid=false}

Which results in:

Creating a User List #1

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

{icq:12344563|image=5|showid=false} John
{icq:12344463|image=5|showid=false} Mark
{icq:12344464|image=5|showid=false} Fred

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

John
Mark
Fred

Creating a User List #2

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

||ICQ||Name||
|{icq:12344563|image=5|showid=false}|John|
|{icq:12344463|image=5|showid=false}|Mark|
|{icq:12344464|image=5|showid=false}|Fred|

Results in:

ICQ	Name
	John
	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

• icq-time macro
• Altassian's online IM Presence documentation
• aim macro
• yahoo macro