80e1270587
The old-style chinese language codes used in django 1.4 series are now deprecated, as discussed here: https://code.djangoproject.com/ticket/18419. Although majority of browsers still use the old-style language codes, some new browsers such as IE11 in Windows 8.1 start to use the new-style names instead of old-style ones which makes the current chinese translations of edX can't work properly under these browsers. As there is no easy way for edX to change a higher version of django, I think we could do some mapping here so that the users who use IE11 in Windows 8.1 or other browsers that use the new-style names can view correct translations. Also, this fix will make users who use one of the language codes: zh-hk , zh-sg and zh-mo can see the correct translations.
129 lines
4.8 KiB
Python
129 lines
4.8 KiB
Python
"""
|
|
Middleware for dark-launching languages. These languages won't be used
|
|
when determining which translation to give a user based on their browser
|
|
header, but can be selected by setting the ``preview-lang`` query parameter
|
|
to the language code.
|
|
|
|
Adding the query parameter ``clear-lang`` will reset the language stored
|
|
in the user's session.
|
|
|
|
This middleware must be placed before the LocaleMiddleware, but after
|
|
the SessionMiddleware.
|
|
"""
|
|
|
|
from django.utils.translation.trans_real import parse_accept_lang_header
|
|
|
|
from dark_lang.models import DarkLangConfig
|
|
|
|
|
|
def dark_parse_accept_lang_header(accept):
|
|
'''
|
|
The use of 'zh-cn' for 'Simplified Chinese' and 'zh-tw' for 'Traditional Chinese'
|
|
are now deprecated, as discussed here: https://code.djangoproject.com/ticket/18419.
|
|
The new language codes 'zh-hans' and 'zh-hant' are now used since django 1.7.
|
|
Although majority of browsers still use the old language codes, some new browsers
|
|
such as IE11 in Windows 8.1 start to use the new ones, which makes the current
|
|
chinese translations of edX don't work properly under these browsers.
|
|
This function can keep compatibility between the old and new language codes. If one
|
|
day edX uses django 1.7 or higher, this function can be modified to support the old
|
|
language codes until there are no browsers use them.
|
|
'''
|
|
browser_langs = parse_accept_lang_header(accept)
|
|
django_langs = []
|
|
for lang, priority in browser_langs:
|
|
lang = CHINESE_LANGUAGE_CODE_MAP.get(lang.lower(), lang)
|
|
django_langs.append((lang, priority))
|
|
return django_langs
|
|
|
|
# If django 1.7 or higher is used, the right-side can be updated with new-style codes.
|
|
CHINESE_LANGUAGE_CODE_MAP = {
|
|
# The following are the new-style language codes for chinese language
|
|
'zh-hans': 'zh-CN', # Chinese (Simplified),
|
|
'zh-hans-cn': 'zh-CN', # Chinese (Simplified, China)
|
|
'zh-hans-sg': 'zh-CN', # Chinese (Simplified, Singapore)
|
|
'zh-hant': 'zh-TW', # Chinese (Traditional)
|
|
'zh-hant-hk': 'zh-TW', # Chinese (Traditional, Hongkong)
|
|
'zh-hant-mo': 'zh-TW', # Chinese (Traditional, Macau)
|
|
'zh-hant-tw': 'zh-TW', # Chinese (Traditional, Taiwan)
|
|
# The following are the old-style language codes that django does not recognize
|
|
'zh-hk': 'zh-TW', # Chinese (Traditional, Hongkong)
|
|
'zh-mo': 'zh-TW', # Chinese (Traditional, Macau)
|
|
'zh-sg': 'zh-CN', # Chinese (Simplified, Singapore)
|
|
}
|
|
|
|
|
|
class DarkLangMiddleware(object):
|
|
"""
|
|
Middleware for dark-launching languages.
|
|
|
|
This is configured by creating ``DarkLangConfig`` rows in the database,
|
|
using the django admin site.
|
|
"""
|
|
|
|
@property
|
|
def released_langs(self):
|
|
"""
|
|
Current list of released languages
|
|
"""
|
|
return DarkLangConfig.current().released_languages_list
|
|
|
|
def process_request(self, request):
|
|
"""
|
|
Prevent user from requesting un-released languages except by using the preview-lang query string.
|
|
"""
|
|
if not DarkLangConfig.current().enabled:
|
|
return
|
|
|
|
self._clean_accept_headers(request)
|
|
self._activate_preview_language(request)
|
|
|
|
def _is_released(self, lang_code):
|
|
"""
|
|
``True`` iff one of the values in ``self.released_langs`` is a prefix of ``lang_code``.
|
|
"""
|
|
return any(lang_code.lower().startswith(released_lang.lower()) for released_lang in self.released_langs)
|
|
|
|
def _format_accept_value(self, lang, priority=1.0):
|
|
"""
|
|
Formats lang and priority into a valid accept header fragment.
|
|
"""
|
|
return "{};q={}".format(lang, priority)
|
|
|
|
def _clean_accept_headers(self, request):
|
|
"""
|
|
Remove any language that is not either in ``self.released_langs`` or
|
|
a territory of one of those languages.
|
|
"""
|
|
accept = request.META.get('HTTP_ACCEPT_LANGUAGE', None)
|
|
if accept is None or accept == '*':
|
|
return
|
|
|
|
new_accept = ", ".join(
|
|
self._format_accept_value(lang, priority)
|
|
for lang, priority
|
|
in dark_parse_accept_lang_header(accept)
|
|
if self._is_released(lang)
|
|
)
|
|
|
|
request.META['HTTP_ACCEPT_LANGUAGE'] = new_accept
|
|
|
|
def _activate_preview_language(self, request):
|
|
"""
|
|
If the request has the get parameter ``preview-lang``,
|
|
and that language doesn't appear in ``self.released_langs``,
|
|
then set the session ``django_language`` to that language.
|
|
"""
|
|
if 'clear-lang' in request.GET:
|
|
if 'django_language' in request.session:
|
|
del request.session['django_language']
|
|
|
|
preview_lang = request.GET.get('preview-lang', None)
|
|
|
|
if not preview_lang:
|
|
return
|
|
|
|
if preview_lang in self.released_langs:
|
|
return
|
|
|
|
request.session['django_language'] = preview_lang
|