Mercurial > prosody-wiki
annotate mod_mam.wiki @ 401:f7bca760e9b5
mod_watchuntrusted: Created a wiki page describing this module
author | thijsalkemade@gmail.com |
---|---|
date | Wed, 11 Sep 2013 23:32:56 +0000 |
parents | 6f559c056dc8 |
children | 56912134d96b |
rev | line source |
---|---|
296
fc11f3985d9b
It got published, and a number already
Kim Alvefur <zash@zash.se>
parents:
286
diff
changeset
|
1 #summary XEP-0313: Message Archive Management (Really) |
249 | 2 #labels Stage-Alpha |
3 | |
4 = Introduction = | |
5 | |
285
a1068d19ef5f
mod_mam: Update reference to the now published XEP
Kim Alvefur <zash@zash.se>
parents:
284
diff
changeset
|
6 Implementation of [http://xmpp.org/extensions/xep-0313.html XEP-0313: Message Archive Management]. Like [mod_archive] but much simpler. |
249 | 7 |
8 = Details = | |
9 | |
286
27d80566611b
mod_mam: Re-write the Details section to be more accurate with current behaviour
Kim Alvefur <zash@zash.se>
parents:
285
diff
changeset
|
10 This module will archive all messages that match the simple rules setup by the user, and allow the user to access this archive. |
249 | 11 |
12 = Usage = | |
13 | |
14 First copy the module to the prosody plugins directory. | |
15 | |
16 Then add "mam" to your modules_enabled list: | |
17 {{{ | |
387 | 18 modules_enabled = { |
19 -- ... | |
20 "mam", | |
21 -- ... | |
22 } | |
23 storage = { | |
24 archive2 = "sql2"; | |
25 } | |
249 | 26 }}} |
27 | |
28 = Configuration = | |
29 | |
259
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
30 {{{ |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
31 default_archive_policy = true or false or "roster"; |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
32 }}} |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
33 |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
34 This controls what messages are archived if the user hasn't set a matching rule, or another personal default. |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
35 |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
36 * `false` means to store no messages. This is the built in default. |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
37 * `"roster"` means to store messages to/from contacts in the users roster. |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
38 * `true` means is to store all messages. |
6fb8d4252b73
Update mod_mam page with default³ info
Kim Alvefur <zash@zash.se>
parents:
251
diff
changeset
|
39 |
284
0558c44908fe
mod_mam: Something about max_archive_query_results
Kim Alvefur <zash@zash.se>
parents:
260
diff
changeset
|
40 {{{ |
0558c44908fe
mod_mam: Something about max_archive_query_results
Kim Alvefur <zash@zash.se>
parents:
260
diff
changeset
|
41 max_archive_query_results = 50; |
0558c44908fe
mod_mam: Something about max_archive_query_results
Kim Alvefur <zash@zash.se>
parents:
260
diff
changeset
|
42 }}} |
0558c44908fe
mod_mam: Something about max_archive_query_results
Kim Alvefur <zash@zash.se>
parents:
260
diff
changeset
|
43 |
0558c44908fe
mod_mam: Something about max_archive_query_results
Kim Alvefur <zash@zash.se>
parents:
260
diff
changeset
|
44 This is the largest number of messages that are allowed to be retrieved in one request. |
0558c44908fe
mod_mam: Something about max_archive_query_results
Kim Alvefur <zash@zash.se>
parents:
260
diff
changeset
|
45 |
249 | 46 = Compatibility = |
260
ca66f14190ac
Brief testing suggests mod_mam works with 0.9
Kim Alvefur <zash@zash.se>
parents:
259
diff
changeset
|
47 || trunk || Works || |
387 | 48 || 0.9 || Does not work || |
49 || 0.8 || Does not work || |