Django v1.3.2 documentation

Home | Table of contents | Index | Modules

up | next »

Django documentation contents

• Getting started
  • Django at a glance
    • Design your model
    • Install it
    • Enjoy the free API
    • A dynamic admin interface: it’s not just scaffolding – it’s the whole house
    • Design your URLs
    • Write your views
    • Design your templates
    • This is just the surface
  • Quick install guide
    • Install Python
    • Set up a database
    • Remove any old versions of Django
    • Install Django
    • Verifying
    • That’s it!
  • Writing your first Django app, part 1
    • Creating a project
    • Creating models
    • Activating models
    • Playing with the API
  • Writing your first Django app, part 2
    • Activate the admin site
    • Start the development server
    • Enter the admin site
    • Make the poll app modifiable in the admin
    • Explore the free admin functionality
    • Customize the admin form
    • Adding related objects
    • Customize the admin change list
    • Customize the admin look and feel
    • Customize the admin index page
  • Writing your first Django app, part 3
    • Philosophy
    • Design your URLs
    • Write your first view
    • Write views that actually do something
    • Raising 404
    • Write a 404 (page not found) view
    • Write a 500 (server error) view
    • Use the template system
    • Simplifying the URLconfs
    • Decoupling the URLconfs
  • Writing your first Django app, part 4
    • Write a simple form
    • Use generic views: Less code is better
    • Coming soon
  • What to read next
    • Finding documentation
    • How the documentation is organized
    • How documentation is updated
    • Where to get it
    • Differences between versions
• Using Django
  • How to install Django
    • Install Python
    • Install Apache and mod_wsgi
    • Get your database running
    • Remove any old versions of Django
    • Install the Django code
  • Models and databases
    • Models
    • Making queries
    • Aggregation
    • Managers
    • Performing raw SQL queries
    • Managing database transactions
    • Multiple databases
    • Database access optimization
  • Handling HTTP requests
    • URL dispatcher
    • Writing views
    • View decorators
    • File Uploads
    • Django shortcut functions
    • Generic views
    • Middleware
    • How to use sessions
  • Working with forms
    • Overview
    • Form objects
    • Further topics
  • The Django template language
    • Templates
    • Variables
    • Filters
    • Tags
    • Comments
    • Template inheritance
    • Automatic HTML escaping
    • Accessing method calls
    • Custom tag and filter libraries
  • Class-based generic views
    • Simple usage
    • Generic views of objects
    • Extending generic views
    • Decorating class-based views
  • Migrating function-based generic views
    • How to migrate
  • Managing files
    • Using files in models
    • The File object
    • File storage
  • Testing Django applications
    • Writing tests
    • Running tests
    • Testing tools
    • Using different testing frameworks
  • User authentication in Django
    • Overview
    • Installation
    • Users
    • Authentication in Web requests
    • Permissions
    • Authentication data in templates
    • Groups
    • Messages
    • Other authentication sources
  • Django’s cache framework
    • Setting up the cache
    • The per-site cache
    • The per-view cache
    • Template fragment caching
    • The low-level cache API
    • Upstream caches
    • Using Vary headers
    • Controlling cache: Using other headers
    • Other optimizations
    • Order of MIDDLEWARE_CLASSES
  • Conditional View Processing
    • The condition decorator
    • Shortcuts for only computing one value
    • Using the decorators with other HTTP methods
    • Comparison with middleware conditional processing
  • Sending e-mail
    • Quick example
    • send_mail()
    • send_mass_mail()
    • mail_admins()
    • mail_managers()
    • Examples
    • Preventing header injection
    • The EmailMessage class
    • E-Mail Backends
    • Testing e-mail sending
    • SMTPConnection
  • Internationalization and localization
    • Overview
    • Glossary
    • Specialties of Django translation
  • Logging
    • A quick logging primer
    • Using logging
    • Configuring logging
    • Django’s logging extensions
  • Pagination
    • Example
    • Using Paginator in a view
    • Paginator objects
    • InvalidPage exceptions
    • Page objects
  • Serializing Django objects
    • Serializing data
    • Deserializing data
    • Serialization formats
    • Natural keys
  • Django settings
    • The basics
    • Designating the settings
    • Default settings
    • Using settings in Python code
    • Altering settings at runtime
    • Security
    • Available settings
    • Creating your own settings
    • Using settings without setting DJANGO_SETTINGS_MODULE
  • Signals
    • Listening to signals
    • Defining and sending signals
    • Disconnecting signals
  • Deprecated features
    • Generic views
