#summary Provides a web interface to stored chatroom logs
#labels Stage-Beta

= Introduction =

This module provides a built-in web interface to view chatroom logs stored by [mod_muc_log].

= Installation =

Just copy the folder muc_log_http as it is, into the modules folder of your Prosody installation.

= Configuration Details =

You need to add muc_log_http to your global modules_enabled, and the configuration options similarly must be put into your Host "`*`" section.

{{{
Host "*"
   modules_enabled = {
       .....
       "muc_log_http";
       .....
   }

   muc_log_http = {
       http_port = 5290; -- default is 5290
       showJoin = false; -- default is true
       showStatus = false; -- default is true
       theme = "prosody"; -- default is theme "prosody"
   }
}}}

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

The web interface would then be reachable at the address:
{{{
http://example.com:5290/muc_log/
}}}


= TODO =
  * Log bans correctly
  * Let the admin choose to enable logging via room config
  * Quota ~ per day ?!
  * Testing testing :)