1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
.. _forms:
.. module:: registration.forms
Base form classes
=================
Several form classes are provided with ``django-registration``,
covering common cases for gathering account information and
implementing common constraints for user registration. These forms
were designed with ``django-registration``'s built-in registration
workflows in mind, but may also be useful in other situations.
.. class:: RegistrationForm
A simple form for registering an account. This is a subclass of
Django's built-in ``UserCreationForm``, and has the following
fields, all of which are required:
``username``
The username to use for the new account. This is represented as
a text input which validates that the username is unique,
consists entirely of alphanumeric characters and underscores
and is at most 30 characters in length.
``email``
The email address to use for the new account. This is
represented as a text input which accepts email addresses up to
75 characters in length.
``password1``
The password to use for the new account. This is represented as
a password input (``input type="password"`` in the rendered
HTML).
``password2``
The password to use for the new account. This is represented as
a password input (``input type="password"`` in the rendered
HTML).
Because this is a subclass of Django's own ``UserCreationForm``,
the constraints on usernames and email addresses match those
enforced by Django's default authentication backend for instances
of ``django.contrib.auth.models.User``. The repeated entry of the
password serves to catch typos.
The validation error for mismatched passwords is attached to the
``password2`` field. This is a backwards-incompatible change from
``django-registration`` 1.0.
.. class:: RegistrationFormTermsOfService
A subclass of :class:`RegistrationForm` which adds one additional,
required field:
``tos``
A checkbox indicating agreement to the site's terms of
service/user agreement.
.. class:: RegistrationFormUniqueEmail
A subclass of :class:`RegistrationForm` which enforces uniqueness
of email addresses in addition to uniqueness of usernames.
.. class:: RegistrationFormNoFreeEmail
A subclass of :class:`RegistrationForm` which disallows
registration using addresses from some common free email
providers. This can, in some cases, cut down on automated
registration by spambots.
By default, the following domains are disallowed for email
addresses:
* ``aim.com``
* ``aol.com``
* ``email.com``
* ``gmail.com``
* ``googlemail.com``
* ``hotmail.com``
* ``hushmail.com``
* ``msn.com``
* ``mail.ru``
* ``mailinator.com``
* ``live.com``
* ``yahoo.com``
To change this, subclass this form and set the class attribute
``bad_domains`` to a list of domains you wish to disallow.
|
