|
4000
|
1 # mod_muc_batched_probe
|
|
|
2
|
|
|
3 This module allows you to probe the presences of multiple MUC occupants or members.
|
|
|
4
|
|
|
5 XEP-0045 makes provision for MUC presence probes, which allows an entity to
|
|
|
6 probe for the presence information of a MUC occupant (or offline member).
|
|
|
7
|
|
|
8 See here: https://xmpp.org/extensions/xep-0045.html#bizrules-presence
|
|
|
9
|
|
|
10 This module creates the possibility to probe with a single IQ stanza the
|
|
|
11 presence information of multiple JIDs, instead of having to send out a presence
|
|
|
12 probe stanza per JID.
|
|
|
13
|
|
|
14 The IQ stanza needs to look as follows:
|
|
|
15
|
|
|
16 ```
|
|
|
17 <iq from="hag66@shakespeare.lit/pda"
|
|
|
18 id="zb8q41f4"
|
|
|
19 to="chat.shakespeare.lit"
|
|
|
20 type="get">
|
|
|
21
|
|
|
22 <query xmlns="http://jabber.org/protocol/muc#user">
|
|
|
23 <item jid="hecate@shakespeare.lit"/>
|
|
|
24 <item jid="crone1@shakespeare.lit"/>
|
|
|
25 <item jid="wiccarocks@shakespeare.lit"/>
|
|
|
26 <item jid="hag66@shakespeare.lit"/>
|
|
|
27 </query>
|
|
|
28 </iq>
|
|
|
29 ```
|
|
|
30
|
|
|
31
|
|
|
32
|
|
|
33 ## Configuration
|
|
|
34
|
|
|
35 Under your MUC component, add `muc_batched_probe` to `modules_enabled`
|
|
|
36
|
|
|
37 ```
|
|
|
38 Component "conference.example.org" "muc"
|
|
|
39 modules_enabled = {
|
|
|
40 "muc_batched_probe";
|
|
|
41 }
|
|
|
42 ```
|
|
|
43
|
|
|
44
|
|
|
45 ## Client Support
|
|
|
46
|
|
|
47 Converse.js has a plugin which supports this feature.
|
|
|
48
|
|
|
49 https://www.npmjs.com/package/@converse-plugins/muc-presence-probe
|
