# HG changeset patch
# User MWild1
# Date 1250901285 0
# Node ID 8e7907dab2a87086ad56f3b2161ac2958872b9be

mod_offline_email: Initial page

diff -r 000000000000 -r 8e7907dab2a8 mod_offline_email.wiki
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_offline_email.wiki	Sat Aug 22 00:34:45 2009 +0000
@@ -0,0 +1,26 @@
+#summary Forward offline messages via email
+#labels email,offline
+
+= Introduction =
+
+Quite often when I am out and about, I'm not able to connect to Jabber. It is usually much more likely I can access my email though (whether via the web, or a mobile client).
+
+For this reason I decided it would be extremely useful to have Jabber messages sent to me while I was offline forwarded to my email inbox.
+
+= Usage =
+
+Simply add "offline_email" to your modules_enabled list. When any user receives a message while they are offline, it will automatically be forwarded via mail to the *same* address as their Jabber ID. e.g. user1@example.com's offline messages will be forwarded to user1@example.com's email inbox.
+
+= Configuration =
+
+|| queue_offline_emails || The number of seconds to buffer messages for, before they are sent as an email. The default is to send each message as it arrives. ||
+|| smtp_server || Address of the SMTP server to send through. Default 'localhost' (recommended, see caveats below) ||
+|| smtp_username   || If set, Prosody will authenticate with the SMTP server before sending (default is no authentication) ||
+|| smtp_password   || The password for the above user (default is none) ||
+|| smtp_from       || Address from which it will appear the emails came. Default is [smtp_username]@[smtp_server], where smtp_username is replaced with 'xmpp' if not set ||
+
+= Caveats/Todos/Bugs =
+
+  * Currently SMTP sending blocks the whole server. This should not be noticable if your mail server is on the same machine as Prosody.
+  * There is not (yet) any way to configure forwarding to an email address other than your JID (idea... use email address in vcard?)
+  * Enable/disable this feature per user?
\ No newline at end of file