This is just a simple, portable, generic user-registration application for Django projects. Workflow follows a simple pattern:

• A user signs up for a new account, which will be inactive by default.
• An email is sent to the address they used to register, containing an activation link.
• Once they click the activation link, the account becomes active and they can log in as normal.

Requires a recent Subversion checkout of Django; this application is tracking backwards-incompatible changes in trunk, which means that it will not work with Django 0.96. For a useful companion to this application, see django-profiles, which provides support for managing site-specific user profiles once a user has registered and activated.

There are two options for downloading; one is to download the latest packaged version (see the green box on the right-hand side of this page) and unpack it; inside is a script called setup.py. Type this command:

python setup.py install

and the package will install automatically.

The other method is to do a Subversion checkout from somewhere on your Python path:

svn checkout http://django-registration.googlecode.com/svn/trunk/registration/

Keep in mind, though, that the current code in SVN may be different from the packaged release, may contain bugs and may contain backwards-incompatible changes.

Full documentation is available online, and can also be checked out from the SVN repository. Documentation tracks the latest packaged version; if you're running bleeding-edge out of an SVN checkout, I assume you're able to look over the code and figure out anything that's changed :)

Note for users upgrading from version 0.1 to 0.2: The key_generated field has been removed from the RegistrationProfile model; you will need to drop that column from your database when upgrading.

Note for users upgrading form version 0.3 to 0.4: The validation of the password fields has changed. See the changelog file for details.