A django package that allows easy identification of visitors' browser, operating system and device information (mobile phone, tablet or has touch capabilities).
Project description
Public version 0.3.1
==================
Fork: https://github.com/selwin/django-user_agents
Django User Agents
==================
A django package that allows easy identification of visitor's browser, OS and device information,
including whether the visitor uses a mobile phone, tablet or a touch capable device. Under the hood,
it uses `user-agents <https://github.com/selwin/python-user-agents>`_.
Installation
============
1. Install ``django-user-agents``, you'll have to make sure that `user-agents`_ is installed first::
pip install pyyaml ua-parser user-agents
pip install django-user-agents
2. Configure ``settings.py``:
.. code-block:: python
INSTALLED_APPS = (
# Other apps...
'django_user_agents',
)
# Cache backend is optional, but recommended to speed up user agent parsing
CACHES = {
'default': {
'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
'LOCATION': '127.0.0.1:11211',
}
}
# Name of cache backend to cache user agents. If it not specified default
# cache alias will be used. Set to `None` to disable caching.
USER_AGENTS_CACHE = 'default'
Usage
=====
Middleware
----------
Add ``UserAgentMiddleware`` in ``settings.py``:
.. code-block:: python
MIDDLEWARE_CLASSES = (
# other middlewares...
'django_user_agents.middleware.UserAgentMiddleware',
)
A ``user_agent`` attribute will now be added to ``request``, which you can use
in ``views.py``:
.. code-block:: python
def my_view(request):
# Let's assume that the visitor uses an iPhone...
request.user_agent.is_mobile # returns True
request.user_agent.is_tablet # returns False
request.user_agent.is_touch_capable # returns True
request.user_agent.is_pc # returns False
request.user_agent.is_bot # returns False
# Accessing user agent's browser attributes
request.user_agent.browser # returns Browser(family=u'Mobile Safari', version=(5, 1), version_string='5.1')
request.user_agent.browser.family # returns 'Mobile Safari'
request.user_agent.browser.version # returns (5, 1)
request.user_agent.browser.version_string # returns '5.1'
# Operating System properties
request.user_agent.os # returns OperatingSystem(family=u'iOS', version=(5, 1), version_string='5.1')
request.user_agent.os.family # returns 'iOS'
request.user_agent.os.version # returns (5, 1)
request.user_agent.os.version_string # returns '5.1'
# Device properties
request.user_agent.device # returns Device(family='iPhone')
request.user_agent.device.family # returns 'iPhone'
If you have ``django.core.context_processors.request`` enabled, ``user_agent``
will also be available in template through ``request``::
{% if request.user_agent.is_mobile %}
Do stuff here...
{% endif %}
View Usage
----------
``django-user_agents`` comes with ``get_user_agent`` which takes a single
``request`` argument and returns a ``UserAgent`` instance. Example usage:
.. code-block:: python
from django_user_agents.utils import get_user_agent
def my_view(request):
user_agent = get_user_agent(request)
if user_agent.is_mobile:
# Do stuff here...
elif user_agent.is_tablet:
# Do other stuff...
Template Usage
--------------
``django-user_agents`` comes with a few template filters:
* ``is_mobile``
* ``is_tablet``
* ``is_touch_capable``
* ``is_pc``
* ``is_bot``
You can use all of these like any other django template filters::
{% load user_agents %}
{% if request|is_mobile %}
Mobile device stuff...
{% endif %}
{% if request|is_tablet %}
Tablet stuff...
{% endif %}
{% if request|is_pc %}
PC stuff...
{% endif %}
{% if request|is_touch_capable %}
Touch capable device stuff...
{% endif %}
{% if request|is_bot %}
Bot stuff...
{% endif %}
You can find out more about user agent attributes at `here <https://github.com/selwin/python-user-agents>`_.
Running Tests
=============
.. code-block:: console
`which django-admin.py` test django_user_agents --settings=django_user_agents.tests.settings --pythonpath=.
Changelog
=========
0.3.1
-----
* Fixed a bug when request have no META attribute
0.3.0
-----
* Python 3, thanks to @hwkns!
0.2.2
-----
* Fixed a bug that causes cache set/read to fail when user agent is longer than 250 characters
0.2.1
-----
* Fixed packaging
0.2.0
-----
* Added template filters
* Added ``get_user_agent`` function in utils.py
0.1.1
-----
* Fixed a ``KeyError`` exception in the case of empty ``HTTP_USER_AGENT``
0.1
---
* Initial release
==================
Fork: https://github.com/selwin/django-user_agents
Django User Agents
==================
A django package that allows easy identification of visitor's browser, OS and device information,
including whether the visitor uses a mobile phone, tablet or a touch capable device. Under the hood,
it uses `user-agents <https://github.com/selwin/python-user-agents>`_.
Installation
============
1. Install ``django-user-agents``, you'll have to make sure that `user-agents`_ is installed first::
pip install pyyaml ua-parser user-agents
pip install django-user-agents
2. Configure ``settings.py``:
.. code-block:: python
INSTALLED_APPS = (
# Other apps...
'django_user_agents',
)
# Cache backend is optional, but recommended to speed up user agent parsing
CACHES = {
'default': {
'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
'LOCATION': '127.0.0.1:11211',
}
}
# Name of cache backend to cache user agents. If it not specified default
# cache alias will be used. Set to `None` to disable caching.
USER_AGENTS_CACHE = 'default'
Usage
=====
Middleware
----------
Add ``UserAgentMiddleware`` in ``settings.py``:
.. code-block:: python
MIDDLEWARE_CLASSES = (
# other middlewares...
'django_user_agents.middleware.UserAgentMiddleware',
)
A ``user_agent`` attribute will now be added to ``request``, which you can use
in ``views.py``:
.. code-block:: python
def my_view(request):
# Let's assume that the visitor uses an iPhone...
request.user_agent.is_mobile # returns True
request.user_agent.is_tablet # returns False
request.user_agent.is_touch_capable # returns True
request.user_agent.is_pc # returns False
request.user_agent.is_bot # returns False
# Accessing user agent's browser attributes
request.user_agent.browser # returns Browser(family=u'Mobile Safari', version=(5, 1), version_string='5.1')
request.user_agent.browser.family # returns 'Mobile Safari'
request.user_agent.browser.version # returns (5, 1)
request.user_agent.browser.version_string # returns '5.1'
# Operating System properties
request.user_agent.os # returns OperatingSystem(family=u'iOS', version=(5, 1), version_string='5.1')
request.user_agent.os.family # returns 'iOS'
request.user_agent.os.version # returns (5, 1)
request.user_agent.os.version_string # returns '5.1'
# Device properties
request.user_agent.device # returns Device(family='iPhone')
request.user_agent.device.family # returns 'iPhone'
If you have ``django.core.context_processors.request`` enabled, ``user_agent``
will also be available in template through ``request``::
{% if request.user_agent.is_mobile %}
Do stuff here...
{% endif %}
View Usage
----------
``django-user_agents`` comes with ``get_user_agent`` which takes a single
``request`` argument and returns a ``UserAgent`` instance. Example usage:
.. code-block:: python
from django_user_agents.utils import get_user_agent
def my_view(request):
user_agent = get_user_agent(request)
if user_agent.is_mobile:
# Do stuff here...
elif user_agent.is_tablet:
# Do other stuff...
Template Usage
--------------
``django-user_agents`` comes with a few template filters:
* ``is_mobile``
* ``is_tablet``
* ``is_touch_capable``
* ``is_pc``
* ``is_bot``
You can use all of these like any other django template filters::
{% load user_agents %}
{% if request|is_mobile %}
Mobile device stuff...
{% endif %}
{% if request|is_tablet %}
Tablet stuff...
{% endif %}
{% if request|is_pc %}
PC stuff...
{% endif %}
{% if request|is_touch_capable %}
Touch capable device stuff...
{% endif %}
{% if request|is_bot %}
Bot stuff...
{% endif %}
You can find out more about user agent attributes at `here <https://github.com/selwin/python-user-agents>`_.
Running Tests
=============
.. code-block:: console
`which django-admin.py` test django_user_agents --settings=django_user_agents.tests.settings --pythonpath=.
Changelog
=========
0.3.1
-----
* Fixed a bug when request have no META attribute
0.3.0
-----
* Python 3, thanks to @hwkns!
0.2.2
-----
* Fixed a bug that causes cache set/read to fail when user agent is longer than 250 characters
0.2.1
-----
* Fixed packaging
0.2.0
-----
* Added template filters
* Added ``get_user_agent`` function in utils.py
0.1.1
-----
* Fixed a ``KeyError`` exception in the case of empty ``HTTP_USER_AGENT``
0.1
---
* Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-user-agents-last-0.3.1.tar.gz
.
File metadata
- Download URL: django-user-agents-last-0.3.1.tar.gz
- Upload date:
- Size: 7.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3621a59bbcbc686a6477a2e9c24a1bbac3b1fde50f3c562567e8a3ecdb4dda01 |
|
MD5 | 8f7baefebcab54f04c4bab967a8f51f2 |
|
BLAKE2b-256 | c1c99f9d12504ccb72b767d7692da3a08745db178b1da5f578db7fec76d930ef |