#summary XEP-0313: Message Archive Management for MUC
#labels Stage-Alpha
= 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
[http://xmpp.org/extensions/xep-0313.html 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:
{{{
Component "conference.example.org" "muc"
modules_enabled = {
"mam_muc",
}
storage = {
-- This makes mod_mam_muc use the sql2 storage backend (others will use internal)
-- which at the time of this writing is the only one supporting stanza archives
muc_log = "sql2";
}
}}}
See [https://prosody.im/doc/storage Prosodys data storage documentation]
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.
{{{
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 ||
|| 0.10 || Works ||
|| 0.9 || Does not work ||
|| 0.8 || Does not work ||