prosody-modules
tip
mod_push2/README.md
Software / code / prosody-modules
Comparison
mod_push2/README.md @ 6211:750d64c47ec6 draft default tip
Merge
| author | Trần H. Trung <xmpp:trần.h.trung@trung.fun> |
|---|---|
| date | Tue, 18 Mar 2025 00:31:36 +0700 |
| parent | 6109:446c305475b4 |
comparison
equal
deleted
inserted
replaced
| 6210:24316a399978 | 6211:750d64c47ec6 |
|---|---|
| 1 --- | |
| 2 labels: | |
| 3 - Stage-Alpha | |
| 4 summary: 'Push 2.0 - New Cloud-Notify' | |
| 5 --- | |
| 6 | |
| 7 The way forward for push notifications? You are probably looking for | |
| 8 `mod_cloud_notify` for now though | |
| 9 | |
| 10 See also [push2.md](https://hg.prosody.im/prosody-modules/file/tip/mod_push2/push2.md) | |
| 11 | |
| 12 Configuration | |
| 13 ============= | |
| 14 | |
| 15 Option Default Description | |
| 16 ------------------------------------ ----------------- ------------------------------------------------------------------------------------------------------------------- | |
| 17 `contact_uri` xmpp:server.tld Contact information for the server operator (usually as a `mailto:` URI is preferred) | |
| 18 `push_max_hibernation_timeout` `259200` (72h) Number of seconds to extend the smacks timeout if no push was triggered yet (default: 72 hours) | |
| 19 | |
| 20 Internal design notes | |
| 21 ===================== | |
| 22 | |
| 23 App servers are notified about offline messages, messages stored by [mod_mam] | |
| 24 or messages waiting in the smacks queue. | |
| 25 | |
| 26 To cooperate with [mod_smacks] this module consumes some events: | |
| 27 `smacks-ack-delayed`, `smacks-hibernation-start` and `smacks-hibernation-end`. | |
| 28 These events allow this module to send out notifications for messages received | |
| 29 while the session is hibernated by [mod_smacks] or even when smacks | |
| 30 acknowledgements for messages are delayed by a certain amount of seconds | |
| 31 configurable with the [mod_smacks] setting `smacks_max_ack_delay`. | |
| 32 | |
| 33 The `smacks_max_ack_delay` setting allows to send out notifications to clients | |
| 34 which aren't already in smacks hibernation state (because the read timeout or | |
| 35 connection close didn't already happen) but also aren't responding to acknowledgement | |
| 36 request in a timely manner. This setting thus allows conversations to be smoother | |
| 37 under such circumstances. | |
| 38 | |
| 39 Compatibility | |
| 40 ============= | |
| 41 | |
| 42 **Note:** This module should be used with Lua 5.3 and higher. | |
| 43 | |
| 44 ----- ---------------------- | |
| 45 trunk Works | |
| 46 0.12 Does probably not work | |
| 47 ----- ---------------------- |
