Django 中自定义 Admin 样式与功能

自定义 Admin 样式与功能

1 页面修改中文

1.1 语言设置为中文

settings.py

LANGUAGE_CODE = 'zh-hans'


修改结果

1.2 应用管理设置为中文

应用/apps.py

from django.apps import AppConfigclass BbssConfig(AppConfig):
name = 'bbs'
# 添加下面这句
verbose_name = 'BBS系统'


修改结果

1.3 数据库表设置为中文

应用/models.py

class Comment(models.Model):
topic = models.ForeignKey(Topic, on_delete=models.CASCADE)
comment_text = models.TextField(max_length=2000)
author = models.ForeignKey(User, default=1, on_delete=models.CASCADE)
picture = models.FileField(blank=True, null=True) # 添加文件类型字段，并默认为空
pub_date = models.DateTimeField(auto_now_add=True) def get_comment_text_md(self):
"""将markdown格式转化为html"""
return mark_safe(markdown(self.comment_text)) def __str__(self):
return self.comment_text class Meta:
verbose_name = '评论' # 单数时显示内容
verbose_name_plural = '评论' # 复数时显示内容


默认数据库表在后台中显示都为复数形式，而中文没有复数形式，因此将两种形式都设置为相同名称

修改结果

1.4 数据库表字段名称修改为中文

应用/models.py

class Comment(models.Model):
topic = models.ForeignKey(Topic, on_delete=models.CASCADE, verbose_name='话题')
comment_text = models.TextField('评价内容', max_length=2000)
author = models.ForeignKey(User, default=1, on_delete=models.CASCADE, verbose_name='用户')
picture = models.FileField('图片', blank=True, null=True) # 添加文件类型字段，并默认为空
pub_date = models.DateTimeField('发布时间', auto_now_add=True) def get_comment_text_md(self):
"""将markdown格式转化为html"""
return mark_safe(markdown(self.comment_text)) def __str__(self):
return self.comment_text class Meta:
verbose_name = '评论' # 单数时显示内容
verbose_name_plural = '评论' # 复数时显示内容


一般的字段只需加个显示名称的位置参数就可以，而一对多关系的要指定关键字参数 verbose_name，并且关键字参数要放在位置参数后面

修改结果

2 修改后台样式

使用 django-grappelli 第三方应用进行修改admin样式

GitHub：https://github.com/sehmaschine/django-grappelli

文档：https://django-grappelli.readthedocs.io/en/latest/quickstart.html

其他工具：https://djangopackages.org/grids/g/admin-interface/

2.1 安装

pip install django-grappelli


2.2 导入项目

settings.py

INSTALLED_APPS = [
'accounts.apps.AccountsConfig',
'polls.apps.PollsConfig',
'bbs.apps.BbssConfig',
'grappelli',
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
]


2.3 导入URL

项目 / urls.py

urlpatterns = [
path('grappelli', include('grappelli.urls')),
path('admin/', admin.site.urls),
path('', include('bbs.urls')),
path('accounts/', include('accounts.urls')),
]


2.4 收集静态文件统一放到一个地方

settings.py 中添加

# 收集静态文件统一存放的根路径
STATIC_ROOT = os.path.join(BASE_DIR, 'static-files')


执行命令

python manage.py collectstatic


自动生成

再次启动服务会发现管理页面已经被修改

2.5 自定义标题

settings.py 中添加

# 后台自定义标题
GRAPPELLI_ADMIN_TITLE = 'Z-BBS ADMIN'


刷新页面

2.6 admin开启分页功能

应用 / admin.py

from django.contrib import admin# Register your models here.
from .models import Topic, Commentclass TopicAdmin(admin.ModelAdmin):
list_display = ('topic_text', 'author', 'pub_date')
search_fields = ('topic_text', 'author')
list_editable = ('author',)
list_per_page = 10class CommentAdmin(admin.ModelAdmin):
list_display = ( 'comment_text', 'author', 'pub_date', 'topic')
search_fields = ('comment_text', 'author')
list_editable = ('author',)
list_per_page = 10


2.7 admin 开启过滤功能

应用 / admin.py

class TopicAdmin(admin.ModelAdmin):
list_display = ('topic_text', 'author', 'pub_date')
list_filter = ('topic_text', 'author', 'pub_date')
search_fields = ('topic_text',)
list_editable = ('author',)
list_per_page = 10class CommentAdmin(admin.ModelAdmin):
list_display = ( 'comment_text', 'author', 'pub_date', 'topic')
list_filter = ('comment_text', 'author', 'pub_date', 'topic')
search_fields = ('comment_text',)
list_editable = ('author',)
list_per_page = 10


开启之后记得强制刷新页面（ctrl + shift + r），重新加载 js 和 css 代码