Fixed #26020 -- Normalized header stylings in docs.

.. _contents:

=============================

Django documentation contents

=============================

* :ref:`genindex`

* :ref:`modindex`

* :ref:`glossary`

* :doc:`glossary`

==============

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.

---------------------------------------------------------------------------------------------------------------------------

===========================================================================================================================

The login cookie isn't being set correctly, because the domain of the cookie

sent out by Django doesn't match the domain in your browser. Try these two

  should set :setting:`SESSION_COOKIE_DOMAIN` = 'www.example.com'.

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.

-----------------------------------------------------------------------------------------------------------------------------------------------------------

===========================================================================================================================================================

If you're sure your username and password are correct, make sure your user

account has :attr:`~django.contrib.auth.models.User.is_active` and

only allows access to users with those two fields both set to True.

How do I automatically set a field's value to the user who last edited the object in the admin?

-----------------------------------------------------------------------------------------------

===============================================================================================

The :class:`~django.contrib.admin.ModelAdmin` class provides customization hooks

that allow you to transform an object as it saved, using details from the

ModelAdmin methods <model-admin-methods>` for an example.

How do I limit admin access so that objects can only be edited by the users who created them?

---------------------------------------------------------------------------------------------

=============================================================================================

The :class:`~django.contrib.admin.ModelAdmin` class also provides customization

hooks that allow you to control the visibility and editability of objects in the

control the visibility and editability of objects in the admin.

My admin-site CSS and images showed up fine using the development server, but they're not displaying when using mod_wsgi.

---------------------------------------------------------------------------------------------------------------------------

=========================================================================================================================

See :ref:`serving the admin files <serving-the-admin-files>`

in the "How to use Django with mod_wsgi" documentation.

My "list_filter" contains a ManyToManyField, but the filter doesn't display.

----------------------------------------------------------------------------

============================================================================

Django won't bother displaying the filter for a ``ManyToManyField`` if there

are fewer than two related objects.

would be meaningless.

Some objects aren't appearing in the admin.

-------------------------------------------

===========================================

Inconsistent row counts may be caused by missing foreign key values or a

foreign key field incorrectly set to :attr:`null=False

integrity constraint that is not implemented at the database level.

How can I customize the functionality of the admin interface?

-------------------------------------------------------------

=============================================================

You've got several options. If you want to piggyback on top of an add/change

form that Django automatically generates, you can attach arbitrary JavaScript

next question.

The dynamically-generated admin site is ugly! How can I change it?

------------------------------------------------------------------

==================================================================

We like it, but if you don't agree, you can modify the admin site's

presentation by editing the CSS stylesheet and/or associated image files. The

like to make should be possible by editing the stylesheet.

What browsers are supported for using the admin?

------------------------------------------------

================================================

The admin provides a fully-functional experience to `YUI's A-grade`_ browsers,

with the notable exception of IE6, which is not supported.

======================

FAQ: Contributing code

======================

How can I get started contributing code to Django?

--------------------------------------------------

==================================================

Thanks for asking! We've written an entire document devoted to this question.

It's titled :doc:`Contributing to Django </internals/contributing/index>`.

I submitted a bug fix in the ticket system several weeks ago. Why are you ignoring my patch?

--------------------------------------------------------------------------------------------

============================================================================================

Don't worry: We're not ignoring you!

we're ignoring you; it just means we haven't had time to look at it yet.

When and how might I remind the core team of a patch I care about?

------------------------------------------------------------------

==================================================================

A polite, well-timed message to the mailing list is one way to get attention.

To determine the right time, you need to keep an eye on the schedule. If you

get your pet bug addressed.

But I've reminded you several times and you keep ignoring my patch!

-------------------------------------------------------------------

===================================================================

Seriously - we're not ignoring you. If your patch stands no chance of

inclusion in Django, we'll close the ticket. For all the other tickets, we

============

FAQ: General

============

Why does this project exist?

----------------------------

============================

Django grew from a very practical need: World Online, a newspaper Web

