Django Unleashed

22.3.2 Swapping the User Model

We have a new User model and a new UserManager—now we need to replace the auth versions. The code to do so is surprisingly easy: we just need to define a variable in our settings and tell it the location of the new User model, as shown in Example 22.35.

Example 22.35: Project Code

suorganizer/settings.py in 19560085fc

Click here to view code image

83   # User 84   # https://docs.djangoproject.com/en/1.8/topics/auth/customizing/ 85 86   AUTH_USER_MODEL = 'user.User'

This black magic is actually one of Django’s secret, undocumented features, called swappable models. In anticipation of our desire to override the User class, the Django team set out to allow any model to be swapped with another. For a model to be swappable, ...