~ubuntu-branches/ubuntu/oneiric/python-django/oneiric-201108291626

« back to all changes in this revision

Viewing changes to docs/ref/contrib/sites.txt

  • Committer: Bazaar Package Importer
  • Author(s): Jamie Strandboge
  • Date: 2010-10-12 11:34:35 UTC
  • mfrom: (1.1.12 upstream) (29.1.1 maverick-security)
  • Revision ID: james.westby@ubuntu.com-20101012113435-yy57c8tx6g9anf3e
Tags: 1.2.3-1ubuntu0.1
* SECURITY UPDATE: XSS in CSRF protections. New upstream release
  - CVE-2010-3082
* debian/patches/01_disable_url_verify_regression_tests.diff:
  - updated to disable another test that fails without internet connection
  - patch based on work by Kai Kasurinen and Krzysztof Klimonda
* debian/control: don't Build-Depends on locales-all, which doesn't exist
  in maverick

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.. _ref-contrib-sites:
2
 
 
3
1
=====================
4
2
The "sites" framework
5
3
=====================
260
258
If :class:`~django.contrib.sites.models.Site` plays a key role in your
261
259
application, consider using the helpful
262
260
:class:`~django.contrib.sites.managers.CurrentSiteManager` in your
263
 
model(s). It's a model :ref:`manager <topics-db-managers>` that
 
261
model(s). It's a model :doc:`manager </topics/db/managers>` that
264
262
automatically filters its queries to include only objects associated
265
263
with the current :class:`~django.contrib.sites.models.Site`.
266
264
 
322
320
Finally, note that you'll probably want to keep a normal
323
321
(non-site-specific) ``Manager`` on your model, even if you use
324
322
:class:`~django.contrib.sites.managers.CurrentSiteManager`. As
325
 
explained in the :ref:`manager documentation <topics-db-managers>`, if
 
323
explained in the :doc:`manager documentation </topics/db/managers>`, if
326
324
you define a manager manually, then Django won't create the automatic
327
325
``objects = models.Manager()`` manager for you. Also note that certain
328
326
parts of Django -- namely, the Django admin site and generic views --
387
385
 
388
386
.. versionadded:: 1.0
389
387
 
390
 
Some :ref:`django.contrib <ref-contrib-index>` applications take advantage of
 
388
Some :doc:`django.contrib </ref/contrib/index>` applications take advantage of
391
389
the sites framework but are architected in a way that doesn't *require* the
392
390
sites framework to be installed in your database. (Some people don't want to, or
393
391
just aren't *able* to install the extra database table that the sites framework