Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
djangoacl
tests
.gitignore
LICENSE
README.rst Update Readme Oct 8, 2015
requirements.txt
setup.py

README.rst

DJANGO-ACL

Django has a built in permissions system, but all the permissions are more directly related to models. This is meant to extend that system by adding permissions, or actions, not related specifically to models.

This also adds an ACL aspect to Django-CMS as an optional feature. See Documentation (cmsacl) below.

Documentation (djangoacl)

Add to INSTALLED APPS

Add the module to your installed apps.

INSTALLED_APS = (
    ...
    'djangoacl'
)

Authentication Backend

Add the new authentication backend to AUTHENTICATION_BACKENDS in settings.py

AUTHENTICATION_BACKENDS = (
    ...
    'djangoacl.auth.backends.ACLBackend',
)

Run migrations

$ python manage.py migrate djangoacl

Add the action

Go to http://yoursite/admin/djangoacl/action/add/ and add the action.

Give the action a name. This can be pretty much anything you want but recommend no spaces or special characters. Also probably best not to use anything that matches then normal permission patters such as <action>_<model> or <model>.<action>

Make sure to add any related users or groups.

Request Permission

Request permission in the normal way using the permission_required decorator. See https://docs.djangoproject.com/en/1.8/topics/auth/default/#the-permission-required-decorator

Documentation (djangoacl)

Add to INSTALLED APPS

Add the module to your installed apps.

INSTALLED_APS = (
    ...
    'djangoacl.cmsacl'
)

Register the MenuModifier

You will want to put this somewhere you know will be run before as soon as possible. I would recommend in your urls or somewhere similar. This will keep the pages from showing up in the menu if the user does not have permissions.

from menus.menu_pool import menu_pool
menu_pool.register_modifier(ACLModifier)

Add the new Middleware

Add the new middleware to MIDDLEWARE_CLASSES in settings.py

MIDDLEWARE_CLASSES = (
    ...
    'djangoacl.cmsacl.middleware.CMSPageACL',
)

Run migrations

$ python manage.py migrate cmsacl

Add the action

Go to http://yoursite/admin/cmsacl/action/add/ and add the action.

Give the action a name. This can be pretty much anything you want but recommend no spaces or special characters. Also probably best not to use anything that matches then normal permission patters such as <action>_<model> or <model>.<action>

Attach a page to the action.

Make sure to add any related users or groups.

You can’t perform that action at this time.