Diff

mod_mam_muc/README.markdown @ 1803:4d73a1a6ba68

Convert all wiki pages to Markdown
author Kim Alvefur <zash@zash.se>
date Fri, 28 Aug 2015 18:03:58 +0200
parent 1782:29f3d6b7ad16
child 1820:8de50be756e5
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_mam_muc/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,61 @@
+---
+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](http://xmpp.org/extensions/xep-0313.html) or a module such
+as [mod\_http\_muc\_log](mod_http_muc_log.md).
+
+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 [Prosodys data storage
+documentation](https://prosody.im/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.
+
+        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
+  ------- ---------------