About Mobile Middleware
Mobile Middleware is a middleware for WSGI applications.
Thought to be used on TurboGears 2 applications it detects mobile browser and provides a way to detect and react to them. Detection expression can be customized and action can change from plain detection to exposing a specific custom template for mobile requests
You will be able to see if your request is coming from a mobile browser with:
from tg import request request.is_mobile
tgext.mobilemiddleware can be installed both from pypi or from bitbucket:
should just work for most of the users
Enabling Mobile Agents Detection
In your application config/middleware.py import MobileMiddleware:
from tgext.mobilemiddleware import MobileMiddleware
Change your make_app method:
app = make_base_app(global_conf, full_stack=True, **app_conf) return MobileMiddleware(app, app_conf)
Exposing Mobile Templates
tgext.mobilemiddleware implements a @expose_mobile decorator that works like @expose TurboGears2 decorator which can be used to specify which template to expose for mobile requests.
This will work by switching the template before rendering the view if the request is detected to be from a mobile browser. @expose_mobile supports the same template naming convention that @expose uses and can accept any rendering engine that has been registered in TurboGears by specifying it as engine:module.template_name
@expose('app.templates.index') @expose_mobile('app.templates.mobile.index') def index(self, *args, **kw): return dict()
Customizing User Agents Detection
MobileMiddleware by default checks user agent with a set of regular expressions defined in DetectMobileBrowser. If you want to customize how mobile browsers are detected, you may create you own class, perhaps inheriting from DetectMobileBrowser, or callable object and supply it as an argument to MobileMiddleware, like:
return MobileMiddleware(app, app_conf, mobile_browser_detector=YourClass)
Please not that the argument to mobile_browser_detector can also be a general functor.