mod_muc_log/README.wiki
changeset 1786 29f3d6b7ad16
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_muc_log/README.wiki	Mon Aug 24 16:43:56 2015 +0200
@@ -0,0 +1,34 @@
+#summary Log chatroom messages to disk
+#labels Stage-Beta
+
+= Introduction =
+
+This module logs the conversation of chatrooms running on the server to Prosody's data store. To view them you will need a module such as [mod_muc_log_http].
+
+= Details =
+
+mod_muc_log must be loaded individually for the components that need it. Assuming you have a MUC component already running on conference.example.org then you can add muc_log to it like so:
+
+{{{
+Component "conference.example.org" "muc"
+   modules_enabled = {
+      "muc_log";
+   }
+}}}
+
+Logging is not enabled by default.  In 0.9+ logging can be enabled per room in the room config form.
+
+To enable logging in older versions, or to enable logging by default for all rooms, set
+
+{{{
+muc_log_by_default = true -- Log all rooms by default
+}}}
+
+
+= Compatibility =
+|| 0.6 || Works ||
+|| 0.7 || Works ||
+|| 0.8 || Works ||
+|| 0.9 || Works ||
+
+*Note* that per-room configuration only works in 0.9+.