mod_smacks_noerror/README.markdown

   1 ---
   2 labels:
   3 - 'Stage-Alpha'
   4 summary: Monkeypatch mod_smacks to silently discard unacked message stanzas when a hibernation times out
   5 ...
   6
   7 Introduction
   8 ============
   9
  10 By default mod_smacks sends back error stanzas for every unacked message
  11 stanza when the hibernation times out.
  12 This leads to "message not delivered" errors displayed in clients.
  13
  14 When you are certain that *all* your clients use MAM, this is unnecessary and
  15 confuses users (the message will eventually be delivered via MAM).
  16
  17 This module therefore monkeypatches mod_smacks to silently drop those
  18 unacked message stanzas instead of sending error replies.
  19 Unacked iq stanzas are still answered with an error reply though.
  20
  21 If you disable mod_offline, this module will also silence "message not delivered"
  22 error messages that will otherwise be generated when prosody would normally
  23 store offline message but can't do this because of disabled mod_offline.
  24 If mod_offline is *not* disabled this module will not change offline storage
  25 behaviour at all.
  26
  27 Warning
  28 =======
  29
  30 You most certainly *should not* use this module if you cannot be certain
  31 that *all* your clients support and use MAM!
  32
  33 Compatibility
  34 =============
  35
  36   ----- -------------------------------------------------------------------
  37   trunk Untested
  38   0.10  Works
  39   0.9   Untested but should work
  40   0.8   Untested but should work, use version [7693724881b3] of mod_smacks
  41   ----- -------------------------------------------------------------------
  42
  43 [7693724881b3]: //hg.prosody.im/prosody-modules/raw-file/7693724881b3/mod_smacks/mod_smacks.lua