jabber:x:event
Message events allow clients and servers alike to add information about the receipt and handling of messages at various stages of delivery. There are currently four types of events supported in this namespace:
- Composing
The composing event, represented by the
<composing/>tag within the<x/>extension qualified by thejabber:x:eventnamespace, can be set by clients and signifies that the user is composing a reply to the message just sent.- Delivered
When a message is received by a client, it can set the
<delivered/>flag to signify that the message has been received.- Displayed
The displayed event is used to indicate that the message sent has been displayed to the user. This event is set, using the
<displayed/>tag, by clients.- Offline
When a message recipient is not connected, the JSM module mod_offline will store the message and send it to the recipient when she is next available. This offline storage event can be set by the server, using the
<offline/>tag, to notify the sender that the message has been stored offline.
The
<composing/>,
<delivered/>, and
<displayed/> events are client events
and are appropriate to be set only by the client. The
<offline/> event is a server event and
appropriate to be set only by the server.
In all cases, the events are set only if the message originator requests
that they are. Adding a jabber:x:event extension
to a message like this:
SEND: <message to='sabine@yak' id='M31'> <subject>Where are you?</subject> <body>Let me know ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access