tgext.langdomain

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.