Admin 站点定制
在 Django 中，Admin 站点是一个非常强大的工具，它允许开发者快速地管理应用程序的数据。默认情况下，Django 提供了一个基本的 Admin 界面，但通过定制，你可以使其更符合你的需求。本教程将详细介绍如何定制 Django 的 Admin 站点。
1. 模型注册和配置
1.1 注册模型
首先，你需要将你的模型注册到 Admin 站点。假设你有一个 Book 模型：
from django.db import models
class Book(models.Model):
title = models.CharField(max_length=100)
author = models.CharField(max_length=100)
published_date = models.DateField()
def __str__(self):
return self.title
在 admin.py 文件中注册这个模型：
from django.contrib import admin
from .models import Book
admin.site.register(Book)
1.2 配置模型显示
你可以通过继承 admin.ModelAdmin 类来配置模型在 Admin 站点中的显示方式。例如，你可以指定要显示的字段、搜索字段、过滤器等。
from django.contrib import admin
from .models import Book
class BookAdmin(admin.ModelAdmin):
list_display = ('title', 'author', 'published_date')
list_filter = ('author', 'published_date')
search_fields = ('title', 'author')
admin.site.register(Book, BookAdmin)
2. 自定义 Admin 操作
2.1 添加自定义操作
你可以为 Admin 站点添加自定义操作，例如批量操作或单个对象操作。假设你想为 Book 模型添加一个“标记为已读”的操作：
from django.contrib import admin
from .models import Book
class BookAdmin(admin.ModelAdmin):
list_display = ('title', 'author', 'published_date', 'is_read')
list_filter = ('author', 'published_date', 'is_read')
search_fields = ('title', 'author')
actions = ['mark_as_read']
def mark_as_read(self, request, queryset):
queryset.update(is_read=True)
mark_as_read.short_description = "标记选中的书籍为已读"
admin.site.register(Book, BookAdmin)
2.2 自定义操作的权限控制
你可以通过 @admin.action 装饰器来控制自定义操作的权限：
from django.contrib import admin
from .models import Book
class BookAdmin(admin.ModelAdmin):
list_display = ('title', 'author', 'published_date', 'is_read')
list_filter = ('author', 'published_date', 'is_read')
search_fields = ('title', 'author')
@admin.action(description="标记选中的书籍为已读")
def mark_as_read(self, request, queryset):
queryset.update(is_read=True)
admin.site.register(Book, BookAdmin)
3. Admin 主题和样式
3.1 使用第三方 Admin 主题
Django 允许你使用第三方 Admin 主题来美化 Admin 站点。例如，你可以使用 django-admin-bootstrap 主题：
pip install django-admin-bootstrap
在 settings.py 中添加主题：
INSTALLED_APPS = [
...
'django_admin_bootstrap',
...
]
3.2 自定义 Admin 样式
你也可以通过覆盖 Admin 的 CSS 文件来自定义样式。在 static/admin/css/ 目录下创建一个 custom.css 文件：
/* custom.css */
body {
background-color: #f8f9fa;
}
然后在 settings.py 中指定静态文件路径：
STATICFILES_DIRS = [
BASE_DIR / "static",
]
4. 权限和分组管理
4.1 创建用户组
你可以通过 Admin 站点创建用户组，并为组分配权限：
from django.contrib.auth.models import Group, Permission
group, created = Group.objects.get_or_create(name='图书管理员')
permissions = Permission.objects.filter(codename__in=['add_book', 'change_book', 'delete_book'])
group.permissions.set(permissions)
4.2 为用户分配组
你可以为用户分配组，从而控制他们的权限：
from django.contrib.auth.models import User, Group
user = User.objects.get(username='admin')
group = Group.objects.get(name='图书管理员')
user.groups.add(group)
5. 实践练习
5.1 练习：自定义 Admin 操作
- 创建一个新的 Django 项目和一个应用。
- 定义一个
Book模型，并注册到 Admin 站点。 - 为
Book模型添加一个自定义操作，例如“标记为未读”。 - 配置 Admin 站点以显示自定义操作。
5.2 练习：自定义 Admin 样式
- 使用
django-admin-bootstrap主题美化 Admin 站点。 - 创建一个自定义 CSS 文件，修改 Admin 站点的背景颜色。
- 在
settings.py中配置静态文件路径，确保自定义样式生效。
通过本教程，你应该已经掌握了如何定制 Django 的 Admin 站点。从模型注册、自定义操作到样式和权限管理，Django 提供了丰富的工具来满足你的需求。继续探索和实践，你将能够创建一个功能强大且美观的 Admin 界面。