diff --git a/xep-0249.xml b/xep-0249.xml index 0e0fa693..0dadd440 100644 --- a/xep-0249.xml +++ b/xep-0249.xml @@ -20,8 +20,14 @@ - NOT_YET_ASSIGNED + x-conference &stpeter; + + 0.2 + 2009-03-30 + psa +

Added optional reason attribute for feature parity with XEP-0045.

+
0.1 2008-09-03 @@ -61,20 +67,22 @@ -

&xep0045; defines a protocol for groupchat over XMPP. That specification includes a method for inviting a contact to a room, where the invitation is mediated by the room itself: the user sends the invitation to the room, which in turn sends it to the contact. Unfortunately, a mediated invitation might not be delivered to the contact, for example if the contact blocks communication with entities not in its roster as specified in &xep0016;. As privacy lists have become more common, MUC invitations have been increasingly blocked at the server side, resulting in an undesirable user experience. Therefore, this specification defines a method for sending an invitation directly from the user to the contact, which re-uses the original 'jabber:x:conference' namespace in use before XEP-0045 was written.

+

&xep0045; defines a protocol for groupchat over XMPP. That specification includes a method for inviting a contact to a room, where the invitation is mediated by the room itself: the user sends the invitation to the room, which in turn sends it to the contact. Unfortunately, a mediated invitation might not be delivered to the contact, for example if the contact blocks communication with entities not in its roster as specified in &xep0016;. As privacy lists have become more common, MUC invitations have been increasingly blocked at the server side, resulting in an undesirable user experience. Therefore, this specification defines a method for sending an invitation directly from the user to the contact, which re-uses the original 'jabber:x:conference' namespace in use before XEP-0045 was written (with the addition of a 'reason' attribute for the sake of feature parity with XEP-0045).

-

A user invites a contact to a room by sending a &MESSAGE; stanza containing only an <invitation/> element qualified by the 'jabber:x:conference' namespace &NSNOTE;.

+

A user invites a contact to a room by sending a &MESSAGE; stanza containing only an <invitation/> element qualified by the 'jabber:x:conference' namespace.

+ jid='darkcave@macbeth.shakespeare.lit' + reason='Hey Hecate, this is the place for all good witches!'/> ]]> -

The 'jid' attribute is REQUIRED.

+

The 'jid' attribute, which is REQUIRED, specifies the address of the groupchat room.

+

The 'reason' attribute, which is OPTIONAL, specifies a human-readable purpose for the invitation.

Upon receiving a direct invitation, the contact's client SHOULD present the invitation to the contact so that the contact can accept it or decline it. If the contact accepts the invitation, the contact's client shall join the room as described in XEP-0045. If the contact declines the invitation, it shall silently discard the invitation.

@@ -94,9 +102,7 @@ to='crone1@shakespeare.lit/desktop' type='result'> - ... - ... ]]> @@ -109,7 +115,7 @@ -

To follow.

+

There are no known security concerns related to this protocol.

@@ -118,7 +124,7 @@ -

Upon advancement of this specification to a status of Draft, the ®ISTRAR; shall add 'jabber:x:conference' to its registry of protocol namespaces.

+

Upon advancement of this specification to a status of Draft, the ®ISTRAR; shall add 'jabber:x:conference' to its registry of protocol namespaces at &NAMESPACES;.

@@ -140,6 +146,10 @@ name='jid' type='xs:string' use='required'/> + @@ -155,4 +165,7 @@ ]]>
+ +

Thanks to Joe Hildebrand for his feedback.

+