Mercurial > prosody-modules
view mod_mam_muc/README.markdown @ 2034:256a5e3591db
mod_pinger: Added from /files/
author | Matthew Wild <mwild1@gmail.com> |
---|---|
date | Tue, 26 Jan 2016 19:15:00 +0000 |
parents | 5e0ee0e4d5b1 |
children | a348c105e05d |
line wrap: on
line source
--- labels: - 'Stage-Alpha' summary: 'XEP-0313: Message Archive Management for MUC' ... Introduction ============ This module logs the conversation of chatrooms running on the server to Prosody's archive storage. To access them you will need a client with support for [XEP-0313: Message Archive Management] or a module such as [mod\_http\_muc\_log]. Usage ===== First copy the module to the prosody plugins directory. Then add "mam\_muc" to your modules\_enabled list: ``` {.lua} Component "conference.example.org" "muc" modules_enabled = { "mam_muc", } ``` And configure it to use an archive-capable storage module: ``` {.lua} storage = { muc_log = "sql"; -- Requires 0.10 or later } ``` See [Prosodys data storage documentation][doc:storage] for more info on how to configure storage for different plugins. Configuration ============= Logging needs to be enabled for each room in the room configuration dialog. ``` {.lua} muc_log_by_default = true; -- Enable logging by default (can be disabled in room config) muc_log_all_rooms = false; -- set to true to force logging of all rooms -- This is the largest number of messages that are allowed to be retrieved in one MAM request. max_archive_query_results = 20; -- This is the largest number of messages that are allowed to be retrieved when joining a room. max_history_messages = 1000; ``` Compatibility ============= ------- ----------------- trunk Works best 0.10 Works partially 0.9 Does not work 0.8 Does not work ------- ----------------- Prosody trunk (after April 2014) has a major rewrite of the MUC module, allowing easier integration. Without this (0.10), some features do not work, such as correct advertising and join/part logging.