Metadata-Version: 1.1
Name: django-devicetype-templates
Version: 0.1.2
Summary: Django library to serve different templates for diferent device types
Home-page: https://bitbucket.org/whit/django-devicetype-templates
Author: Vitek Pliska
Author-email: whit@jizak.cz
License: BSD License
Description: django-devicetype-templates
        ===========================
        
        django-devicetype-templates is a library that detect device type by browser's user agent string
        and serves different templates for each type.
        
        
        Requirements
        ------------
        
            * Django >= 1.3
            * It uses `process_template_response`_ middleware method, so your views should returns ``TemplateResponse``.
        
        
        Installation
        ------------
        
        Install from PyPi::
        
            pip install django-devicetype-templates
        
        
        Install development version to virtualenv::
        
            git clone https://bitbucket.org/whit/django-devicetype-templates.git
            cd django-devicetype-templates
            python setup.py develop
        
        
        .. _process_template_response: https://docs.djangoproject.com/en/dev/topics/http/middleware/#process_template_response
        
        
        Configuration
        -------------
        
        Add middleware::
        
            MIDDLEWARE_CLASSES = (
                ...
                'devicetype.middleware.DeviceTypeMiddleware',
            )
        
        If you need to use some variables in your templates, you can add devicetype context processor::
        
            TEMPLATE_CONTEXT_PROCESSORS = (
                ...
                'devicetype.context_processors.devicetype',
            )
        
        Then, in templates will be available these variables: ``devicetype``, ``is_mobile``
        and ``big_resolution`` (not implemented yet).
        
        
        Other settings
        --------------
        
        ``DEVICETYPE_TEMPLATE_PREFIX``
        ------------------------------
        
        Prefixes are variable. When you need prefix template file name, use something like ``tablet-``. If you want to have
        device-specific templates in subfolders, you can use ``tablet/`` prefix for example.
        
        Default::
        
            {
                'desktop': '',
                'mobile': 'mobile/',
                'tablet': 'tablet/',
            }
        
        ``DEVICETYPE_PREFIX_BASENAME``
        ------------------------------
        
        When you use folder-like prefix, like `tablet/` and `mobile/`, with this setting
        you can select how subfolders will be detected.
        
        With ``DEVICETYPE_PREFIX_BASENAME = False`` (default)::
        
            tablet/base.html
            tablet/app/app_base.html
            tablet/layout/three-cols.html
            ...
        
        With ``DEVICETYPE_PREFIX_BASENAME = True``::
        
            tablet/base.html
            app/tablet/app_base.html
            layout/tablet/three-cols.html
            ...
        
        
        ``DEVICETYPE_MOBILE_PATTERNS`` and ``DEVICETYPE_TABLET_PATTERNS``
        -----------------------------------------------------------------
        
        You can override default search patterns. It search in tablet patterns first.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
