Django-Admin-View-Permission 项目安装与配置指南

项目概述

Django-Admin-View-Permission 是一个为 Django 后台管理系统增强视图级别权限控制的扩展包。它允许管理员更精细地控制用户在 Django Admin 界面中可以查看哪些模型和页面，而不仅仅是控制增删改查操作权限。

安装步骤

通过 pip 安装

推荐使用 Python 包管理工具 pip 进行安装：

pip install django-admin-view-permission

安装开发版本

如果需要测试即将发布的新版本，可以安装开发版本：

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

系统要求

Django 版本支持

该项目支持以下 Django 版本：

• Django 1.8
• Django 1.9
• Django 1.10
• Django 1.11
• Django 2.0

Python 版本支持

兼容的 Python 版本包括：

• Python 2.7
• Python 3.4
• Python 3.5
• Python 3.6

配置指南

基本配置

1. 确保 django.contrib.admin 已正确配置
2. 在 INSTALLED_APPS 中添加 admin_view_permission 应用：

INSTALLED_APPS = [
    'admin_view_permission',
    # 其他应用...
    'django.contrib.admin',
    # 其他应用...
]

3. 运行数据库迁移命令以创建视图权限表：

python manage.py migrate

自定义 AdminSite 配置

如果项目中使用了自定义的 AdminSite，为了使视图权限生效，需要从 AdminViewPermissionAdminSite 类继承：

from admin_view_permission.admin import AdminViewPermissionAdminSite

class MyAdminSite(AdminViewPermissionAdminSite):
    # 自定义配置
    pass

技术原理

Django-Admin-View-Permission 通过扩展 Django 原生的权限系统，在模型级别的 CRUD 权限基础上，增加了视图级别的控制。它在数据库中创建了额外的表来存储视图权限信息，并通过中间件或装饰器实现对视图访问的拦截和验证。

常见问题

1. 为什么安装后权限没有生效？

   • 检查是否已正确添加到 INSTALLED_APPS
   • 确认是否运行了迁移命令
   • 如果使用自定义 AdminSite，确保继承自 AdminViewPermissionAdminSite

2. 如何升级版本？

   • 使用 pip 的升级命令：pip install --upgrade django-admin-view-permission

3. 支持 Django 3.x 吗？

   • 根据文档，目前官方支持到 Django 2.0，更高版本可能需要测试兼容性

最佳实践

1. 在生产环境使用稳定版本而非开发版本
2. 在开发环境充分测试权限配置
3. 定期检查新版本发布以获取安全更新和功能改进
4. 对于复杂权限需求，考虑结合 Django 原生权限系统一起使用

通过本文的指导，开发者可以顺利安装和配置 Django-Admin-View-Permission，为 Django 后台管理系统添加更精细的视图级别权限控制功能。