Mercurial > prosody-modules

view mod_register_web/README.markdown @ 2670:6e01878103c0

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
mod_smacks: Ignore user when writing or reading session_cache on prosody 0.9 At least under some circumstances it seems that session.username is nil when a user tries to resume his session in prosody 0.9. The username is not relevant when no limiting is done (limiting the number of entries in the session cache is only possible in prosody 0.10), so this commit removes the usage of the username when accessing the prosody 0.9 session cache.
author tmolitor <thilo@eightysoft.de>
date Thu, 06 Apr 2017 02:12:14 +0200
parents 4d73a1a6ba68
children 8d1634b71066
line wrap: on
line source

---
labels:
- 'Stage-Alpha'
summary: A web interface to register user accounts
...

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

There are various reasons to prefer web registration instead of
"in-band" account registration over XMPP. For example the lack of
CAPTCHA support in clients and servers.

Details
-------

mod\_register\_web has Prosody serve a web page where users can sign up
for an account. It implements reCaptcha to prevent automated sign-ups
(from bots, etc.).

Configuration
-------------

The module is served on Prosody's default HTTP ports at the path
`/register_web`. More details on configuring HTTP modules in Prosody can
be found in our [HTTP documentation](http://prosody.im/doc/http).

To configure the CAPTCHA you need to supply a 'captcha\_options' option:

        captcha_options = {
          recaptcha_private_key = "12345";
          recaptcha_public_key = "78901";
        }

The keys for reCaptcha are available in your reCaptcha account, visit
[recaptcha.net](http://recaptcha.net/) for more info.

If no reCaptcha options are set, a simple built in captcha is used.

Compatibility
-------------

  ----- --------------
  0.9   Works
  0.8   Doesn't work
  ----- --------------

Todo
----

Lots. The module is very basic at the moment. In particular I would like
to see:

Customisation (CSS and/or HTML)

Different CAPTCHA implementation support

Collection of additional data, such as email address

The module kept simple!