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

Merge pull request #1374 from seocam/fix_i18n_docs 

LocaleMiddleware isn't default anymore (corrected docs)
This commit is contained in:
Tim Graham 2013-07-19 03:35:46 -07:00
parent 4aa006efd0 cf6c754629
commit e1c737b62f
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``