================= Django Email Auth ================= Allow users to login using their email address instead of a username. A Few Cautions ============== Django allows emails to be blank and does not ensure that they are unique. The authentication backend supplied with this application does it's best to deal with this, but you should take your responsibility and handle emails with care. Installation ============ 1. Add ``email_auth`` to ``INSTALLED_APPS`` in your project's settings module. 2. Add the ``email_auth`` authentication backend to your project's settings:: AUTHENTICATION_BACKENDS = ( 'email_auth.backends.ModelBackend', ) 3. Add a URL-pattern to your project's urls module (before any other configurations that include the login view):: (r'^accounts/', include('email_auth.urls')), Configuration ============= There are no settings in particular associated with this application. Worth noting here is that the ``login`` view (intended to replace the default Django login-view) takes an argument ``form_class`` that allows you to specify a custom login form. TODO ==== * It might be more elegant to just add a new argument (email) to the authenticate-method instead of using the old one for emails.
strange/django-email-auth
Allow users to login using their email address instead of a username.
PythonBSD-3-Clause