创建 blog 的管理后台
首先是 blog 这个 App,其中定义了 3个 Model,分别是 Category、Post 和 Tag。先创建 admin 页面,其代码需要写到 blog/admin.py 这个文件中。
编写 Tag 和 Category 的管理后台
from django.contrib import admin from .models import Post, Category, Tag @admin.register(Category) class CategoryAdmin(admin.ModelAdmin): list_display = ('name', 'status', 'is_nav', 'created_time') fields = ('name', 'status', 'is_nav') @admin.register(Tag) class TagAdmin(admin.ModelAdmin): list_display = ('name', 'status', 'created_time') fields = ('name', 'status')
这点代码就完成了 Tag 和 Category 的 admin 配置,可以尝试运行一下看看效果,然后再解释其中代码的作用。
首先,激活虚拟环境。先创建超级用户的用户名和密码,执行 python manage.py createsuperuser
,然后根据提示输入用户名和密码,邮箱可以不填,如图所示。
接着执行 python manage.py runserver
,看到正确输出之后,打开 http://127.0.0.1:8000/admin/
,进行登录,登录后能看到如图所示的界面。
可以尝试点进去操作一下,比如新建一条数据,会遇到如下错误。
这个错误可以理解为数据不完整。根据提示的信息,可以知道具体问题是 “字段 owner_id 不能为空” 。
再结合编写的 Model,不难得到问题的原因是:给每个 Model 定义了一个 owner 字段来标记这个数据属于哪个作者,而页面上并没有填这一项。
再对比上一章中 Category 模型的定义,只展示了三个字段的内容,其原因就在 CategoryAdmin 的定义上:
@admin.register(Category) class CategoryAdmin(admin.ModelAdmin): list_display = ('name', 'status', 'is_nav', 'created_time') fields = ('name', 'status', 'is_nav')
可以发现,这三个字段刚好是 fields 的内容。所以,fields 这个配置的作用就是控制页面上要展示的字段。因此,解决方案很简单,把 owner 放进去就好了。此时就能在页面上选择用户了。
但是这样做也不好,这样的话,任何作者都可以随意把自己创建的内容改为作者的。可以考虑另一个方案:保存数据之前,把 owner 这个字段设定为当前的登录用户。这个时候就需要重写 ModelAdmin 的 save_model 方法,其作用是保存数据到数据库中。重写后的完整代码如下:
from django.contrib import admin from .models import Post, Category, Tag @admin.register(Category) class CategoryAdmin(admin.ModelAdmin): list_display = ('name', 'status', 'is_nav', 'created_time') fields = ('name', 'status', 'is_nav') def save_model(self, request, obj, form, change): obj.owner = request.user return super(CategoryAdmin, self).save_model(request, obj, form, change) @admin.register(Tag) class TagAdmin(admin.ModelAdmin): list_display = ('name', 'status', 'created_time') fields = ('name', 'status') def save_model(self, request, obj, form, change): obj.owner = request.user return super(TagAdmin, self).save_model(request, obj, form, change)
这个 save_model 方法,从参数的命名基本上能看到它们的作用。通过给 obj.owner 赋值,就能达到自动设置 owner 的目的。这里的 request 就是当前请求,request.user 就是当前已经登录的用户。如果是未登录的情况下,通过 request.user 拿到的是匿名用户对象。
obj 就是当前要保存的对象,而 form 是页面提交过来的表单之后的对象。change 用于标志本次保存的数据是新增的还是更新的。
这么修改之后,重新运行一下代码。保存数据后,查看列表页,得到的结果如图所示。
编写 Post 的管理后台
还是在刚才的 blog/admin.py 中增加代码
@admin.register(Post) class PostAdmin(admin.ModelAdmin): list_display = [ 'title', 'category', 'status', 'created_time', 'owner', 'operator' ] list_display_links = [] list_filter = ['category', ] search_fields = ['title', 'category__name'] actions_on_top = True actions_on_bottom = True # 编辑页面 save_on_top = True fields = ( ('category', 'title'), 'desc', 'status', 'content', 'tag', ) def operator(self, obj): return format_html( '<a href="{}">编辑</a>', reverse('admin:blog_post_change', args=(obj.id,)) ) operator.short_description = '操作' def save_model(self, request, obj, form, change): obj.owner = request.user return super(PostAdmin, self).save_model(request, obj, form, change)
在 blog/admin.py 最上面增加新的引用。到目前为止,所有的引用为:
from django.contrib import admin from django.urls import reverse from django.utils.html import format_html from .models import Post, Category, Tag
在分类列表页,需要展示该分类下有多少篇文章,可以在 CategoryAdmin 中增加如下代码:
def post_count(self, obj): return obj.post_set.count() post_count.short_description = '文章数量'
然后修改 list_display,最后增加 post_count,刷新页面就能看到修改之后的结果。
Model 的 __str__
方法
如果尝试运行上面的代码,可能会发现列表页上有这样的文案:Category object。这是因为没有配置类的 __str__
方法。因此,对于每个Model,都需要增加这个方法,类似于这样:
class Category(models.Model): # 省略其他代码 def __str__(self): return self.name
到目前为止,一个简单的管理后台就配置好了。
comment 的 admin 配置
comment/admin.py 的代码如下:
from django.contrib import admin from .models import Comment @admin.register(Comment) class CommentAdmin(admin.ModelAdmin): list_display = ('target', 'nickname', 'content', 'website', 'created_time')
config 的 admin 配置
from django.contrib import admin from .models import Link, SideBar @admin.register(Link) class LinkAdmin(admin.ModelAdmin): list_display = ('title', 'href', 'status', 'weight', 'created_time') fields = ('title', 'href', 'status', 'weight') def save_model(self, request, obj, form, change): obj.owner = request.user return super(LinkAdmin, self).save_model(request, obj, form, change) @admin.register(SideBar) class SideBarAdmin(admin.ModelAdmin): list_display = ('title', 'display_type', 'content', 'created_time') fields = ('title', 'display_type', 'content') def save_model(self, request, obj, form, change): obj.owner = request.user return super(SideBarAdmin, self).save_model(request, obj, form, change)