Diff

mod_mam/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 1801:5abf61915ab4
child 1804:3228fb928a93
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_mam/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,79 @@
+---
+labels:
+- 'Stage-Beta'
+summary: 'XEP-0313: Message Archive Management'
+...
+
+Introduction
+============
+
+Implementation of [XEP-0313: Message Archive
+Management](http://xmpp.org/extensions/xep-0313.html).
+
+Details
+=======
+
+This module will archive all messages that match the simple rules setup
+by the user, and allow the user to access this archive.
+
+Usage
+=====
+
+First copy the module to the prosody plugins directory.
+
+Then add "mam" to your modules\_enabled list:
+
+    modules_enabled = {
+        -- ...
+        "mam",
+        -- ...
+    }
+
+Storage backend
+===============
+
+mod\_mam uses the store "archive2". See [Prosodys data storage
+documentation](https://prosody.im/doc/storage) for information on how to
+configure storage.
+
+For example, to use mod\_storage\_sql2:
+
+    storage = {
+        archive2 = "sql2";
+    }
+
+Configuration
+=============
+
+The MAM protocol includes a method of changing preferences regarding
+what messages should be stored. This allows users to enable or disable
+archiving by default, and set rules for specific contacts. This module
+will log no messages by default, for privacy concerns. If you decide to
+change this, you should inform your users.
+
+        default_archive_policy = false -- other options are true or "roster";
+
+This controls what messages are archived if the user hasn't set a
+matching rule, or another personal default.
+
+-   `false` means to store no messages. This is the default.
+-   `"roster"` means to store messages to/from contacts in the users
+    roster.
+-   `true` means is to store all messages.
+
+<!-- -->
+
+        max_archive_query_results = 20;
+
+This is the largest number of messages that are allowed to be retrieved
+in one request.
+
+Compatibility
+=============
+
+  ------- --------------------------------------------------------------------------------------
+  trunk   Works
+  0.10    Works, requires a storage driver with archive support, eg mod\_storage\_sql2 in 0.10
+  0.9     Unsupported
+  0.8     Does not work
+  ------- --------------------------------------------------------------------------------------