view mod_mam_adhoc/README.markdown @ 4298:020dd0a59f1f

mod_muc_markers: Add option for @id rewriting, default off (may break some clients) XEP-0333 was updated to clarify that stanza-id should be used instead of the 'id' attribute when in a MUC. Some clients still use the id attribute, which is why we were rewriting it. Rewriting is bad because mod_muc advertises stable_id, indicating that Prosody does *not* rewrite ids. Recent versions of Conversations actually depend on this being true. All clients should migrate to using stanza-id for markers. See XEP-0333.
author Matthew Wild <mwild1@gmail.com>
date Mon, 14 Dec 2020 12:09:25 +0000
parents 8de50be756e5
children
line wrap: on
line source

---
labels:
- 'Stage-Alpha'
summary: 'Ad-hoc interface to Message Archive Management Settings'
...

Introduction
============

This module complements mod\_mam by allowing clients to change archiving
preferences through an Ad-hoc command.

Details
=======

When enabled, an "Archive Settings" command should appear in the list of
Ad-hoc commands available. This allows the user to change default policy
(always, never, roster) and which JIDs to always store or never store.

Usage
=====

First copy the module to the prosody plugins directory.

Then add "mam\_adhoc" to your modules\_enabled list:

``` {.lua}
modules_enabled = {
  -- ...
    "mam",
  "mam_adhoc",
  -- ...
}
```