Diff

mod_onhold/README.markdown @ 1803:4d73a1a6ba68

Convert all wiki pages to Markdown
author Kim Alvefur <zash@zash.se>
date Fri, 28 Aug 2015 18:03:58 +0200
parent 1782:29f3d6b7ad16
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_onhold/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,26 @@
+---
+labels:
+summary: 'Module enabling "on-hold" functionality'
+...
+
+Introduction
+============
+
+Enable mod\_onhold to allow temporarily placing messages from particular
+JIDs "on hold" -- i.e. store them, but do not deliver them until the
+hold status is taken away.
+
+Details
+=======
+
+Right now, it is configured through adding JIDs to a list in
+prosody.cfg.lua. Eventually, more dynamically configurable support will
+be added (i.e. with ad-hoc commands or some such thing).
+
+Simply enable mod\_onhold in your list of modules, and then add a line:
+
+onhold\_jids = { "someone@address.com", "someoneelse@address2.com" }
+
+Until those JIDs are removed, messages from those JIDs will not be
+delivered. Once they are removed and prosody is restarted, they will be
+delivered the next time the user to which they are directed logs on.