About tgext.langdomain
tgext.langdomain is a TurboGears2 extension that supports detecting the user
language from the domain it is connecting from.
Installing
tgext.langdomain can be installed from pypi::
pip install tgext.langdomain
should just work for most of the users.
Enabling
To enable tgext.langdomain put inside your application
config/app_cfg.py
the following::
import tgext.langdomain
tgext.langdomain.plugme(base_config)
or you can use tgext.pluggable
when available::
from tgext.pluggable import plug
plug(base_config, 'tgext.langdomain')
Options
langdomain will force the language of the current request based on:
Top Level Domain, SubDomain and param unless there is
already a language stored into the session.
By default none of those behaviours is enabled
When plugging langdomain the following options to turn on behaviours are available:
*param* -> Name of the GET param used to force language, ``True`` means ``lang``.
*tld* -> Dict of *tld* that map to a language
EXAMPLE::
plug(app_cfg, 'tgext.langdomain',
tld={
'com': 'en',
'it': 'it'
})
*subdomain* -> Dict of subdomains that map to a language
EXAMPLE::
plug(app_cfg, 'tgext.langdomain',
subdomain={
'en': 'en',
'it': 'it'
})
When requests are performed like it.server.net it will lookup it inside
the subdomain
dictionary and net inside the tld
dictionary.