From d1ed7652fdb2ec9257405de045b208d13cecf3a2 Mon Sep 17 00:00:00 2001 From: Steve Kille Date: Mon, 19 Sep 2016 14:38:33 +0100 Subject: [PATCH] Sort Subject Setting --- xep-0369.xml | 58 +++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 53 insertions(+), 5 deletions(-) diff --git a/xep-0369.xml b/xep-0369.xml index db353ddb..e64776e8 100644 --- a/xep-0369.xml +++ b/xep-0369.xml @@ -290,7 +290,7 @@

Private Messages are not stored in the messages node.

-

The subject node publishes the current subject of channel. Subject history is stored in MAM. A single item is stored in this node at a time which MUST contain a "text" element and MAY contain additional text elements. Where multiple text elements are provided, each MUST posses an xml:lang attribute that describes the natural language of the subject. Users subscribe to this node to receive subject updates. The following example shows the format of a item in the subject node.

+

The subject node publishes the current subject of channel. Subject history is stored in MAM. A single item is stored in this node at a time which MUST contain a "text" element and MAY contain additional text elements. Where multiple text elements are provided, each MUST posses an xml:lang attribute that describes the natural language of the subject. The following example shows the format of a item in the subject node.

@@ -298,10 +298,13 @@ Wie benutzt man Kröten ]]> +

+ When a user subscribes to the Subject Node, this will cause the channel to send Subject messages to the user through the MIX Proxy. This is done on initial user subscription and on subject change. Clients MAY directly read the channel subject from the Subject Node using PubSub. +

Each channel participant is represented as an item of the 'urn:xmpp:mix:nodes:participants' channel node. Each item is named by the bare proxy JID of the participant. For example 'coven+123456@mix.shakespeare.example' might name the node item associated with participant 'hag66@shakespeare.example'. The nick associated with the user is mandatory and is stored in the item. The nick for each channel participant MUST be different to the nick of other participants. - This node may be subscribed to for jid-visible channels that permit subscription to this node - this will allow users to see changes to channel membership. + This node MAY be subscribed to for jid-visible channels that permit subscription to this node - this will allow users to see changes to channel membership.

If the Participants Node is not used, information on channel participants is not shared.

]]> - + + +

The Information Node contains various information about the channel that may be useful to the user. This can be read by the user.

+

AUTHOR'S NOTE: Define new protocol. Add example

+ +

+ Online clients in the channel are determined from the presence node. Participants in the channel are determined from the "urn:xmpp:mix:nodes:participants" node which will give proxy JID and nick. The jidmap node is used to map to real JIDs.

-

AUTHOR'S NOTE: Add example

+

AUTHOR'S NOTE: Define new protocol. Add example

 @@ -920,7 +929,7 @@ Harpier cries: 'tis time, 'tis time. ]]> -

The message comes from the channel as a standard groupchat message, compatible with MUC. Messages are sent directly and do not use the MIX Proxy.

+

The message comes from the channel as a standard groupchat message, compatible with MUC. Messages are sent directly to the channel and do not use the MIX Proxy. Messages reflected back by the channel are addressed to the user's MIX Proxy, coming from the Full Proxy JID of the message sender.

AUTHOR NOTE AND QUESTION: Message id coming back is different in example. This is because the reflected message uses MAM ID, which seems helpful. However, it makes it harder for sender to correlate reflections. Need to be explicit as to compliant behaviour. Input as to whether the ID should change is solicited. A more complex option would be to include both IDs in some way.

 + + + +

+ Setting the subject for a channel follows a similar procedure to sending a message. An XMPP client will send a message setting the subject directly to the MIX channel. +

+ + + + How to use Toads + Wie benutzt man Kröten + + + +]]> +

+ This message is received by the MIX channel, which will set the Subject Node for the channel, and then distribute the message to participants that are subscribed to the Subject Node, with the message addressed to the MIX Proxy. +

+ + + + How to use Toads + Wie benutzt man Kröten + + + +]]> +

+ When a new Participant joins a channel and subscribes to the Subject Node, the channel MUST send to the user's MIX Proxy a message with the current subject. An XMPP Client MAY directly read the Subject node using &xep0060;. +

+

When a channel member invites another user to join a channel, a sequence of steps are followed.