diff mod_register_redirect/README.wiki @ 1782:29f3d6b7ad16

Import wiki pages
author Kim Alvefur <zash@zash.se>
date Mon, 24 Aug 2015 16:43:56 +0200
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_register_redirect/README.wiki	Mon Aug 24 16:43:56 2015 +0200
@@ -0,0 +1,36 @@
+#summary XEP-077 IBR Registration Redirect.
+#labels Stage-Stable
+
+= Introduction =
+
+Registration Redirect as explained in the [http://xmpp.org/extensions/xep-0077.html#redirect IBR XEP].
+
+= Details =
+
+This module shows instructions on how to register to the server, should it be necessary to perform it through other means Out-Of-Band or not, and also let's registrations origining from ip addresses in the whitelist to go through normally.
+
+= Usage =
+
+Copy the module file into your Prosody modules directory.
+
+The module will work "out of the box" as long as at least an admin entry is specified (see admins = {} option into prosody's documentation).
+These are the optional parameters you can specify into your global server/hostname configuration:
+{{{
+registration_whitelist = { "*your whitelisted web server ip address*" }
+registrarion_url = "*your web registration page url*"
+registration_text = "Your custom instructions banner here"
+registration_oob = true (default) or false, in the case there's no applicable OOB method (e.g. the server admins needs to be contacted by phone)
+}}}
+
+To not employ any whitelisting (i.e. registration is handled externally).
+{{{
+no_registration_whitelist = true
+}}}
+
+= Compatibility =
+
+ * 0.9 works
+ * 0.8 works
+ * 0.7 might not work
+ * 0.6 won't work
+ * 0.5 won't work