diff mod_csi_battery_saver/README.markdown @ 3633:6b0db0f2d57a

mod_csi_battery_saver: add compatibility with mod_csi_muc_priorities, make queue length configurable and update README
author tmolitor <thilo@eightysoft.de>
date Tue, 30 Jul 2019 01:46:57 +0200
parents d1aa5fc005f7
children
line wrap: on
line diff
--- a/mod_csi_battery_saver/README.markdown	Mon Jul 29 16:10:09 2019 +0200
+++ b/mod_csi_battery_saver/README.markdown	Tue Jul 30 01:46:57 2019 +0200
@@ -1,7 +1,5 @@
 ---
 description: CSI module to save battery on mobile devices
-labels:
-- 'Stage-Alpha'
 ---
 
 Please use this module instead of [mod_csi_pump] if you want timestamping,
@@ -18,28 +16,37 @@
 bring up their radio for unimportant stanzas.
 
 `IQ` stanzas, and `message` stanzas containing a body or being encrypted,
-chat markers (see [XEP-0333]) and all nonzas are considered important.
+chat markers (see [XEP-0333]) and all *nonzas* are considered important.
 If the config option `csi_battery_saver_filter_muc` is set to true,
 groupchat messages must set a subject or have the user's username or nickname
-in their messages (or be encrypted) to count as "important", if this option
-is set to false (default), all groupchat messages having a body
-or being encrypted are considered "important".
+mentioned in the messages (or be encrypted) to count as "important".
+**Warning:** you should only set this to true if your users can live with
+groupchat messages being delayed several minutes!
+On the other hand if this option is set to false (*default*),
+all groupchat messages having a body or being encrypted are considered "important".
+In this case [mod_csi_muc_priorities] can be used to let user configure per groupchat
+which of them are important for them (e.g. all messages having a body are important)
+and which are not (e.g. only mentions and own messages are important).
+If users don't change their settings, [mod_csi_muc_priorities] handles all groupchats
+as important (see its docs for more information).
 `Presence` stanzas are always considered not "important".
 
 All buffered stanzas that allow timestamping are properly stamped to
 reflect their original send time, see [XEP-0203].
 
 Use with other CSI plugins such as [mod_throttle_presence],
-[mod_filter_chatstates] or [mod_csi_pump] is *not* supported.
+[mod_filter_chatstates], [mod_csi_simple] or [mod_csi_pump] is **not** supported.
+Usage of [mod_csi_muc_priorities] is allowed (see configuration).
 
-The internal stanza buffer of this module is hardcoded to 100 stanzas.
+*Hint:* [mod_csi_muc_priorities] needs [mod_track_muc_joins] to function properly.
 
 Configuration
 =============
 
-  Option                              Default           Description
-  ----------------------------------  ---------- -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
-  `csi_battery_saver_filter_muc`      false      Controls whether all muc messages having a body should be considered as important (false) or only such containing the user's room nic (true). Warning: you should only set this to true if your users can live with muc messages being delayed several minutes. 
+  Option                                  Default           Description
+  ----------------------------------      ---------- -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
+  `csi_battery_saver_filter_muc`          false      Controls whether all MUC messages having a body should be considered as important as long as [mod_csi_muc_priorities] doesn't configure them to be **not** important (false) or only such containing the user's room nic (true). **WARNING:** you should only set this to true if your users can live with muc messages being delayed several minutes.
+  `csi_battery_saver_queue_size`          256        Size of the stanza buffer used for the queue (if the queue is full a flush will be forced)
 
 
 [f70c02c14161]: //hg.prosody.im/prosody-modules/raw-file/f70c02c14161/mod_smacks/mod_smacks.lua
\ No newline at end of file