Changeset 3686

Timestamp:

08/30/06 23:08:25 (2 years ago)

Author:

adrian

Message:

Fixed #2609 -- Improved docs/sites.txt CurrentSiteManager? to explain gotcha with models.Manager

Files:

• django/trunk/docs/sites.txt (modified) (1 diff)

django/trunk/docs/sites.txt

@@ -267 +267 @@
-exist, Django will raise a ``ValueError``.
-
+Finally, note that you'll probably want to keep a normal (non-site-specific)
+``Manager`` on your model, even if you use ``CurrentSiteManager``. As explained
+in the `manager documentation`_, if you define a manager manually, then Django
+won't create the automatic ``objects = models.Manager()`` manager for you.
+Also, note that certain parts of Django -- namely, the Django admin site and
+generic views -- use whichever manager is defined *first* in the model, so if
+you want your admin site to have access to all objects (not just site-specific
+ones), put ``objects = models.Manager()`` in your model, before you define
+``CurrentSiteManager``.
+
-.. _manager: http://www.djangoproject.com/documentation/model_api/#managers
+.. _manager documentation: http://www.djangoproject.com/documentation/model_api/#managers
-
-How Django uses the sites framework