实战Django:官方实例Part2

时间:2022-09-28 19:42:53

我们接着Part1部分往下讲.我们在part1中启动服务器后,并没有在管理页面中发现新添加的Polls应用,怎么办捏?

7.在管理界面中显示Question


只要注册一下这个应用就可以了。编辑polls/admin.py 文件,让它变成下面这个样子:

polls/admin.py:

from django.contrib import admin
from polls.models import Question admin.site.register(Question)

这样Django就知道应该把Polls应用的管理功能也加到管理界面中,重新刷新一下浏览器,可以看到页面变成下面这样:

实战Django:官方实例Part2

 

8.添加内容


点击Questions链接,进入Polls的管理页面:

实战Django:官方实例Part2

现在什么都没有,点击右上角的”增加question“来添加一项:

实战Django:官方实例Part2

在Question text后面输入:”What’s up?”,然后依此点击“今天”和“现在”两个链接,再点保存按钮,这一项就添加好了。

实战Django:官方实例Part2

注意观察页面上的三个按钮,分别代表不同的操作:

”保存并增加另一个“,是在做保存动作之后,进入添加下一个的操作;

”保存并继续编辑“,是在做保存动作之后,停留在当前项的编辑页面;

”保存“,则是在做保存动作之后,回到Questions的列表显示页面;

 

9.优化显示


等等,怎么显示的是“Question object”?这多别扭啊!直接显示”What's Up?“多好?

我们来改一下,编辑polls/models.py文件,给两个Class分别加上”__str__() “方法:

polls/models.py

from django.db import models

class Question(models.Model):
# ...
def __str__(self): # __unicode__ on Python 2
return self.question_text class Choice(models.Model):
# ...
def __str__(self): # __unicode__ on Python 2
return self.choice_text

刷新一下浏览器,这下,顺眼多了吧?

实战Django:官方实例Part2

 

10.定制管理表单


上面这个新增Question的页面样式是不是一成不变的呢?

事实上,Django给我们准备了丰富的定制手段,比如我们要把发布日期和Question text的顺序调换一下,就这么做:

编辑polls/admin.py 文件,把它变成下面这样:

polls/admin.py

from django.contrib import admin
from polls.models import Question class QuestionAdmin(admin.ModelAdmin):
fields = ['pub_date', 'question_text'] admin.site.register(Question, QuestionAdmin)

刷新一下浏览器,编辑页面变成了这样:

实战Django:官方实例Part2

当你只有两个字段的时候,谁先谁后其实无关紧要,但当字段数量变成十几个,甚至几十个的时候,字段的顺序就变得重要起来了。

讲到”大量字段“这个话题的时候,我们可能会用到”把字段分组“这个技巧,

再来编辑polls/admin.py 文件,把它变成下面这样:

polls/admin.py

from django.contrib import admin
from polls.models import Question class QuestionAdmin(admin.ModelAdmin):
fieldsets = [
(None, {'fields': ['question_text']}),
('Date information', {'fields': ['pub_date']}),
] admin.site.register(Question, QuestionAdmin)

刷新一下浏览器,我们的编辑页面变成了这样:

实战Django:官方实例Part2

继续延伸这个话题,如果我们的表单很长,这时我们可能会想到要将某些字段”折叠“起来,那么,酱紫做:

编辑polls/admin.py 文件,我们给”Date information“把加入一个'collapse'的样式:

polls/admin.py

