2009-12-26 03:44:21 +00:00
|
|
|
====================
|
|
|
|
``contrib`` packages
|
|
|
|
====================
|
2005-11-22 19:21:51 +00:00
|
|
|
|
2016-05-08 22:07:43 +00:00
|
|
|
Django aims to follow Python's :ref:`"batteries included" philosophy
|
|
|
|
<tut-batteries-included>`. It ships with a variety of extra, optional tools
|
2021-07-23 06:48:16 +00:00
|
|
|
that solve common web development problems.
|
2005-11-22 19:21:51 +00:00
|
|
|
|
2022-06-30 12:08:49 +00:00
|
|
|
This code lives in :source:`django/contrib` in the Django distribution. This document
|
2007-06-07 21:41:41 +00:00
|
|
|
gives a rundown of the packages in ``contrib``, along with any dependencies
|
2007-06-07 17:50:53 +00:00
|
|
|
those packages have.
|
2005-11-22 19:21:51 +00:00
|
|
|
|
2023-04-21 10:03:59 +00:00
|
|
|
.. admonition:: Including ``contrib`` packages in ``INSTALLED_APPS``
|
2007-03-27 22:18:52 +00:00
|
|
|
|
|
|
|
For most of these add-ons -- specifically, the add-ons that include either
|
|
|
|
models or template tags -- you'll need to add the package name (e.g.,
|
2014-01-18 18:34:54 +00:00
|
|
|
``'django.contrib.redirects'``) to your :setting:`INSTALLED_APPS` setting
|
2022-03-11 08:11:42 +00:00
|
|
|
and rerun ``manage.py migrate``.
|
2007-03-27 22:18:52 +00:00
|
|
|
|
2008-08-23 22:25:40 +00:00
|
|
|
.. toctree::
|
|
|
|
:maxdepth: 1
|
|
|
|
|
2009-03-23 20:22:56 +00:00
|
|
|
admin/index
|
2008-08-23 22:25:40 +00:00
|
|
|
auth
|
|
|
|
contenttypes
|
|
|
|
flatpages
|
2010-03-26 20:14:53 +00:00
|
|
|
gis/index
|
2008-08-23 22:25:40 +00:00
|
|
|
humanize
|
2009-12-09 16:57:23 +00:00
|
|
|
messages
|
2014-03-26 16:44:21 +00:00
|
|
|
postgres/index
|
2008-08-23 22:25:40 +00:00
|
|
|
redirects
|
|
|
|
sitemaps
|
|
|
|
sites
|
2010-10-20 01:33:24 +00:00
|
|
|
staticfiles
|
2008-08-23 22:25:40 +00:00
|
|
|
syndication
|
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``admin``
|
|
|
|
=========
|
2005-11-22 19:21:51 +00:00
|
|
|
|
|
|
|
The automatic Django administrative interface. For more information, see
|
2010-08-19 19:27:44 +00:00
|
|
|
:doc:`Tutorial 2 </intro/tutorial02>` and the
|
|
|
|
:doc:`admin documentation </ref/contrib/admin/index>`.
|
2005-11-22 19:21:51 +00:00
|
|
|
|
2007-06-07 17:50:53 +00:00
|
|
|
Requires the auth_ and contenttypes_ contrib packages to be installed.
|
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``auth``
|
|
|
|
========
|
2006-05-22 03:14:33 +00:00
|
|
|
|
|
|
|
Django's authentication framework.
|
|
|
|
|
2012-12-28 19:00:11 +00:00
|
|
|
See :doc:`/topics/auth/index`.
|
2006-05-22 03:14:33 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``contenttypes``
|
|
|
|
================
|
2006-05-22 03:14:33 +00:00
|
|
|
|
|
|
|
A light framework for hooking into "types" of content, where each installed
|
2007-12-17 07:39:24 +00:00
|
|
|
Django model is a separate content type.
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`contenttypes documentation </ref/contrib/contenttypes>`.
|
2006-05-22 03:14:33 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``flatpages``
|
|
|
|
=============
|
2007-12-01 17:07:32 +00:00
|
|
|
|
2019-06-17 14:54:55 +00:00
|
|
|
A framework for managing "flat" HTML content in a database.
|
2007-12-01 17:07:32 +00:00
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`flatpages documentation </ref/contrib/flatpages>`.
|
2007-12-01 17:07:32 +00:00
|
|
|
|
|
|
|
Requires the sites_ contrib package to be installed as well.
|
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``gis``
|
|
|
|
=======
|
2010-03-26 20:14:53 +00:00
|
|
|
|
|
|
|
A world-class geospatial framework built on top of Django, that enables
|
|
|
|
storage, manipulation and display of spatial data.
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`/ref/contrib/gis/index` documentation for more.
|
2010-03-26 20:14:53 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``humanize``
|
|
|
|
============
|
2006-06-04 00:58:39 +00:00
|
|
|
|
|
|
|
A set of Django template filters useful for adding a "human touch" to data.
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`humanize documentation </ref/contrib/humanize>`.
|
2007-08-20 08:50:08 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``messages``
|
|
|
|
============
|
2009-12-09 16:57:23 +00:00
|
|
|
|
|
|
|
A framework for storing and retrieving temporary cookie- or session-based
|
|
|
|
messages
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`messages documentation </ref/contrib/messages>`.
|
2009-12-09 16:57:23 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``postgres``
|
|
|
|
============
|
2014-03-26 16:44:21 +00:00
|
|
|
|
|
|
|
A collection of PostgreSQL specific features.
|
|
|
|
|
|
|
|
See the :doc:`contrib.postgres documentation </ref/contrib/postgres/index>`.
|
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``redirects``
|
|
|
|
=============
|
2005-11-22 19:21:51 +00:00
|
|
|
|
|
|
|
A framework for managing redirects.
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`redirects documentation </ref/contrib/redirects>`.
|
2005-11-22 19:21:51 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``sessions``
|
|
|
|
============
|
2007-12-01 17:07:32 +00:00
|
|
|
|
|
|
|
A framework for storing data in anonymous sessions.
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`sessions documentation </topics/http/sessions>`.
|
2007-12-01 17:07:32 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``sites``
|
|
|
|
=========
|
2006-05-22 03:14:33 +00:00
|
|
|
|
2015-11-15 12:05:15 +00:00
|
|
|
A light framework that lets you operate multiple websites off of the same
|
2006-05-22 03:14:33 +00:00
|
|
|
database and Django installation. It gives you hooks for associating objects to
|
2006-05-22 04:48:44 +00:00
|
|
|
one or more sites.
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`sites documentation </ref/contrib/sites>`.
|
2006-05-22 03:14:33 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``sitemaps``
|
|
|
|
============
|
2006-08-31 23:19:53 +00:00
|
|
|
|
|
|
|
A framework for generating Google sitemap XML files.
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`sitemaps documentation </ref/contrib/sitemaps>`.
|
2006-08-31 23:19:53 +00:00
|
|
|
|
2016-01-24 21:26:11 +00:00
|
|
|
``syndication``
|
|
|
|
===============
|
2005-11-22 19:21:51 +00:00
|
|
|
|
|
|
|
A framework for generating syndication feeds, in RSS and Atom, quite easily.
|
|
|
|
|
2010-08-19 19:27:44 +00:00
|
|
|
See the :doc:`syndication documentation </ref/contrib/syndication>`.
|
2005-11-22 19:21:51 +00:00
|
|
|
|
|
|
|
Other add-ons
|
|
|
|
=============
|
|
|
|
|
|
|
|
If you have an idea for functionality to include in ``contrib``, let us know!
|
2013-10-03 22:51:22 +00:00
|
|
|
Code it up, and post it to the |django-users| mailing list.
|