view mod_mam.wiki @ 285:a1068d19ef5f

mod_mam: Update reference to the now published XEP
author Kim Alvefur <zash@zash.se>
date Fri, 08 Jun 2012 23:59:28 +0200
parents 0558c44908fe
children 27d80566611b
line wrap: on
line source

#summary XEP-xxxx: 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 =

The server will archive messages passing through, and clients can query their archive.

= Usage =

First copy the module to the prosody plugins directory.

Then add "mam" to your modules_enabled list:
{{{
    modules_enabled = {
                    -- ...
                    "mam",
                    -- ...
		}
}}}

= Configuration =

{{{
	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 built in 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 =
|| 0.8 || Works ||
|| 0.9 || Works ||
|| trunk || Works ||

= TODO =

	* Optimize
	* Use new stanza archive API once it appears
	* Policy enforcing.