# HG changeset patch
# User Kim Alvefur <zash@zash.se>
# Date 1416315816 -3600
# Node ID 278feae4f92e0ed78225f6d41465b719e6def77c
# Parent  800a801a5f715035a284ed468d37817621374abe
add page

diff -r 800a801a5f71 -r 278feae4f92e mod_mam_muc.wiki
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_mam_muc.wiki	Tue Nov 18 14:03:36 2014 +0100
@@ -0,0 +1,52 @@
+#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 ||