test0908
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

[1.7.x] Fixed #22874: Document that AUTH_USER_MODEL must be in first migration

This commit is contained in:
Andrew Godwin 2014-06-19 23:48:29 -07:00
parent bfe5f72c7e
commit 44b00af9bc
2 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/ref/settings.txt
View File

@ -2435,7 +2435,9 @@ The model to use to represent a User. See :ref:`auth-custom-user`.
.. warning:: .. warning::
You cannot change the AUTH_USER_MODEL setting during the lifetime of You cannot change the AUTH_USER_MODEL setting during the lifetime of
a project (i.e. once you have made and migrated models that depend on it) a project (i.e. once you have made and migrated models that depend on it)
without serious effort. It is intended to be set at the project start. without serious effort. It is intended to be set at the project start,
and the model it refers to must be available in the first migration of
the app that it lives in.
See :ref:`auth-custom-user` for more details. See :ref:`auth-custom-user` for more details.
.. setting:: LOGIN_REDIRECT_URL .. setting:: LOGIN_REDIRECT_URL

8
docs/topics/auth/customizing.txt
View File

@ -386,6 +386,14 @@ use as your User model.
fix your schema, port your data from the old user table, and possibly fix your schema, port your data from the old user table, and possibly
manually reapply some migrations. manually reapply some migrations.
.. warning::
Due to limitations of Django's dynamic dependency feature for swappable
models, you must ensure that the model referenced by :setting:`AUTH_USER_MODEL`
is created in the first migration of its app (usually called ``0001_initial``);
otherwise, you will have dependency issues.
Referencing the User model Referencing the User model
-------------------------- --------------------------