Mercurial > prosody-modules
diff mod_invites/README.markdown @ 3776:80830d97da81
mod_invites: New module providing an API to create/manage invite tokens
author | Matthew Wild <mwild1@gmail.com> |
---|---|
date | Fri, 27 Dec 2019 10:31:33 +0000 |
parents | |
children | 824447fc7759 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mod_invites/README.markdown Fri Dec 27 10:31:33 2019 +0000 @@ -0,0 +1,22 @@ + +This module manages the creation and consumption of invite codes for the +host(s) it is loaded onto. It currently does not expose any admin/user-facing +functionality (though in the future it will probably gain a way to view/manage +pending invites). + +Other modules can use the API from this module to create invite tokens which +can be used to e.g. register accounts or create automatic subscription approvals. + +# Configuration + +`` {.lua} +-- Configure the number of seconds a token is valid for (default 7 days) +invite_expiry = 86400 * 7 +``` + +Note that all modules that use this API will automatically load this module, +so adding it to modules_enabled is generally not necessary. + +# Compatibility + +0.11 and later.