Mercurial > prosody-modules
view mod_alias/README.markdown @ 4876:0f5f2d4475b9
mod_http_xep227: Add support for import via APIs rather than direct store manipulation
In particular this transitions PEP nodes and data to be imported via mod_pep's
APIs, fixing issues with importing at runtime while PEP data may already be
live in RAM.
Next obvious candidate for this approach is rosters, so clients get immediate
roster pushes and other special handling (such as emitting subscribes to reach
the desired subscription state).
author | Matthew Wild <mwild1@gmail.com> |
---|---|
date | Tue, 18 Jan 2022 17:01:18 +0000 |
parents | ea6b5321db50 |
children |
line wrap: on
line source
--- summary: Point alias accounts or domains to correct XMPP user ... Introduction ============ This module allows you to set up aliases that alert people who try to contact them or add them to their roster what your actual JID is. This is useful for changing JIDs, or just in the case where you own both example.com and example.net, and want people who contact you@example.com to be alerted to contact you at you@example.net instead. This type of aliasing is well supported in the email world, but very hard to handle with XMPP, this module sidesteps all the hard problems by just sending the user a helpful message, requiring humans to decide what they actually want to do. This doesn't require any special support on other clients or servers, just the ability to receive messages. Configuration ============= Add the module to the `modules_enabled` list. modules_enabled = { ... "alias"; } Then set up your list of aliases, aliases can be full or bare JIDs, or hosts: aliases = { ["old@example.net"] = "new@example.net"; ["you@example.com"] = "you@example.net"; ["conference.example.com"] = "conference.example.net"; } You can also set up a custom response, by default it is: alias_response = "User $alias can be contacted at $target"; A script named mod_alias_postfixadmin.sh is included in this directory to generate the aliases array directly from a postfixadmin MySQL database. Instructions for use are included in the script. Compatibility ============= ------- -------------- trunk Works 0.10 Works 0.9 Unknown 0.8 Unknown ------- --------------