django/docs/add_ons.txt

=====================
The "contrib" add-ons
=====================

Django aims to follow Python's "batteries included" philosophy. It ships with a
variety of extra, optional tools that solve common Web-development problems.

This code lives in ``django/contrib`` in the Django distribution. Here's a
rundown of the packages in ``contrib``:

admin
=====

The automatic Django administrative interface. For more information, see
`Tutorial 2`_.

.. _Tutorial 2: http://www.djangoproject.com/documentation/tutorial2/

auth
====

Django's authentication framework.

See the `authentication documentation`_.

.. _authentication documentation: http://www.djangoproject.com/documentation/authentication/

comments
========

A simple yet flexible comments system. This is not yet documented.

contenttypes
============

A light framework for hooking into "types" of content, where each installed
Django model is a separate content type. This is not yet documented.

csrf
====

A middleware for preventing Cross Site Request Forgeries

See the `csrf documentation`_.

.. _csrf documentation: http://www.djangoproject.com/documentation/csrf/

flatpages
=========

A framework for managing simple "flat" HTML content in a database.

See the `flatpages documentation`_.

.. _flatpages documentation: http://www.djangoproject.com/documentation/flatpages/

markup
======

A collection of template filters that implement these common markup languages:

    * Textile
    * Markdown
    * ReST (ReStructured Text)

redirects
=========

A framework for managing redirects.

See the `redirects documentation`_.

.. _redirects documentation: http://www.djangoproject.com/documentation/redirects/

sites
=====

A light framework that lets you operate multiple Web sites off of the same
database and Django installation. It gives you hooks for associating objects to
one or more sites.

See the `sites documentation`_.

.. _sites documentation: http://www.djangoproject.com/documentation/sites/

syndication
===========

A framework for generating syndication feeds, in RSS and Atom, quite easily.

See the `syndication documentation`_.

.. _syndication documentation: http://www.djangoproject.com/documentation/syndication/

Other add-ons
=============

If you have an idea for functionality to include in ``contrib``, let us know!
Code it up, and post it to the `django-users mailing list`_.

.. _django-users mailing list: http://groups.google.com/group/django-users