from django.contrib import admin
from polls.models import Question class QuestionAdmin(admin.ModelAdmin):
fieldsets = [
(None, {'fields': ['question_text']}),
('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}),
] admin.site.register(Question, QuestionAdmin)

页面就变成了:

实战Django:官方实例Part2

只有当你点击图中的”显示“链接时,才可以进行日期信息的编辑。

11.添加关联对象


我们的投票应用还少了一部分:投票的选项还没加到管理界面中来。

要实现这个其实很简单,我们有两种方式。

第一种方式是在admin.py中注册Choice,以便让它显示到管理界面中。

编辑polls/admin.py

from django.contrib import admin
from polls.models import Choice, Question
# ...
admin.site.register(Choice)

这样Choice就被添加到管理界面中来了:

实战Django:官方实例Part2

点击Choices后边的”增加“按钮:

实战Django:官方实例Part2

在这个”增加choice“界面中,我们可以在”Question“后边选择已经添加好的问题,然后逐个输入对应的选项——通常每一个投票会有好几个选项可供选择。

好了,问题来了,这样的方式是够简单了,但当你一次性添加好多内容的时候,你每添加一项choice都要在Question后面重新选择问题,内容一多,这就成了件苦差使。有没有更简便的方法?

我们来看第二种方式。

编辑polls/admin.py,移除”admin.site.register(Choice)“这一行,然后添加内容:

polls/admin.py:

from django.contrib import admin
from polls.models import Choice, Question class ChoiceInline(admin.StackedInline):
model = Choice
extra = 3 class QuestionAdmin(admin.ModelAdmin):
fieldsets = [
(None, {'fields': ['question_text']}),
('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}),
]
inlines = [ChoiceInline] admin.site.register(Question, QuestionAdmin)

这等于是在告诉Django,Choice这个对象我们要在Question界面中编辑,默认情况下,一个Question下配上3个Choice,来看下具体的效果吧:

实战Django:官方实例Part2

当我们要为一个Question配4个Choice怎么办?很简单,点击上图下方的”添加另一个Choice“链接就行。

还有一个小问题,这样的显示方式,也太占地方了!能不能让布局简洁些?

我们只要改动一个地方,编辑polls/admin.py,改动ChoiceInline这一行:

polls/admin.py:

class ChoiceInline(admin.TabularInline):
#...

把显示样式由StackedInline改为TabularInline。看下效果:

实战Django:官方实例Part2

怎么样,紧凑多了吧?

12.改进


我们来看一下那个显示所有Question的列表页面,如下图所示,它只显示了Question这一个字段,有没有可能让显示的字段更多一些呢?

实战Django:官方实例Part2

我们可以使用list_display这个选项来实现,编辑polls/admin.py,加上一行:

polls/admin.py

class QuestionAdmin(admin.ModelAdmin):
# ...
list_display = ('question_text', 'pub_date')

看一下,效果出来了:

实战Django:官方实例Part2

我们希望看到更多的信息,比如,这个Question是否最近发布的。我们可以在模型中添加一个叫“was_published_recently”的字段来实现它。

编辑polls/models.py,让它变成:

polls/models.py:

import datetime

from django.db import models
from django.utils import timezone class Question(models.Model):
# ...
def was_published_recently(self):
return self.pub_date >= timezone.now() - datetime.timedelta(days=1)

编辑polls/admin.py,作如下改动:

polls/admin.py

class QuestionAdmin(admin.ModelAdmin):
# ...
list_display = ('question_text', 'pub_date', 'was_published_recently')

看下效果:

实战Django:官方实例Part2

我们可以点击每一栏位的标题对其进行排序操作——除了'was_published_recently ?'这一栏,因为这个字段并非数据库自身的字段,而是我们“造”出来的。

不过我们也有办法让它参与排序,并且改进一下显示的方式。

编辑polls/models.py,让它变成下面这个样子:

polls/models.py:

class Question(models.Model):
# ...
def was_published_recently(self):
return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
was_published_recently.admin_order_field = 'pub_date'
was_published_recently.boolean = True
was_published_recently.short_description = 'Published recently?'

刷新一下浏览器:

实战Django:官方实例Part2

现在,'was_published_recently ?'这一栏也可以参与排序了,它用来排序的字段是“pub_date”。

Django的admin模块还给我们提供了过滤器的功能,我们可以利用list_filter语句来给“pub_date”字段添加一个过滤器。

编辑polls/admin.py,在QuestionAdmin下添加一行:

polls/admin.py

list_filter = ['pub_date']

我们可以看到,右侧多了一个叫”过滤器“的侧边栏,你可以使用”今天“、”过去7天“、”本月“、”今年“等条件来对当前显示内容进行过滤。

实战Django:官方实例Part2

如果内容一多,我们想快速定位某一个投票项怎么办?

我们可以很方便地添加一个搜索功能。

编辑polls/admin.py,在QuestionAdmin下添加一行:

polls/admin.py

search_fields = ['question_text']

在列表上方多出了一个搜索文本框,就是这么简单。

实战Django:官方实例Part2

13.定制管理页面外观


每个管理页面的顶部都挂着”Django管理“有时看起来很傻。不过你放心,这个是可以替换的。

在我们的项目文件夹(最顶层的mysite文件夹)中建立一个叫templates的文件夹,这样我们的项目文件夹的结构就变成下面这样:

mysite/
manage.py
mysite/
polls/
templates/

我们需要修改一下mysite/settings.py文件,在页面底部加入一行:

mysite/settings.py

TEMPLATE_DIRS = [os.path.join(BASE_DIR, 'templates')]

然后在templates文件夹下建立一个admin文件夹,并从Django源代码包的django/contrib/admin/templates文件夹下复制一个叫base_site.html的文件到admin文件夹下。

注:电脑里装有everything的童鞋,可以快速搜索一下base_site.html文件。

实在找不到这个文件的,就按照下面的代码新建一个:

{% extends "admin/base.html" %}

{% block title %}{{ title }} | {{ site_title|default:_('Django site admin') }}{% endblock %}

{% block branding %}
<h1 id="site-name"><a href="{% url 'admin:index' %}">{{ site_header|default:_('Django administration') }}</a></h1>
{% endblock %} {% block nav-global %}{% endblock %}

把第四行改为:

<h1 id="site-name"><a href="{% url 'admin:index' %}">投票管理</a></h1>

由于我们在文档中使用了中文,所以这个html文件要储存为”utf-8”的编码——你可以用emeditor之类的文本编辑器快速地实现这一点。不会改编码的童鞋,就先用一个英文名字来代替“投票管理”吧。

实战Django:官方实例Part2

我们还可以修改整个后台的索引页,用上面的方法从Django源代码包中复制admin/index.html文件过来,然后进行编辑,具体的方法不再详述。

不要被这里的模板语言吓倒,我们会在Part3中手把手教你如何搞定模板。

【未完待续】

本文版权归舍得学苑所有,欢迎转载,转载请注明作者和出处。谢谢!

作者:舍得

首发:舍得学苑@博客园