码迷,mamicode.com
首页 > 编程语言 > 详细

Python框架之Django学习笔记(十四)

时间:2014-10-12 15:05:18      阅读:251      评论:0      收藏:0      [点我收藏+]

标签:style   blog   http   color   io   os   使用   ar   java   

Django站点管理(续·完)

  本想昨天更新的,谁曾想昨天竟然是工作日!我就不吐槽昨天加班到十一点多了,需求增加无疑让我等蛋疼不已,忽而想起一首打油诗:

明月几时有,把酒问群友。不知这次版本,今晚能出否。我欲推倒重构,又恐项目经理,深夜对我吼。增删改代码,好像没保存…

深呼吸,看屏幕,泪在流。不应有恨,谁没忘记存代码?人有悲欢离合,码有丢失冲突,此事古难全。但愿人长久,leader别发现。

  废话少说,进入今天的正题,Django站点管理学习开始。

自定义列表

  让我们更深一步:自定义Author模块的列表中的显示字段。 列表默认地显示查询结果中对象的__unicode__()。  

1 class Author(models.Model):
2     first_name = models.CharField(max_length=30)
3     last_name = models.CharField(max_length=40)
4     email = models.EmailField(blank=True, verbose_name=e-mail)
5 
6     **def __unicode__(self):**
7         **return u%s %s % (self.first_name, self.last_name)**

   PS:星号内的部分为更改新增部分,后面不再赘述。

  改动完成后,效果如下:

bubuko.com,布布扣

  我们可以在这基础上改进,添加其它字段,从而改变列表的显示。 这个页面应该提供便利,比如说:在这个列表中可以看到作者的邮箱地址。如果能按照姓氏或名字来排序,那就更好了。

  为了达到这个目的,我们将为Author模块定义一个ModelAdmin类。 这个类是自定义管理工具的关键,其中最基本的一件事情是允许你指定列表中的字段。 打开admin.py并修改: 

1 from django.contrib import admin
2 from books.models import Publisher, Author, Book
3 
4 **class AuthorAdmin(admin.ModelAdmin):**
5     **list_display = (first_name, last_name, email)**
6 
7 admin.site.register(Publisher)
8 **admin.site.register(Author, AuthorAdmin)**
9 admin.site.register(Book)

  唠叨一下代码:

  首先,新建了一个类AuthorAdmin,它是从django.contrib.admin.ModelAdmin派生出来的子类,保存着一个类的自定义配置,以供管理工具使用。 我们只自定义了一项:list_display, 它是一个字段名称的元组,用于列表显示。 当然,这些字段名称必须是模块中有的。

  然后,我们修改了admin.site.register()调用,在Author后面添加了AuthorAdmin。你可以这样理解: 用AuthorAdmin选项注册Author模块。

  最后,admin.site.register()函数接受一个ModelAdmin子类作为第二个参数。 如果你忽略第二个参数,Django将使用默认的选项。PublisherBook的注册就属于这种情况。]

  弄好了这个东东,再刷新author列表页面,你会看到列表中有三列:姓氏、名字和邮箱地址。 另外,点击每个列的列头可以对那列进行排序。效果图如下所示:

  bubuko.com,布布扣

  接下来,让我们添加一个快速查询栏。 向AuthorAdmin追加search_fields,如: 

1 class AuthorAdmin(admin.ModelAdmin):
2     list_display = (first_name, last_name, email)
3     **search_fields = (first_name, last_name)**

 

  刷新浏览器,你会在页面顶端看到一个查询栏。 (见图6-9.)我们刚才所作的修改列表页面,添加了一个根据姓名查询的查询框。 正如用户所希望的那样,它是大小写敏感,并且对两个字段检索的查询框。如果查询"bar",那么名字中含有Barney和姓氏中含有Hobarson的作者记录将被检索出来。

  bubuko.com,布布扣

  多创建几条数据玩玩检索。

  接下来,让我们为Book列表页添加一些过滤器。 

 1 from django.contrib import admin
 2 from books.models import Publisher, Author, Book
 3 
 4 class AuthorAdmin(admin.ModelAdmin):
 5     list_display = (first_name, last_name, email)
 6     search_fields = (first_name, last_name)
 7 
 8 **class BookAdmin(admin.ModelAdmin):**
 9     **list_display = (title, publisher, publication_date)**
10     **list_filter = (publication_date,)**
11 
12 admin.site.register(Publisher)
13 admin.site.register(Author, AuthorAdmin)
14 **admin.site.register(Book, BookAdmin)**

 

  由于我们要处理一系列选项,因此我们创建了一个单独的ModelAdmin类:BookAdmin。首先,我们定义一个list_display,以使得页面好看些。 然后,我们用list_filter这个字段元组创建过滤器,它位于列表页面的右边。 Django为日期型字段提供了快捷过滤方式,它包含:今天、过往七天、当月和今年。这些是开发人员经常用到的。

