4004
|
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 |