presence Plugin Archive

Below is a list of versions that are available for the presence plugin. To find other plugins, please review this listing of most recent releases of all plugins.

Plugins extend and enhance the functionality of Openfire. To install plugins, copy the .jar file into the plugins directory of your Openfire installation.

Presence Plugin Readme

Overview

The presence plugin is a service that provides simple presence information over HTTP. It can be used to display an online status icon for a user or component on a web page or topoll for presence information from a web service.

Installation

Copy presence.jar into the plugins directory of your Openfire installation. Theplugin will then be automatically deployed. To upgrade to a new version, copy the newpresence.jar file over the existing file.

Configuration

The presence plugin can be configured via the Openfire Admin Console.Use the configuration page to specify whether presence information should be available to anyone or restricted to authorized users (users which have presence subscriptions).The status message for unavailable users can also be changed from the default of"Unavailable".

Using the Plugin

To get presence information for a user, submit HTTP requests to the presence service. The service address is [hostname]/plugins/presence/status. For example,if your server name is "example.com", the URL is http://example.com/plugins/presence/status.

The following parameters can be passed into the request:

Name Description
jid Required The bare JID (address) of the user to get presence information for (e.g. "jsmith@example.com"). The address must be on the same server that the presence service is deployed on.
req_jid Optional The bare JID (address) of the user requesting presence information. This parameter may be required in order to have permission to get presence information. For example, the presence service can be configured to only allow presence requests from users that have a presence subscription to the requested jid.
type Optional The type of response to return. Valid values are image, text or xml. If this parameter is not specified, the default value is image, which will display an image representing the user's presence. If xml is specified, an XML representation of the user's presence will be returned. If text is specified, the status text of the user's presence will be returned.
images Optional The presence service includes a default set of images that will be returned for a user's presence. You can specify a custom set of images using this parameter. The value should be the URL to the images and should include an --IMAGE-- token. For example: "http://www.example.com/images/--IMAGE--.gif". The token will be dynamically replaced with one of the following values depending on the presence status: available, chat, away, xa, dnd, offline, or forbidden. If this option is used, the presence service will respond with an http redirect pointing to the supplied image url.
[image_type] Optional Instead of specifying a single location for all custom presence images, you can override each image location directly. The parameter name should be one of the following values: available, chat, away, xa, dnd, offline, or forbidden. The parameter value should be the full URL of the image, such as "http://www.example.com/images/dnd.png". These parameters can be used in combination with the "images" parameter to specify a base location for custom images but then to override specific images with different locations.

Sample HTML

The following example is the simplest form of calling the service to displaydefault presence images. The server name and user must be customized for your deployment:

    <img src="http://example.com:9090/plugins/presence/status?jid=jsmith@example.com" border="0">

This example requests a user's presence by the user "jsmith" and specifiescustom images that should be used to display the user's presence:

    <img src="http://example.com:9090/plugins/presence/status?jid=mary@example.com&req_jid=jsmith@example.com&images=http://www.example.com/images/--IMAGE--.gif" border=0>

This example requests the presence of a user in XML format:

    http://example.com:9090/plugins/presence/status?jid=jsmith@example.com&type=xml

This example requests the status text of the presence of a user in text format:

    http://example.com:9090/plugins/presence/status?jid=jsmith@example.com&type=text

Working With Firewalls

Because the presence plugin runs within the Openfire admin console web container, usersbehind firewalls may have problems seeing the presence icons. For example, if the Openfireadmin console runs on the default port of 9090 and a user is only allowed to receive HTTP trafficon port 80, then a web request like the following won't work:

    <img src="http://www.example.com:9090/plugins/presence/status?jid=jsmith@example.com">

One solution for Apache users is to use mod_rewrite, mod_proxy and mod_proxy_http to servetraffic for the plugin on port 80. Sample Apache configuration entries for performing this mappingare below. Essentially, we make Apache intercept all requests for the presence plugin on port 80 andthen proxy a real connection to the HTTP server on port 9090.

1
2
3
4
5
6
7
8
9
<virtualhost *:80>  servername example.com  ....  ProxyVia On  RewriteEngine On  RewriteCond %{REQUEST_URI} ^/plugins/presence/status  RewriteRule ^/(.*) http://example.com:9090/$1 [P]</virtualhost>
Releases Info File Version Released Openfire Version
Plugin Presence Service
Exposes presence information through HTTP.
ReadMe Changelog Download 1.7.3 Thu Sep 12 17:11:20 UTC 2024 4.1.1 +
Plugin Presence Service
Exposes presence information through HTTP.
ReadMe Changelog Download 1.7.2 Fri Jan 19 14:20:53 UTC 2024 4.1.1 +
Plugin Presence Service
Exposes presence information through HTTP.
ReadMe Changelog Download 1.7.1 Thu Nov 12 00:00:00 UTC 2020 4.1.1 +
Plugin Presence Service
Exposes presence information through HTTP.
ReadMe Changelog Download 1.7.0 Mon Oct 12 00:00:00 UTC 2015 4.0.0 +
Plugin Presence Service
Exposes presence information through HTTP.
ReadMe Changelog Download 1.6.0 Fri Sep 13 00:00:00 UTC 2013 3.9.0 +
Plugin Presence Service
Exposes presence information through HTTP.
ReadMe Changelog Download 1.5.1 Wed Feb 15 00:00:00 UTC 2012 3.7.0 +
Plugin Presence Service
Exposes presence information through HTTP.
ReadMe Changelog Download 1.4.0 Thu Apr 12 00:00:00 UTC 2007 3.3.0 +

The plugins below, so-called SNAPSHOTS, are build automatically by the continuous integration system. They represent the latest development, but are untested.

Snapshots Info File Version Built at Openfire Version
Plugin Presence Service
ReadMe Changelog Download 1.7.4-SNAPSHOT Thu Sep 12 17:10:48 UTC 2024 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.3-SNAPSHOT Thu Sep 12 14:40:28 UTC 2024 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.3-SNAPSHOT Fri Jan 19 14:18:47 UTC 2024 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.2-SNAPSHOT Fri Jan 19 14:09:16 UTC 2024 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.2-SNAPSHOT Wed May 03 19:58:28 UTC 2023 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.2-SNAPSHOT Thu Apr 21 13:35:53 UTC 2022 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.2-SNAPSHOT Wed Oct 27 13:48:09 UTC 2021 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.2-SNAPSHOT Thu Feb 04 08:28:26 UTC 2021 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.2-SNAPSHOT Thu Nov 12 19:05:32 UTC 2020 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.1-SNAPSHOT Thu Nov 12 16:47:01 UTC 2020 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.1-SNAPSHOT Tue Oct 27 14:14:58 UTC 2020 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.1-SNAPSHOT Thu Apr 02 13:34:52 UTC 2020 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.1-SNAPSHOT Tue Feb 11 15:17:04 UTC 2020 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.1-SNAPSHOT Tue Feb 11 14:34:53 UTC 2020 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.1-SNAPSHOT Tue Feb 11 14:19:35 UTC 2020 4.1.1 +
Plugin Presence Service
ReadMe Changelog Download 1.7.1-SNAPSHOT Fri Jan 31 19:29:07 UTC 2020 4.1.1 +