自定义编辑表单

  正如自定义列表那样,编辑表单多方面也能自定义。

  首先,我们先自定义字段顺序。 默认地,表单中的字段顺序是与模块中定义是一致的。 我们可以通过使用ModelAdmin子类中的fields选项来改变它: 

1 class BookAdmin(admin.ModelAdmin):
2     list_display = (title, publisher, publication_date)
3     list_filter = (publication_date,)
4     date_hierarchy = publication_date
5     ordering = (-publication_date,)
6     **fields = (title, authors, publisher, publication_date)**

 

  完成之后,编辑表单将按照指定的顺序显示各字段。 它看起来自然多了——作者排在书名之后。 字段顺序当然是与数据条目录入顺序有关, 每个表单都不一样。

  通过fields这个选项,你可以排除一些不想被其他人编辑的fields 只要不选上不想被编辑的field(s)即可。 当你的admi用户只是被信任可以更改你的某一部分数据时,或者,你的数据被一些外部的程序自动处理而改变了了,你就可以用这个功能。 例如,在book数据库中,我们可以隐藏publication_date,以防止它被编辑。

1 class BookAdmin(admin.ModelAdmin):
2     list_display = (title, publisher, publication_date)
3     list_filter = (publication_date,)
4     date_hierarchy = publication_date
5     ordering = (-publication_date,)
6     **fields = (title, authors, publisher)**

 

  这样,在编辑页面就无法对publication date进行改动。 如果你是一个编辑,不希望作者推迟出版日期的话,这个功能就很有用。

  当一个用户用这个不包含完整信息的表单添加一本新书时,Django会简单地将publication_date设置为None,以确保这个字段满足null=True的条件。

  另一个常用的编辑页面自定义是针对多对多字段的。 真如我们在book编辑页面看到的那样,`` 多对多字段`` 被展现成多选框。虽然多选框在逻辑上是最适合的HTML控件,但它却不那么好用。 如果你想选择多项,你必须还要按下Ctrl键(苹果机是command键)。 虽然管理工具因此添加了注释(help_text),但是当它有几百个选项时,它依然显得笨拙。

  更好的办法是使用filter_horizontal。让我们把它添加到BookAdmin中,然后看看它的效果。

1 class BookAdmin(admin.ModelAdmin):
2     list_display = (title, publisher, publication_date)
3     list_filter = (publication_date,)
4     date_hierarchy = publication_date
5     ordering = (-publication_date,)
6     **filter_horizontal = (authors,)**

 

  刷新book编辑页面,你会看到Author区中有一个精巧的JavaScript过滤器,它允许你检索选项,然后将选中的authors从Available框移到Chosen框,还可以移回来。界面图如下:

  

bubuko.com,布布扣

  强烈建议针对那些拥有十个以上选项 多对多字段使用filter_horizontal。 这比多选框好用多了。 你可以在多个字段上使用filter_horizontal,只需在这个元组中指定每个字段的名字。

  ModelAdmin类还支持filter_vertical选项。 它像filter_horizontal那样工作,除了控件都是垂直排列,而不是水平排列的。 至于使用哪个,只是个人喜好问题。

  filter_horizontalfilter_vertical选项只能用在多对多字段 上, 而不能用于 ForeignKey字段。 默认地,管理工具使用“ 下拉框” 来展现 外键字段。但是,正如多对多字段 那样,有时候你不想忍受因装载并显示这些选项而产生的大量开销。 例如,我们的book数据库膨胀到拥有数千条publishers的记录,以致于book的添加页面装载时间较久,因为它必须把每一个publishe都装载并显示在下拉框中。

  解决这个问题的办法是使用“raw_id_fields” 选项。它是一个包含外键字段名称的元组,它包含的字段将被展现成"文本框" ,而不再是" 下拉框" 。效果如下:

1 class BookAdmin(admin.ModelAdmin):
2     list_display = (title, publisher, publication_date)
3     list_filter = (publication_date,)
4     date_hierarchy = publication_date
5     ordering = (-publication_date,)
6     filter_horizontal = (authors,)
7     **raw_id_fields = (publisher,)**

 

  bubuko.com,布布扣

  在这个输入框中,你输入什么呢? publisher的数据库ID号。 考虑到人们通常不会记住这些数据库ID,管理工具提供了一个放大镜图标方便你输入。点击那个图标将会弹出一个窗口,在那里你可以选择想要添加的publishe。

  至此,Django的管理站点学习完毕。今天又是补新番又是写博客,一会还要写另一个项目的详设,不多说,先睡一觉再说。

 

Python框架之Django学习笔记(十四)

标签:style   blog   http   color   io   os   使用   ar   java   

原文地址:http://www.cnblogs.com/voidy/p/4020486.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!