view mod_mam_muc/README.markdown @ 1810:2905137cf541

mod_s2s_log_certs/README: Fix link
author Kim Alvefur <zash@zash.se>
date Mon, 31 Aug 2015 17:30:10 +0200
parents 4d73a1a6ba68
children 8de50be756e5
line wrap: on
line source

---
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
  ------- ---------------