view mod_mam.wiki @ 414:dc20cb1bb874

add some labels
author Kim Alvefur <zash@zash.se>
date Fri, 17 Jan 2014 00:52:01 +0100
parents 56912134d96b
children b2ebc4473c4c
line wrap: on
line source

#summary XEP-0313: Message Archive Management (Really)
#labels Stage-Alpha

= Introduction =

Implementation of [http://xmpp.org/extensions/xep-0313.html XEP-0313: Message Archive Management]. Like [mod_archive] but much simpler.

= 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 = {
	archive2 = "sql2";
}
}}}

= Configuration =

The MAM protocol includes a method of changing preferecens 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 = true or false 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 = 50;
}}}

This is the largest number of messages that are allowed to be retrieved in one request.

= Compatibility =
|| trunk || Works ||
|| 0.10 || Works ||
|| 0.9 || Does not work ||
|| 0.8 || Does not work ||