Skip to main content

Manages to load templates according to the type of device to a specific directory prefix.

Project description

Manages to load templates according to the type of device to a specific directory prefix.

These loaders work with the django-mobi app. Please read the documentation for more information: https://pypi.python.org/pypi/django-mobi

Install

It is strongly recommanded to install this theme from GIT with PIP onto you project virtualenv.

From PyPi

pip install django-adaptive

From Github

-e git+https://github.com/RevSquare/django-adaptive#egg=django-adaptive

Setup

Before starting, make sure you have correctly setup django-mobi: https://pypi.python.org/pypi/django-mobi

Django adaptive basicaly overwrites django default filesystem and app_directories loaders. You can pick the overwritten loader you want to use separately and use them concurently with the former django loaders.

The first step is to add the app in your installed apps list in settings.py

INSTALLED_APPS = (
    ...
    'django_adaptive'
    ...
)

Then you will need to declare the loaders you want to add in your settings.py file

TEMPLATE_LOADERS = (
    'django-adaptive.filesystem.Loader',
    'django-adaptive.app_directories.Loader',
    #'django.template.loaders.filesystem.Loader',
    #'django.template.loaders.app_directories.Loader',
)

It’s also possible to use cached loader. It works with django 1.7.x

TEMPLATE_LOADERS = (
('django_adaptive.cached.Loader', (
    'django_adaptive.filesystem.Loader',
    'django_adaptive.app_directories.Loader',
    )),
)

Final step is to add ThreadLocal Middleware

MIDDLEWARE_CLASSES = (
    ...
    'mobi.middleware.MobileDetectionMiddleware',
    'django_adaptive.middleware.ThreadLocals',
    ...
)

Declaring your device prefixes

At this stage nothing will be done. You need to specify the directories for each device categories in your settings.py.

The settings constants are:

  • ADAPTIVE_TEMPLATE_DIRECTORIES_DESKTOP

  • ADAPTIVE_TEMPLATE_DIRECTORIES_TABLET

  • ADAPTIVE_TEMPLATE_DIRECTORIES_MOBILE

Usage exemple:

import os

DEBUG = True
TEMPLATE_DEBUG = DEBUG

PROJECT_PATH = os.path.join(os.path.dirname(__file__), '..')

TEMPLATE_DIRS = (
    os.path.join(PROJECT_PATH, 'templates')
)

ADAPTIVE_TEMPLATE_DIRECTORIES_MOBILE = 'mobile'

This code will install the templates for mobile in the templates/mobile directory. And the rest of the files in templates (by default no prefix is added).

In case you would need to combine devices type in a similar directory, you just need to point them to it. For exemple:

ADAPTIVE_TEMPLATE_DIRECTORIES_DESKTOP = 'desktop'
ADAPTIVE_TEMPLATE_DIRECTORIES_TABLET = 'mobile'
ADAPTIVE_TEMPLATE_DIRECTORIES_MOBILE = 'mobile'

This would render the same type of template for both tablets and mobile devices.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-adaptive-1.0.2.tar.gz (4.9 kB view details)

Uploaded Source

File details

Details for the file django-adaptive-1.0.2.tar.gz.

File metadata

File hashes

Hashes for django-adaptive-1.0.2.tar.gz
Algorithm Hash digest
SHA256 0711dca08d9d85f13cf8796f9350ba0df00f52c35743c10073c6ce1d304814da
MD5 1fe67bc2eb4532eb76d0aede5f8ab3bb
BLAKE2b-256 d619fb2c9ad1028356c177a3a370d35e3bb81c60026d49e837db5db8d5ea381a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page