• “How-to” guides
  • Authenticating against Django’s user database from Apache
    • Configuring Apache
  • Authentication using REMOTE_USER
    • Configuration
    • RemoteUserBackend
  • How to contribute to Django
    • “The Spirit of Contributing”
    • Understanding Trac
    • Advice for new contributors
    • FAQs
  • Writing custom django-admin commands
    • Command objects
  • Writing custom model fields
    • Introduction
    • Background theory
    • Writing a field subclass
    • Writing a FileField subclass
  • Custom template tags and filters
    • Introduction
  • Writing a custom storage system
    • _open(name, mode='rb')
    • _save(name, content)
    • get_valid_name(name)
    • get_available_name(name)
  • Deploying Django
    • How to use Django with Apache and mod_wsgi
    • How to use Django with FastCGI, SCGI, or AJP
    • mod_python (deprecated)
  • Error reporting via e-mail
    • Server errors
    • 404 errors
  • Providing initial data for models
    • Providing initial data with fixtures
    • Providing initial SQL data
  • Using internationalization in your own projects
    • Using translations outside views and templates
  • Running Django on Jython
    • Installing Jython
    • Creating a servlet container
    • Installing Django
    • Installing Jython platform support libraries
    • Differences with Django on Jython
  • Integrating Django with a legacy database
    • Give Django your database parameters
    • Auto-generate the models
    • Install the core Django tables
    • Test and tweak
  • Outputting CSV with Django
    • Using the Python CSV library
    • Using the template system
    • Other text-based formats
  • Outputting PDFs with Django
    • Install ReportLab
    • Write your view
    • Complex PDFs
    • Further resources
    • Other formats
  • Managing static files
    • Using django.contrib.staticfiles
    • Referring to static files in templates
    • Serving static files in development
    • Serving static files in production
    • Upgrading from django-staticfiles
    • Learn more
• Django FAQ
  • FAQ: General
    • Why does this project exist?
    • What does “Django” mean, and how do you pronounce it?
    • Is Django stable?
    • Does Django scale?
    • Who’s behind this?
    • Which sites use Django?
    • Django appears to be a MVC framework, but you call the Controller the “view”, and the View the “template”. How come you don’t use the standard names?
    • <Framework X> does <feature Y> – why doesn’t Django?
    • Why did you write all of Django from scratch, instead of using other Python libraries?
    • Is Django a content-management-system (CMS)?
    • How can I download the Django documentation to read it offline?
    • Where can I find Django developers for hire?
  • FAQ: Installation
    • How do I get started?
    • What are Django’s prerequisites?
    • Do I lose anything by using Python 2.4 versus newer Python versions, such as Python 2.5 or 2.6?
    • Can I use Django with Python 2.3?
    • Can I use Django with Python 3?
    • Will Django run under shared hosting (like TextDrive or Dreamhost)?
    • Should I use the stable version or development version?
  • FAQ: Using Django
    • Why do I get an error about importing DJANGO_SETTINGS_MODULE?
    • I can’t stand your template language. Do I have to use it?
    • Do I have to use your model/database layer?
    • How do I use image and file fields?
    • How do I make a variable available to all my templates?
  • FAQ: Getting Help
    • How do I do X? Why doesn’t Y work? Where can I go to get help?
    • Why hasn’t my message appeared on django-users?
    • Nobody on django-users answered my question! What should I do?
    • I think I’ve found a bug! What should I do?
    • I think I’ve found a security problem! What should I do?
  • FAQ: Databases and models
    • How can I see the raw SQL queries Django is running?
    • Can I use Django with a pre-existing database?
    • If I make changes to a model, how do I update the database?
    • Do Django models support multiple-column primary keys?
    • How do I add database-specific options to my CREATE TABLE statements, such as specifying MyISAM as the table type?
    • Why is Django leaking memory?
  • FAQ: The admin
    • I can’t log in. When I enter a valid username and password, it just brings up the login page again, with no error messages.
    • I can’t log in. When I enter a valid username and password, it brings up the login page again, with a “Please enter a correct username and password” error.
    • How can I prevent the cache middleware from caching the admin site?
    • How do I automatically set a field’s value to the user who last edited the object in the admin?
    • How do I limit admin access so that objects can only be edited by the users who created them?
    • My admin-site CSS and images showed up fine using the development server, but they’re not displaying when using mod_wsgi.
    • My “list_filter” contains a ManyToManyField, but the filter doesn’t display.
    • How can I customize the functionality of the admin interface?
    • The dynamically-generated admin site is ugly! How can I change it?
  • FAQ: Contributing code
    • How can I get started contributing code to Django?
    • I submitted a bug fix in the ticket system several weeks ago. Why are you ignoring my patch?
    • When and how might I remind the core team of a patch I care about?
    • But I’ve reminded you several times and you keep ignoring my patch!
