About BrowserLimit

Browserlimit is a TurboGears2 extension meant to quickly limit access to a website only to modern browsers. BrowserLimit requires TurboGears2.1.4 or newer.

Installing

tgext.browerlimit can be installed both from pypi or from bitbucket:

easy_install tgext.browserlimit

should just work for most of the users

Enabling BrowserLimit

Using BrowserLimit is quite simple, you can just plug it using tgext.pluggable.

If you want to avoid using tgext.pluggable for any reason it is still possible to use tgext.browserlimit by manually setting it up. At the end of your application config/app_cfg.py import tgext.browserlimit:

import tgext.browserlimit
tgext.browserlimit.plugme(base_config, {})

Choosing Browser Limits

By default tgext.browserlimit will limit site access to browsers which have a fairly compatible HTML4 support, those include IE8, Chrome4, Firefox3.6, Safari3.2

This can be changed by specifying the base_config.browserlimit option inside your config/app_cfg.py before loading browserlimit. Valid values are:

• MODERN -> Most modern browsers with top edge features

• HTML5 -> Minimal HTML5 support like video and canvas

• BASIC -> Good HTML4 support (the default)

• MINIMAL -> Cover as much as possible (minimum IE version 7)

New limits can be enabled using the base_config.browserlimits option. This must be a dictionary where the KEY is the limit name and the value is a class that implements __init__(self, user_agent) and is_met(self, environ) -> bool methods.