prosody-modules
d194d1012fd3
mod_offline_email/README.markdown
Software / code / prosody-modules
File
mod_offline_email/README.markdown @ 5931:d194d1012fd3
Updating dox for mod_rest. Ideas expressed / clarified:
1) Making clear that mod_rest isn't to be installed under VirtualHosts AND as a component.
2) Understanding some of the implications of this choice:
A) Changes to user authentication
B) How it affects subdomains
3) More consistent use of domain names for clarity.
4) Using different heading sizes to show scope of section.
Essentially, I added all the tidbits I had to clarify in getting this to work in my
own example.
| author | Ben Smith <bens@effortlessis.com> |
|---|---|
| date | Mon, 13 May 2024 13:25:13 -0700 |
| parent | 2876:ea6b5321db50 |
line wrap: on
line source
--- labels: - 'Stage-Beta' summary: Forward offline messages via email ... 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 ============= Option Description ------------------------ ---------------------------------------------------------------------------------------------------------------------------------------------------- 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 Compatibility ============= ----- ------- 0.9 Works ----- ------- Caveats/Todos/Bugs ================== - Currently SMTP sending blocks the whole server. This should not be noticeable 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?
