Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

87 lines (58 sloc) 2.55 KB


Multilingual URLs

If you use more than one language, django CMS urls need to be referenced via :func:`~django.conf.urls.i18n.i18n_patterns`. For more information about this see the official django documentation.

Main example:

from django.conf import settings
from django.conf.urls.defaults import patterns, include, url
from django.contrib import admin
from django.conf.urls.i18n import i18n_patterns
from django.contrib.staticfiles.urls import staticfiles_urlpatterns


urlpatterns = patterns('',
    url(r'^jsi18n/(?P<packages>\S+?)/$', 'django.views.i18n.javascript_catalog'),

urlpatterns += staticfiles_urlpatterns()

urlpatterns += i18n_patterns('',
    url(r'^admin/', include(,
    url(r'^', include('cms.urls')), # <--------- include the django cms urls via i18n_patterns

Language Chooser

The :ttag:`language_chooser` template tag will display a language chooser for the current page. You can modify the template in menu/language_chooser.html or provide your own template if necessary.


{% load menu_tags %}
{% language_chooser "myapp/language_chooser.html" %}


This template tag returns the URL of the current page in another language.


{% page_language_url "de" %}


If you add a default directive to your :setting:`CMS_LANGUAGES` with a :setting:`hide_unstranslated` to False all pages will be displayed in all languages even if they are not translated yet.

If hide_untranslated is True in your :setting:`CMS_LANGUAGES` and you are on a page that doesn't yet have an English translation and you view the German version then the language chooser will redirect to /. The same goes for urls that are not handled by the cms and display a language chooser.

Automated slug generation unicode characters

If your site has languages which use non-ASCII character sets, you might want to enable :setting:`CMS_UNIHANDECODE_HOST` and :setting:`CMS_UNIHANDECODE_VERSION` to get automated slugs for those languages too.

Jump to Line
Something went wrong with that request. Please try again.