======================== django-oscar-impersonate

:Info: Wrapper of django-impersonate for django-oscar :Version: 0.1.3 :Author: Nicolas Dubois nicolas.dubois@oscaro.com

Dependencies

• It was written for Python 3.3+ and Django 1.6+
• It depends on your project using the django.contrib.session framework (requirement from django-impersonate)

Installation

.. code::

$ pip install django-oscar-impersonate

Use

django-oscar-impersonate relies on `django-impersonate (which is installed )

. Add impersonate to your INSTALLED_APPS

.. code:: python

    INSTALLED_APPS = (
        # …
        'impersonate',
    )

. Add django-oscar-impersonate middleware

.. code:: python

    MIDDLEWARE_CLASSES = (
        # …
        'oscar_impersonate.middleware.OscarImpersonateMiddleware',
    )

. Add django-impersonate URLs

.. code:: python

    urlpatterns = patterns('',
        # …
        url(r'^impersonate/', include('impersonate.urls')),
        # …
    )

. Add OSCAR_IMPERSONATE_TEMPLATE_DIRS to TEMPLATE_DIRS, before Oscar's

.. code:: python

    from oscar import OSCAR_MAIN_TEMPLATE_DIR
    from oscar_impersonate import OSCAR_IMPERSONATE_TEMPLATE_DIR

    TEMPLATE_DIRS = (
        # …
        OSCAR_IMPERSONATE_TEMPLATE_DIR,
        OSCAR_MAIN_TEMPLATE_DIR,
    )

Functionality and custom settings

Dashboard

django-oscar-impersonate adds a “Log as” button on customers' dashboard:

.. image:: docs/_static/images/screenshot-dashboard-customer-list.png :alt: Customer dashboard with “Log as” button

When a staff member impersonates a customer, a button appears to stop impersonation.

.. image:: docs/_static/images/screenshot-dashboard-customer-list-impersonation.png :alt: Customer dashboard with ”Stop impersonation button

Toolbar

When a staff member impersonates a customer, a small toolbar appears at the top to display who is impersonated

.. image:: docs/_static/images/screenshot-sandbox-homepage-impersonation.png :alt: Homepage from Oscar sandbox

Other

For other features and custom settings, please check django-impersonate's docs.

License

BSD License