Welcome to Django Admin View Permission’s documentation!

Contents:

Installation

Getting the code

The recommended way to install the Admin View Permission is via pip:

$ pip install django-admin-view-permission

To test an upcoming release, you can install the in-development version instead with the following command:

$ pip install -e git+https://github.com/django-admin-view-permission/django-admin-view-permission.git#egg=django-admin-view-permission

Requirements

• Django

Support

• Django: 1.8, 1.9
• Python: 2.7, 3.4, 3.5

Setup

Make sure that 'django.contrib.admin' is set up properly and add 'admin_view_permission' to your INSTALLED_APPS setting:

INSTALLED_APPS = [
    'admin_view_permission',
    # ...
    'django.contrib.admin',
    # ...
]

Finally, run python manage.py migrate to create the view permissions.

Configuration

The admin view permission provides one setting that you can add in your project’s settings module to customize its behavior.

ADMIN_VIEW_PERMISSION_MODELS

This setting defines which models you want to be added the view permission. If you don’t specify this setting then the view permission will be applied to all the models.

Example

ADMIN_VIEW_PERMISSION_MODELS = [
    auth.User,
    ...
]

Uninstall

To remove the application completely firstly remove the admin_view_permission from your INSTALLED_APPS setting and then open a debug shell and execute the following commands in order to remove these extra permissions from the database:

from django.contrib.auth.models import Permission
permissions = Permission.objects.filter(codename__startswith='view')
permissions.delete()

Notice: Before delete the permission would be helpful to check if the permissions queryset contains only the view permissions and not anything else.