#summary Module which logs muc conversations to a file
#labels Stage-Beta

= Introduction =

This module logs the conversation of muc running on this server to a daily changing file.
There is a file per room.

= Details =

Here is a example config with just the muclogging parts added to the right sections:
{{{
component "rooms.example.com" "muc"
   modules_enabled = {
       "muc_log";
   }

   muc_log = {
       http_port = 5290;
       showJoin = false; -- default is true
       showStatus = false; -- default is true
    }
}}}

The http server part would then be reachable at the url:
{{{
http://example.com:5290/muc_log/
}}}

showJoin sets the default for showing joins or leaves.
showStatus sets the default for showing status changes.

= TODO =
  * log/output bans correctly
  * show a nice errormessage when lfs is not installed
  * let the admin choose to enable logging via room config
  * testing testing