Skip to content
This repository
Newer
Older
100644 45 lines (30 sloc) 1.637 kb
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
1 #####################################
2 Serving content in multiple languages
3 #####################################
4
5 **************
6 Basic concepts
7 **************
8
b17d2357 »
2012-06-27 Documentation cleanup: fixed typos, grammar, etc.
9 django CMS has a sophisticated multilingual capability. It is able to serve
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
10 content in multiple languages, with fallbacks into other languages where
b17d2357 »
2012-06-27 Documentation cleanup: fixed typos, grammar, etc.
11 translations have not been provided. It also has the facility for the user to set the
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
12 preferred language and so on.
13
14 How django CMS determines the user's preferred language
15 =======================================================
16
fedc753b »
2012-10-01 docs
17 django CMS determines the user's language the same way Django does it.
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
18
fedc753b »
2012-10-01 docs
19 * the language code prefix in the URL
c34025f5 »
2013-04-10 cookie middleware added
20 * the language set in the session
21 * the language in the `django_language` cookie
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
22 * the language that the browser says its user prefers
23
86fd1a10 »
2012-09-24 docs
24 It uses the django built in capabilities for this.
25
c34025f5 »
2013-04-10 cookie middleware added
26 By default no session and cookie are set. If you want to enable this use the
27 `cms.middleware.language.LanguageCookieMiddleware` to set the cookie on every request.
28
29
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
30 How django CMS determines what language to serve
31 ================================================
32
33 Once it has identified a user's language, it will try to accommodate it using the languages set in :setting:`CMS_LANGUAGES`.
34
fedc753b »
2012-10-01 docs
35 If :setting:`fallbacks` is set, and if the user's preferred
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
36 language is not available for that content, it will use the fallbacks
fedc753b »
2012-10-01 docs
37 specified for the language in :setting:`CMS_LANGUAGES`.
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
38
39 What django CMS shows in your menus
40 ===================================
41
fedc753b »
2012-10-01 docs
42 If :setting:`hide_untranslated` is ``True`` (the default) then pages that
bb4bf53d »
2012-06-16 multilingual docs added to concepts section
43 aren't translated into the desired language will not appear in the menu.
44
Something went wrong with that request. Please try again.