| Name | IM Presence NG Plugin |
|---|---|
| Vendor | Atlassian Software Systems (Website) |
| Authors | Jonathan Nolen, David Peterson |
| Homepage | http://confluence.atlassian.com/display/CONFEXT/Confluence+IM+Presence+Plugin |
| Issue Management | http://developer.atlassian.com/jira/browse/PRES |
| Continuous Integration | n/a |
| Categories | Communication Macros |
| Most Recent Version | 2.3 |
| Availability | Confluence v2.7 to v2.10 |
| State | Stable |
| Support |
|
| License | Freeware / Open Source (BSD) |
| Price | Free |
| Release Docs | http://confluence.atlassian.com/display/CONFEXT/Confluence+IM+Presence+Plugin |
| Java API Docs | n/a |
| Download Source | http://svn.atlassian.com/svn/public/contrib/confluence/impresence-plugin/tags/impresence-plugin-2.3/ |
| Download JAR | impresence-plugin-2.3.jar |
 | This plugin can be installed and updated via the Confluence Repository Client. |
Compatibility With Confluence
Description/Features
Display the presence status of users for a variety of Instant Messaging services.
A simple macro which displays the presence status of users for various Instant Messaging services, such as AIM or MSN.
This can be considered a replacement for the existing macros which come bundled with recent versions of Confluence, as well as the Aim User Status Macro, Google Talk Macro, Sametime status macro, Skype Me User Macro, Wildfire Presence Macro and Yahoo Status macro.Screenshots
|
|
The various services in action.
|
Downloading & Installing
Option 1
The recommended way of installing is to use the Confluence Repository Client. This will not only make it easier to install, but it will help keep you up to date with this and other plugins.
- Open the repository client screen.
- Select 'Install' for the IM Presence Plugin entry.
Option 2
Alternately, you can install it manually:
- Download impresence-plugin-2.0-rc2.jar
- Upload it using Confluence's administration console.
Setup
Once you have installed the plugin, you will have to do some configuration for some of the services to work. There are two main types of setup.
Dummy User
Some (such as Google Talk and MSN) only advertise presence status to logged-in users who have been added to the target user's contact list. As such, the setup process is something like this:
- Create a dummy user for the specified service (eg. 'dummy001@hotmail.com')
- Enter the user id and password in the configuration screen for that service.
Then, to display the presence of an MSN user, the Confluence editor would enter something like the following:
{im:my_username@hotmail.com|service=MSN}
- Log in as a dummy user
- Add the target user as a contact of the dummy user
- Wait for the target user to approve the dummy user to see their status
- Report the status of the target user.
Custom Server
Some other services (such as Jabber/Wildfire) need to have the chat server address set. In this case, the procedure is as follows:
- Set up the IM Server if necessary.
- Enter the server address in the configuration section of the plugin.
Once this is done, presence can be listed as per usual.
Macros
{im:[my username]|service=[my service]}
Details: Outputs an editable dynamic calendar.
Parameters:
| Name | Required | Description |
|---|---|---|
| (default) | |
The id/screen name of the user. |
| service | |
The name of the service. Supported services are: aim, gtalk, icq, msn, sametime, skype, wildfire and yahoo. |
| showid |  |
If set to 'false', the ID/screen name will not be displayed. Defaults to true. |
A number of old macro formats are also supported (starting with version 2.0) for compatibility with older im macro plugins. These older formats are:
{aim:[my username]}
{gtalk:[my username@gmail.com]}
{icq:[my username]}
{msn:[my username]}
{sametime:[my username]}
{skype:[my username]}
{skypeme:[my username]}
{skypeme}[my username]{skypeme}
{wildfire:[my username]}
{wildfire}[my username]{wildfire}
{yahoo:[my username]}
Examples
Default display
This displays the status of a Yahoo! Messenger user.
{im:my_username|service=Yahoo}
No User ID
This will display the status without also displaying the user id.
{im:my_username|service=Yahoo|showid=false}
Version History
| Version | Date | State | License | Price |
2.3
(#8)
|
23 Oct 2008 | Stable | Freeware / Open Source (BSD) | Free |
|
2.2
(#7)
|
09 Jul 2008 | Stable | Freeware / Open Source (BSD) | Free |
|
2.1
(#6)
|
12 Mar 2008 | Stable | Freeware / Open Source (BSD) | Free |
|
2.0
(#5)
|
17 Oct 2007 | Stable | Freeware / Open Source (BSD) | Free |
|
2.0-rc3
(#4)
|
02 Oct 2006 | Prerelease | Freeware / Open Source (BSD) | Free |
|
2.0-rc2
(#3)
|
27 Jun 2006 | Prerelease | Freeware / Open Source (BSD) | Free |
|
2.0-rc1
(#2)
|
22 Jun 2006 | Prerelease | Freeware / Open Source (BSD) | Free |
|
2.0-dr1
(#1)
|
22 Jun 2006 | Beta | Freeware / Open Source (BSD) | Free |
Resolved
