#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:
{{{
Host "*"
   modules_enabled = {
       .....
       "muc_log";
       .....
   }

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

component "rooms.example.com" "muc"
   logging = 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