A django-read-only-admin documentation

django-read-only-admin is a django reusable application that fully implement read only admin

Contents

Installation
Configuration
Usage
Settings
Licensing
Contacts

Installation

Obtain your copy of source code from the git repository: git clone https://github.com/vint21h/django-read-only-admin.git. Or download the latest release from https://github.com/vint21h/django-read-only-admin/tags/.
Run python ./setup.py install from the repository source tree or the unpacked archive. Or use pip: pip install django-read-only-admin.

Configuration

Add "read_only_admin" to settings.INSTALLED_APPS.

INSTALLED_APPS += (
    "read_only_admin",
)

Run ./manage.py migrate for django modern versions (>= 1.7) or ./manage.py syncdb for legacy django versions (< 1.7). Then add user/group change/delete/add/readonly model permissions.

Usage

Just inherit your custom django admin class from read_only_admin.admin.ReadonlyAdmin.

For example:

from read_only_admin.admin import ReadonlyAdmin

class MyCustomAdmin(ReadonlyAdmin):

    pass

Also tabular and stacked inlines are supported.

For example:

from read_only_admin.admin import (
    ReadonlyStackedInline,
    ReadonlyTabularInline,
)

class MyCustomTabularInline(ReadonlyTabularInline):

    model = MyModel
    extra = 0


class MyCustomStackedInline(ReadonlyStackedInline):

    model = MyModel
    extra = 0

If you use list_editable in your custom admin classes, copy read_only_admin/templates/admin/pagination.html to your project templates/admin directory.

Settings

READONLY_ADMIN_PERMISSION_PREFIX: Read only permission prefix. Defaults to: readonly.
READONLY_ADMIN_PERMISSION_NAME_PREFIX: Read only permission name prefix. Defaults to: Read only.
READONLY_ADMIN_EMPTY_ACTIONS: Empty admin actions list or just remove delete selected action. Defaults to: True.

Licensing

django-read-only-admin uses the MIT license. Please check the MIT-LICENSE file for more details.

Some part of code fairly stolen from teh internets with reference to source. So, if you author of this code, please contact me.

Contacts

Project Website: https://github.com/vint21h/django-read-only-admin/

Author: Alexei Andrushievich <vint21h@vint21h.pp.ua>

For other authors list see AUTHORS file.