Skip to main content

Really full django read only admin implementation

Project description

Travis Coverage Codacy Requires pypi-license pypi-version pypi-python-version pypi-django-version pypi-format pypi-wheel pypi-status

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

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.

# settings.py

INSTALLED_APPS += (
    "read_only_admin",
)
  • Run django-admin migrate.

  • Then add user/group change/delete/add/readonly model permissions.

django-read-only-admin 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 (exclude superusers) or just remove delete selected action. Defaults to: True.

Usage

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

# admin.py

from read_only_admin.admin import ReadonlyAdmin

class MyCustomAdmin(ReadonlyAdmin):

    pass

Also tabular and stacked inlines are supported.

# admin.py

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.

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.

Project details


Release history Release notifications | RSS feed

This version

0.2.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-read-only-admin-0.2.1.zip (23.2 kB view hashes)

Uploaded Source

Built Distribution

django_read_only_admin-0.2.1-py2.py3-none-any.whl (14.4 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page