view mod_register_redirect/README.markdown @ 5170:4d6af8950016

mod_muc_moderation: Derive role from reserved nickname if occupant When using a different client to moderate than the one used to participate in the chat, e.g. a command line tool like clix, there's no occupant and no role to use in the permission check. Previously the default role based on affiliation was used. Now if you are present in the room using your reserved nick, the role you have there is used in the permission check instead of the default affiliation-derived role.
author Kim Alvefur <zash@zash.se>
date Sun, 19 Feb 2023 18:17:37 +0100
parents 2023cba9ead0
children 372b6c4bf409
line wrap: on
line source

---
labels:
- 'Stage-Stable'
summary: 'XEP-077 IBR Registration Redirect.'
...

Introduction
------------

Registration Redirect as explained in the [IBR
XEP](http://xmpp.org/extensions/xep-0077.html#redirect).

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.10   Works
  0.9    Works
  0.8    Works
  0.7    Might not work
  0.6    Doesn't work
  0.5    Doesn't work
  ------ --------------