Metadata-Version: 1.0
Name: django-mobi
Version: 0.1.6
Summary: Django middleware and view decorator to detect phones and small-screen devices
Home-page: https://bitbucket.org/kencochrane/django-mobi/
Author: Ken Cochrane
Author-email: KenCochrane@gmail.com
License: UNKNOWN
Description: Author: Ken Cochrane
        Fork of: http://minidetector.googlecode.com
        Fork Description: I reorganized the code, added caching, and made a few tweaks here and there.
        Description: Django middleware and view decorator to detect phones and small-screen devices
        Version: 0.1.6
        Last Update: 9/30/2011
        
        Requirements:
        -------------
        Django 1.1 or newer
        Django caching to be enabled if you want to cache the objects
        
        How to use:
        -----------
        Using django-mobi is very simple. Simply place the mobi package into your project's path, and then do one of the following:
        
        
        Using the mobi.MobileDetectionMiddleware Middleware
        ---------------------------------------------------
        This middleware will scan all incoming requests to see if it is a mobile device. If it is it will set the request.mobile property to True.
        
        To use all you have to do is add mobi.MobileDetectionMiddleware to your MIDDLEWARE_CLASSES tuple in your settings.py
        
        Then in your view you can check request.mobile - if it's True then treat it like a small screen device. If it's False then it's probably a desktop browser, or a spider or something else.
        
        If you want to have some items not triggered by the middleware (for example iPad) then add a settings called MOBI_USER_AGENT_IGNORE_LIST and add the item to the list.
         
        MOBI_USER_AGENT_IGNORE_LIST = list('ipad')
        
        Using the mobi.MobileRedirectMiddleware Middleware
        ---------------------------------------------------
        This middleware will scan all incoming requests to see if it is a mobile device, if so it will redirect the request to a different URL. This is good if you want to force all mobile traffic to a mobile only version of your site.
        
        To use all you have to do is add mobi.MobileRedirectMiddleware to your MIDDLEWARE_CLASSES tuple in your settings.py, and also add MOBI_REDIRECT_URL = "http://example.mobi" where http://example.mobi is the website you want to redirect all mobile traffic.
        
        
        Not using the Middleware
        ------------------------
        If you only have certain views that need the distinction, you can choose not to search every request you receive. All you need to do is wrap the relevant views like this:
        
        from mobi.decorators import detect_mobile
        
        @detect_mobile
        def my_mobile_view(request):
            if request.mobile:
                #do something with mobile
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
