innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

[1.6.x] LocaleMiddleware isn't default anymore (corrected docs) 

Changed in @23229061fcb836ecca2195cc75f91e331279a5d1

Backport of cf6c754629 from master
This commit is contained in:
Sergio Oliveira 2013-07-18 21:15:30 -03:00 committed by Tim Graham
parent 9b26cb72d9
commit 496f319970
1 changed files with 4 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
docs/topics/i18n/translation.txt
View File

@ -29,9 +29,7 @@ use internationalization, you should take the two seconds to set
:setting:`USE_I18N = False <USE_I18N>` in your settings file. Then Django will :setting:`USE_I18N = False <USE_I18N>` in your settings file. Then Django will
make some optimizations so as not to load the internationalization machinery. make some optimizations so as not to load the internationalization machinery.
You'll probably also want to remove ``'django.core.context_processors.i18n'`` You'll probably also want to remove ``'django.core.context_processors.i18n'``
from your :setting:`TEMPLATE_CONTEXT_PROCESSORS` setting and from your :setting:`TEMPLATE_CONTEXT_PROCESSORS` setting.
``'django.middleware.locale.LocaleMiddleware'`` from your
:setting:`MIDDLEWARE_CLASSES` setting.
.. note:: .. note::
@ -1563,15 +1561,9 @@ If you want to let each individual user specify which language he or she
prefers, use ``LocaleMiddleware``. ``LocaleMiddleware`` enables language prefers, use ``LocaleMiddleware``. ``LocaleMiddleware`` enables language
selection based on data from the request. It customizes content for each user. selection based on data from the request. It customizes content for each user.
``LocaleMiddleware`` is enabled in the default settings file: the To use ``LocaleMiddleware``, add ``'django.middleware.locale.LocaleMiddleware'``
:setting:`MIDDLEWARE_CLASSES` setting contains to your :setting:`MIDDLEWARE_CLASSES` setting. Because middleware order
``'django.middleware.locale.LocaleMiddleware'``. matters, you should follow these guidelines:
.. versionchanged:: 1.6
In previous versions, ``LocaleMiddleware`` wasn't enabled by default.
Because middleware order matters, you should follow these guidelines:
* Make sure it's one of the first middlewares installed. * Make sure it's one of the first middlewares installed.
* It should come after ``SessionMiddleware``, because ``LocaleMiddleware`` * It should come after ``SessionMiddleware``, because ``LocaleMiddleware``