File

mod_csi_muc_priorities/README.md @ 6057:cc665f343690

mod_firewall: SUBSCRIBED: Flip subscription check to match documentation The documentation claims that this condition checks whether the recipient is subscribed to the sender. However, it was using the wrong method, and actually checking whether the sender was subscribed to the recipient. A quick poll of folk suggested that the documentation's approach is the right one, so this should fix the code to match the documentation. This should also fix the bundled anti-spam rules from blocking presence from JIDs that you subscribe do (but don't have a mutual subscription with).
author Matthew Wild <mwild1@gmail.com>
date Fri, 22 Nov 2024 13:50:48 +0000
parent 6003:fe081789f7b5
child 6211:750d64c47ec6
line wrap: on
line source

# Introduction

This module lets users specify which of the group chats they are in are
more or less important. This influences when
[mod_csi_simple][doc:modules:mod_csi_simple] decides to send
stanzas vs waiting until there is more to send. Users in many large
public channels might benefit from this.

# Configuration

The module is configured via ad-hoc an command called *Configure group
chat priorities* that should appear in the menus of compatible clients.

The command presents a form that accepts a list of XMPP addresses.
Currently you can specify channels as lower priority (which is suitable
for e.g. noisy public channels) or higher priority (which is suitable
for e.g. small private channels where immediate message delivery is
desired).  You can also specify whether mucs default to lower priority
or not.

A message of type groupchat from an address in the low priority list will
not be considered important enough to send it to an inactive client,
unless it is from the current user or mentions of their nickname.
**Note** that mention support require the separate module
[mod_track_muc_joins] to also be loaded.

``` {.lua}
modules_enabled = {
    -- other modules etc

    "csi_simple",
    "csi_muc_priorities",
    "track_muc_joins", -- optional
}
```