view mod_smacks_noerror/README.markdown @ 2876:ea6b5321db50

README files: Fix typos
author Kim Alvefur <zash@zash.se>
date Sun, 04 Feb 2018 16:05:27 +0100
parents d1e975c24545
children f35b2b76df6d
line wrap: on
line source

---
labels:
- 'Stage-Alpha'
summary: Monkeypatch mod_smacks to silently discard unacked message stanzas when a hibernation times out
...

Introduction
============

By default mod_smacks sends back error stanzas for every unacked message
stanza when the hibernation times out.
This leads to "message not delivered" errors displayed in clients.

When you are certain that *all* your clients use MAM, this is unnecessary and
confuses users (the message will eventually be delivered via MAM).

This module therefore monkeypatches mod_smacks to silently drop those
unacked message stanzas instead of sending error replies.
Unacked iq stanzas are still answered with an error reply though.

Warning
=======

You most certainly *should not* use this module if you cannot be certain
that *all* your clients support and use MAM!

Compatibility
=============

  ----- -------------------------------------------------------------------
  trunk Untested
  0.10  Works
  0.9   Untested but should work
  0.8   Untested but should work, use version [7693724881b3] of mod_smacks
  ----- -------------------------------------------------------------------

[7693724881b3]: //hg.prosody.im/prosody-modules/raw-file/7693724881b3/mod_smacks/mod_smacks.lua