moparisthebest
/
xeps
mirror of https://github.com/moparisthebest/xeps
1
0
Fork 0
Code Issues Releases Wiki Activity

XEP-0045: Add <x/> tag to MUC-PMs

This commit is contained in:
Georg Lukas 2017-02-22 17:01:14 +01:00
parent bbf8cac8c0
commit cde2abe151
1 changed files with 4 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
xep-0045.xml
View File

@ -1903,6 +1903,7 @@
<section2 topic='Sending a Private Message' anchor='privatemessage'> <section2 topic='Sending a Private Message' anchor='privatemessage'>
<p>Since each occupant has its own occupant JID, an occupant can send a "private message" to a selected occupant via the service by sending a message to the intended recipient's occupant JID. The message type SHOULD be "chat" and MUST NOT be "groupchat", but MAY be left unspecified (i.e., a normal message). This privilege is controlled by the "muc#roomconfig_allowpm" room configuration option.</p> <p>Since each occupant has its own occupant JID, an occupant can send a "private message" to a selected occupant via the service by sending a message to the intended recipient's occupant JID. The message type SHOULD be "chat" and MUST NOT be "groupchat", but MAY be left unspecified (i.e., a normal message). This privilege is controlled by the "muc#roomconfig_allowpm" room configuration option.</p>
<p>To allow for proper synchronization of these messages to the user's other clients by &xep0280;, the sending client SHOULD add an &lt;x/&gt; element qualified by the 'http://jabber.org/protocol/muc#user' namespace to the message.</p>
<example caption='Occupant Sends Private Message'><![CDATA[ <example caption='Occupant Sends Private Message'><![CDATA[
<message <message
from='wiccarocks@shakespeare.lit/laptop' from='wiccarocks@shakespeare.lit/laptop'
@ -1910,9 +1911,10 @@
to='coven@chat.shakespeare.lit/firstwitch' to='coven@chat.shakespeare.lit/firstwitch'
type='chat'> type='chat'>
<body>I'll give thee a wind.</body> <body>I'll give thee a wind.</body>
<x xmlns='http://jabber.org/protocol/muc#user' />
</message> </message>
]]></example> ]]></example>
<p>The service is responsible for changing the 'from' address to the sender's occupant JID and delivering the message to the intended recipient's full JID.</p> <p>The service is responsible for changing the 'from' address to the sender's occupant JID and delivering the message to the intended recipient's full JID. The service SHOULD add the &lt;x/&gt; element if the message does not contain it already.</p>
<example caption='Recipient Receives the Private Message'><![CDATA[ <example caption='Recipient Receives the Private Message'><![CDATA[
<message <message
from='coven@chat.shakespeare.lit/firstwitch' from='coven@chat.shakespeare.lit/firstwitch'
@ -1920,6 +1922,7 @@
to='crone1@shakespeare.lit/desktop' to='crone1@shakespeare.lit/desktop'
type='chat'> type='chat'>
<body>I'll give thee a wind.</body> <body>I'll give thee a wind.</body>
<x xmlns='http://jabber.org/protocol/muc#user' />
</message> </message>
]]></example> ]]></example>
<p>If the sender attempts to send a private message of type "groupchat" to a particular occupant, the service MUST refuse to deliver the message (since the recipient's client would expect in-room messages to be of type "groupchat") and return a &badrequest; error to the sender:</p> <p>If the sender attempts to send a private message of type "groupchat" to a particular occupant, the service MUST refuse to deliver the message (since the recipient's client would expect in-room messages to be of type "groupchat") and return a &badrequest; error to the sender:</p>