summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/sites.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/sites.txt b/docs/sites.txt
index 153b0141c5..b78cd84d05 100644
--- a/docs/sites.txt
+++ b/docs/sites.txt
@@ -239,6 +239,11 @@ With this model, ``Photo.objects.all()`` will return all ``Photo`` objects in
the database, but ``Photo.on_site.all()`` will return only the ``Photo``
objects associated with the current site, according to the ``SITE_ID`` setting.
+Put another way, these two statements are equivalent::
+
+ Photo.objects.filter(site=settings.SITE_ID)
+ Photo.on_site.all()
+
How did ``CurrentSiteManager`` know which field of ``Photo`` was the ``Site``?
It defaults to looking for a field called ``site``. If your model has a
``ForeignKey`` or ``ManyToManyField`` called something *other* than ``site``,