Django SubAdmin 使用教程

Django SubAdmin 使用教程

django-subadminA special kind of ModelAdmin that allows it to be nested within another ModelAdmin 项目地址:https://gitcode.com/gh_mirrors/dj/django-subadmin

项目介绍

Django SubAdmin 是一个特殊的 ModelAdmin，允许它嵌套在另一个 ModelAdmin 实例中。类似于 Django 内置的 InlineModelAdmin，它允许编辑相关对象，但不是内联方式，而是提供一个完整的 ModelAdmin 作为父 ModelAdmin 的子管理员。它适用于通过 ForeignKey 相关联的模型。

项目快速启动

安装

首先，从 PyPI 安装 django-subadmin：

pip install django-subadmin

配置

在项目的 settings.py 文件中，添加 subadmin 到 INSTALLED_APPS：

INSTALLED_APPS = (
    ...
    'subadmin',
    ...
)

示例代码

假设我们有一个 MailingList 模型和一个相关的 Subscriber 模型。我们可以这样设置 SubAdmin：

from django.contrib import admin
from subadmin.admin import SubAdmin
from .models import MailingList, Subscriber

class SubscriberSubAdmin(SubAdmin):
    model = Subscriber
    list_display = ('email', 'joined')

class MailingListAdmin(admin.ModelAdmin):
    list_display = ('name', 'description')
    inlines = [SubscriberSubAdmin]

admin.site.register(MailingList, MailingListAdmin)

然后运行服务器：

python manage.py runserver

打开浏览器并访问 Django 管理界面（http://127.0.0.1:8000/admin/），登录并探索 MailingList 部分以查看 django-subadmin 的实际应用。

应用案例和最佳实践

应用案例

Django SubAdmin 特别适用于需要多级嵌套管理界面的场景，例如：

• 邮件列表管理：一个邮件列表可以有多个订阅者，SubAdmin 允许在邮件列表的管理界面中直接管理订阅者。
• 项目管理：一个项目可以有多个任务，SubAdmin 允许在项目管理界面中直接管理任务。

最佳实践

• 保持简洁：避免过度嵌套，确保管理界面仍然直观易用。
• 权限控制：确保只有授权用户可以访问和编辑嵌套的 SubAdmin。
• 性能优化：对于大型数据集，考虑分页或其他性能优化措施。

典型生态项目

Django SubAdmin 可以与以下 Django 生态项目结合使用：

• Django Rest Framework：结合 DRF 创建 RESTful API，提供更丰富的数据交互。
• Django Filters：增强管理界面的过滤功能，提供更灵活的数据筛选。
• Django Crispy Forms：美化管理界面的表单，提升用户体验。

通过这些生态项目的结合，可以进一步扩展和优化 Django SubAdmin 的功能和性能。

django-subadminA special kind of ModelAdmin that allows it to be nested within another ModelAdmin 项目地址:https://gitcode.com/gh_mirrors/dj/django-subadmin