%ents; ]>
Extensible Status Conditions for Multi-User Chat This document defines an extensible format for status conditions in Multi-User Chat, similar to the error format used in the core of XMPP. &LEGALNOTICE; 0306 Deferred Standards Track Standards RFC 6120 XEP-0045 N/A &stpeter; 0.2.1 2016-06-07 mp (XEP Editor: ssw)

Fix broken example XML.

 0.2 2011-12-14 psa

Modified format to make it more backward compatible; incremented protocol namespace.

 0.1 2011-08-26 psa

Initial published version.

 0.0.1 2011-08-12 psa

Rough draft.

Traditionally, &xep0045; has used numerical status codes similar to those used in HTTP and SMTP. Numerical codes were deprecated in the core of XMPP by &rfc3920; and are no longer even defined in the core schemas provided in &rfc6120; (see also &xep0086;). In an effort to modernize the Multi-User Chat (MUC) protocol, this document defines an extensible format for status conditions in MUC.

XML elements describing status conditions defined by this specification SHALL be qualified by the 'urn:xmpp:muc:conditions:1' namespace.

The structure is as follows:

[OPTIONAL descriptive text] [OPTIONAL application-specific condition element] [] [OPTIONAL application-specific condition element or elements] ]]>

That is, any <status/> element qualified by the existing http://jabber.org/protocol/muc#user' namespace (from XEP-0045) MAY contain one or more condition elements defined in this document (each of which MAY contain a human-readable <text/> element and MAY contain an application-specific condition element) and MAY contain one or more application-specific condition elements.

An example follows.

]]>

The following table maps the existing numerical status codes (registered with the ®ISTRAR; at &MUCSTATUS;) to XML elements.

Code Element
100 <realjid-public/>
101 <affiliation-changed/>
102 <unavailable-shown/>
103 <unavailable-not-shown/>
104 <configuration-changed/>
110 <self-presence/>
170 <logging-enabled/>
171 <logging-disabled/>
172 <non-anonymous/>
173 <semi-anonymous/>
174 <fully-anonymous/>
201 <room-created/>
210 <nick-assigned/>
301 <banned/>
303 <new-nick/>
307 <kicked/>
321 <removed-affiliation/>
322 <removed-membership/>
332 <removed-shutdown/>

The security considerations of XEP-0045 apply.

This document requires no interaction with &IANA;.

This specification defines the following XML namespace:

  • urn:xmpp:muc:conditions:1

Upon advancement of this specification from a status of Experimental to a status of Draft, the ®ISTRAR; shall add the foregoing namespace to the registry located at &NAMESPACES;, as described in Section 4 of &xep0053;.

 &NSVER;

The XMPP Registrar is requested to add the elements defined in this specification to the existing registry for MUC status codes at &MUCSTATUS;.

 ]]>

Thanks to Dave Cridland and Ralph Meijer for their feedback.