Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Per site permissions in django admin
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
example
site_permissions
README.rst
setup.py

README.rst

Site permissions

Site permissions django application allows restricting access to objects based on sites. Basic goal is to allow restricting managing site content to users and groups in django admin interface.

Sites permissions will add custom permission change_site_content to Site model. It depends on django-guardian.

Requiremenents

  • django-guardian
  • Django 1.2 or later

Configuration

Add site_permissions to INSTALLED_APPS:

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # Uncomment the next line to enable the admin:
    'django.contrib.admin',
    # Uncomment the next line to enable admin documentation:
    # 'django.contrib.admindocs',

    'guardian',
    'site_permissions',
)

In settings.py add authentication backends for guardian and site_permissions:

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend', # default backend
    'guardian.backends.ObjectPermissionBackend', # guardian
    "site_permissions.backends.SitePermissionBackend", # site_permissions
]

ANONYMOUS_USER_ID = -1 # required for guardian

Run syncdb to create permission for Site object:

./manage.py syncdb

This will create Can change site content permission that affect in which sites specified user or group can edit contents.

Usage

  1. Add RestrictSiteMixin mixin to admin classes:

    from django.contrib import admin
    
    from site_permissions.backends import RestrictSiteMixin
    
    from models import Category
    
    
    class CategoryAdmin(RestrictSiteMixin, admin.ModelAdmin):
        pass
    
    
    admin.site.register(Category, CategoryAdmin)
    
  2. In django admin set Can change site content object permissions for Site objects.

Example app

To test application and get a feeling how it works:

cd example
./manage.py syncdb --noinput && ./manage.py loaddata sample_data.json
./manage.py runserver

Usernames are admin and user1. Password for all users is password.

TODO

  • add admin helper to filter foreign relationships within site
  • site field name should be configurable
  • handle many to many relationship to sites
Something went wrong with that request. Please try again.