Mercurial > prosody-modules
annotate mod_muc_restrict_nick/README.markdown @ 4942:e7b9bc629ecc
mod_rest: Add special handling to catch MAM results from remote hosts
Makes MAM queries to remote hosts works.
As the comment says, MAM results from users' local archives or local
MUCs are returned via origin.send() which is provided in the event and
thus already worked. Results from remote hosts go via normal stanza
routing and events, which need this extra handling to catch.
This pattern of iq-set, message+, iq-result is generally limited to MAM.
Closest similar thing might be MUC join, but to really handle that you
would need the webhook callback mechanism.
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 16 May 2022 19:47:09 +0200 |
parents | e7b126161e7b |
children |
rev | line source |
---|---|
4588
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
1 --- |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
2 labels: |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
3 - 'Stage-Alpha' |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
4 summary: 'Require MUC occupant nicknames to match a specific pattern' |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
5 --- |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
6 |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
7 Introduction |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
8 ============ |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
9 |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
10 This checks the nickname of a joining user against a configurable |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
11 [Lua pattern](https://www.lua.org/manual/5.2/manual.html#6.4.1), and prevents |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
12 them from joining if it does not match. |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
13 |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
14 Configuration |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
15 ============= |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
16 |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
17 There is a single configuration option, `muc_restrict_nick_pattern` and the |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
18 default is `"^%w+$"` - i.e. allow only alphanumeric characters in nicknames. |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
19 |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
20 Compatibility |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
21 ============= |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
22 |
e7b126161e7b
mod_muc_restrict_nick: New module to restrict MUC occupant nicknames
Matthew Wild <mwild1@gmail.com>
parents:
diff
changeset
|
23 Requires Prosody 0.11 or higher. |