• API Reference
  • Authentication backends
    • Available authentication backends
  • contrib packages
    • The Django admin site
    • django.contrib.auth
    • Django’s comments framework
    • The contenttypes framework
    • Cross Site Request Forgery protection
    • Databrowse
    • The flatpages app
    • django.contrib.formtools
    • GeoDjango
    • django.contrib.humanize
    • The “local flavor” add-ons
    • django.contrib.markup
    • The messages framework
    • The redirects app
    • The sitemap framework
    • The “sites” framework
    • The staticfiles app
    • The syndication feed framework
    • django.contrib.webdesign
    • admin
    • auth
    • comments
    • contenttypes
    • csrf
    • flatpages
    • formtools
    • gis
    • humanize
    • localflavor
    • markup
    • messages
    • redirects
    • sessions
    • sites
    • sitemaps
    • syndication
    • webdesign
    • Other add-ons
  • Databases
    • PostgreSQL notes
    • MySQL notes
    • SQLite notes
    • Oracle notes
    • Using a 3rd-party database backend
  • django-admin.py and manage.py
    • Usage
    • Available commands
    • Commands provided by applications
    • Default options
    • Common options
    • Extra niceties
  • Running management commands from your code
  • Django Exceptions
    • Django-specific Exceptions
    • Database Exceptions
    • Transaction Exceptions
    • Python Exceptions
  • File handling
    • The File object
    • File storage API
  • Forms
    • The Forms API
    • Form fields
    • Widgets
    • Form and field validation
  • Class-based generic views
    • Mixins
    • Generic views
  • Middleware
    • Available middleware
  • Models
    • Model field reference
    • Related objects reference
    • Model Meta options
    • Model instance reference
    • QuerySet API reference
  • Request and response objects
    • Quick overview
    • HttpRequest objects
    • UploadedFile objects
    • QueryDict objects
    • HttpResponse objects
  • TemplateResponse and SimpleTemplateResponse
    • SimpleTemplateResponse objects
    • TemplateResponse objects
    • The rendering process
    • Using TemplateResponse and SimpleTemplateResponse
  • Settings
    • Available settings
    • Deprecated settings
  • Signals
    • Model signals
    • Management signals
    • Request/response signals
    • Test signals
    • Database Wrappers
  • Templates
    • Built-in template tags and filters
    • The Django template language: For Python programmers
  • Unicode data
    • Creating the database
    • General string handling
    • Models
    • The database API
    • Templates
    • E-mail
    • Form submission
  • Django Utils
    • django.utils.cache
    • SortedDict
    • django.utils.encoding
    • django.utils.feedgenerator
    • django.utils.functional
    • django.utils.http
    • django.utils.safestring
    • django.utils.translation
    • django.utils.tzinfo
  • Validators
    • Writing validators
    • How validators are run
    • Built-in validators
  • Deprecated features
    • Generic views
• Meta-documentation and miscellany
  • API stability
    • What “stable” means
    • Stable APIs
    • Exceptions
  • Design philosophies
    • Overall
    • Models
    • Database API
    • URL design
    • Template system
    • Views
  • Third-party distributions of Django
    • For distributors
• Glossary
• Release notes
  • Final releases
    • 1.3 release
    • 1.2 release
    • 1.1 release
    • 1.0 release
    • Pre-1.0 releases
  • Development releases
    • Django 1.3 beta 1 release notes
    • Django 1.3 alpha 1 release notes
    • Django 1.2 RC 1 release notes
    • Django 1.2 beta 1 release notes
    • Django 1.2 alpha 1 release notes
    • Django 1.1 RC 1 release notes
    • Django 1.1 beta 1 release notes
    • Django 1.1 alpha 1 release notes
    • Django 1.0 beta 2 release notes
    • Django 1.0 beta 1 release notes
    • Django 1.0 alpha 2 release notes
    • Django 1.0 alpha release notes
• Django internals
  • Contributing to Django
    • Reporting bugs
    • Reporting security issues
    • Submitting patches
    • Ticket triage
    • Submitting and maintaining translations
    • Submitting javascript patches
    • Django conventions
    • Coding style
    • Documentation style
    • Committing code
    • Unit tests
    • Requesting features
    • Branch policy
    • How we make decisions
    • Commit access
  • How the Django documentation works
    • Django-specific markup
    • An example
    • TODO
    • Hints
  • Django committers
    • The original team
    • Current developers
    • Developers Emeritus
  • Django’s release process
    • Official releases
    • Supported versions
    • Release process
  • Django Deprecation Timeline
  • The Django source code repository
    • High-level overview
    • Working with Django’s trunk
    • Branches
    • Tags

Indices, glossary and tables

• Index
• Module Index
• Glossary

Deprecated/obsolete documentation

The following documentation covers features that have been deprecated or that have been replaced in newer versions of Django.

• Deprecated/obsolete documentation
  • Customizing the Django admin interface

Last update:

Jun 16, 2013

up | next »