docs/source/features/registration.rst

   1 .. _registration:
   2
   3 Open Registration
   4 =================
   5
   6 Ganeti Web Manager versions 0.8 and above allow you to choose whether
   7 users can create their own accounts, or need to be added by an
   8 administrator.
   9
  10 The default setting for registration is open, which means that visitors
  11 to your site's login page can follow a link from the login page to
  12 create their own accounts.
  13
  14 .. figure:: /_static/registration-link.png
  15    :align: center
  16
  17 The "Not a member?" link takes the user to the registration page:
  18
  19 .. figure:: /_static/registration-page-open.png
  20    :align: center
  21
  22 The user is emailed a password and a confirmation link, then has an
  23 account on your site. Users can also be added by a site admin by
  24 selecting the users link in the admin toolbar, then using the Add User
  25 button to reach the user creation form.
  26
  27 Closing Registration
  28 --------------------
  29
  30 In some contexts, users should not be able to create their own accounts.
  31 To implement this, simply change the ALLOW\_OPEN\_REGISTRATION setting
  32 in your settings.py file to False:
  33 ::
  34
  35     # Whether users should be able to create their own accounts.
  36     # False if accounts can only be created by admins.
  37     ALLOW_OPEN_REGISTRATION = False
  38
  39 This setting is currently located near line 203, below the registration
  40 email settings.
  41
  42 Result of closed registration
  43 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  44
  45 The "Not a member?" link is hidden from users on the login page. If they
  46 navigate to the <SITE\_ROOT>/accounts/register page, they will see this
  47 message instead of the account creation form:
  48
  49 .. figure:: /_static/closed-registration.png
  50    :align: center