operation, is responsible for building intensive Web applications on journalism

.. _PostgreSQL: http://www.postgresql.org/

What does "Django" mean, and how do you pronounce it?

-----------------------------------------------------

=====================================================

Django is named after `Django Reinhardt`_, a gypsy jazz guitarist from the 1930s

to early 1950s. To this day, he's considered one of the best guitarists of all time.

.. _audio clip of the pronunciation: http://red-bean.com/~adrian/django_pronunciation.mp3

Is Django stable?

-----------------

=================

Yes, it's quite stable. Companies like Disqus, Instagram, Pinterest, and

Mozilla have been using Django for many years. Sites built on Django have

weathered traffic spikes of over 50 thousand hits per second.

Does Django scale?

------------------

==================

Yes. Compared to development time, hardware is cheap, and so Django is

designed to take advantage of as much hardware as you can throw at it.

:doc:`cache framework </topics/cache>`.

Who's behind this?

------------------

==================

Django was originally developed at World Online, the Web department of a

newspaper in Lawrence, Kansas, USA. Django's now run by an international

:doc:`team of volunteers </internals/team>`.

Which sites use Django?

-----------------------

=======================

`DjangoSites.org`_ features a constantly growing list of Django-powered sites.

.. _faq-mtv:

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?

-----------------------------------------------------------------------------------------------------------------------------------------------------

=====================================================================================================================================================

Well, the standard names are debatable.

logical to us.

<Framework X> does <feature Y> -- why doesn't Django?

-----------------------------------------------------

=====================================================

We're well aware that there are other awesome Web frameworks out there, and

we're not averse to borrowing ideas where appropriate. However, Django was

to add a given feature to Django.

Why did you write all of Django from scratch, instead of using other Python libraries?

--------------------------------------------------------------------------------------

======================================================================================

When Django was originally written a couple of years ago, Adrian and Simon

spent quite a bit of time exploring the various Python Web frameworks

:doc:`design philosophies page </misc/design-philosophies>`.

Is Django a content-management-system (CMS)?

--------------------------------------------

============================================

No, Django is not a CMS, or any sort of "turnkey product" in and of itself.

It's a Web framework; it's a programming tool that lets you build websites.

.. _Drupal: https://drupal.org/

How can I download the Django documentation to read it offline?

---------------------------------------------------------------

===============================================================

The Django docs are available in the ``docs`` directory of each Django tarball

release. These docs are in reST (reStructuredText) format, and each text file

.. _stored in revision control: https://github.com/django/django/tree/master/docs/

Where can I find Django developers for hire?

--------------------------------------------

============================================

Consult our `developers for hire page`_ for a list of Django developers who

would be happy to help you.

.. _developers for hire page: https://code.djangoproject.com/wiki/DevelopersForHire

How do I cite Django?

---------------------

=====================

It's difficult to give an official citation format, for two reasons: citation

formats can vary wildly between publications, and citation standards for

=================

FAQ: Getting Help

=================

How do I do X? Why doesn't Y work? Where can I go to get help?

--------------------------------------------------------------

==============================================================

If this FAQ doesn't contain an answer to your question, you might want to

try the |django-users| mailing list. Feel free to ask any question related

.. _message-does-not-appear-on-django-users:

Why hasn't my message appeared on django-users?

-----------------------------------------------

===============================================

|django-users| has a lot of subscribers. This is good for the community, as

it means many people are available to contribute answers to questions.

inconvenience that this policy may cause.

Nobody on django-users answered my question! What should I do?

--------------------------------------------------------------

==============================================================

Try making your question more specific, or provide a better example of your

problem.

question there is considered quite impolite.

I think I've found a bug! What should I do?

-------------------------------------------

===========================================

Detailed instructions on how to handle a potential bug can be found in our

:ref:`Guide to contributing to Django <reporting-bugs>`.

I think I've found a security problem! What should I do?

--------------------------------------------------------

========================================================

If you think you've found a security problem with Django, please send a message

to security@djangoproject.com. This is a private list only open to long-time,