Ticket #12103: 12103_with_documentation.diff

django/contrib/auth/forms.py

@@ -59 +59 @@
     username = forms.CharField(label=_("Username"), max_length=30)
     password = forms.CharField(label=_("Password"), widget=forms.PasswordInput)
 
+    allow_inactive_logins = False
+
     def __init__(self, request=None, *args, **kwargs):
         """
         If request is passed in, the form will validate that cookies are
@@ -78 +80 @@
             self.user_cache = authenticate(username=username, password=password)
             if self.user_cache is None:
                 raise forms.ValidationError(_("Please enter a correct username and password. Note that both fields are case-sensitive."))
-            elif not self.user_cache.is_active:
+            elif not self.allow_inactive_logins and not self.user_cache.is_active:
                 raise forms.ValidationError(_("This account is inactive."))
 
         # TODO: determine whether this should move to its own method.

docs/topics/auth.txt

@@ -970 +970 @@
 
     A form for logging a user in.
 
+    The ``AuthenticationForm`` rejects users whose ``is_active`` flag is set to ``False``.
+    You may override this behavior and allow inactive users to log in. Do this with a
+    custom form that subclasses ``AuthenticationForm`` like
+
+    .. code-block:: python
+
+        class AuthenticationFormWithInactiveUsersOkay(AuthenticationForm):
+            allow_inactive_logins = True
+
 .. class:: PasswordChangeForm
 
     A form for allowing a user to change their password.