Django后台管理界面

时间:2022-02-15 00:29:42

之前的几篇记录了模板视图、模型等页面展示的相关内容,这篇主要写一下后台admin管理界面的内容。

激活管理界面

Django管理站点完全是可选择的,之前我们是把这些功能给屏蔽掉了。记得上篇中Django模型模型安装小结中,我们把settings.py中的部分内容屏蔽了,并添加了一个app,如下

 INSTALLED_APPS = (
## 'django.contrib.admin',
## 'django.contrib.auth',
## 'django.contrib.contenttypes',
## 'django.contrib.sessions',
## 'django.contrib.messages',
## 'django.contrib.staticfiles',
'mysite.books',
) MIDDLEWARE_CLASSES = (
## 'django.contrib.sessions.middleware.SessionMiddleware',
## 'django.middleware.common.CommonMiddleware',
## 'django.middleware.csrf.CsrfViewMiddleware',
## 'django.contrib.auth.middleware.AuthenticationMiddleware',
## 'django.contrib.messages.middleware.MessageMiddleware',
## 'django.middleware.clickjacking.XFrameOptionsMiddleware',
)

django.contrib.admin等这些就是支持后台admin管理界面的app,我们将上边这些注释全部去掉,即可增加对后台管理界面的支持。

运行 python manage.py syncdb 。这一步将生成管理界面使用的额外数据库表。 当你把'django.contrib.auth'加进INSTALLED_APPS后,第一次运行syncdb命令时, 系统会请你创建一个超级用户。 如果你不这么作,你需要运行python manage.py createsuperuser来另外创建一个admin的用户帐号,否则你将不能登入admin (提醒一句: 只有当INSTALLED_APPS包含'django.contrib.auth'时,python manage.py createsuperuser这个命令才可用.)

Django后台管理界面

到这里,我们就把后台管理基本配置好了。但是想想,我们还差什么没做?

时刻记得,去urls.py进行配置哦,下图是新建的project初始时候的URLConf,在Django建立helloworld自定义页面里我们删除掉的内容

 from django.conf.urls import patterns, include, url

 from django.contrib import admin

 admin.autodiscover()

 urlpatterns = patterns('',
# Examples:
# url(r'^$', 'testsite.views.home', name='home'),
# url(r'^blog/', include('blog.urls')), url(r'^admin/', include(admin.site.urls)), )

现在,我们要访问admin了,添加回来这几句吧

from django.contrib import admin
admin.autodiscover()
url(r'^admin/', include(admin.site.urls)),

好,我们运行起来看看吧。效果如下:

Django后台管理界面

输入之前你添加的管理员账户和密码,登陆网站后台看看吧

Django后台管理界面

如果你的母语不是英语,你可以做一个快速更改来观察Django管理工具是否被翻译成你想要的语言。 仅需添加 ‘django.middleware.locale.LocaleMiddleware’ 到 MIDDLEWARE_CLASSES 设置中,并确保它在’django.contrib.sessions.middleware.SessionMiddleware’后边(其实先后是没关系的)。如下我放在了第一个位置。

 MIDDLEWARE_CLASSES = (
'django.middleware.locale.LocaleMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.common.CommonMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
'django.middleware.clickjacking.XFrameOptionsMiddleware',
)

刷新一个刚才的页面,看看效果。

Django后台管理界面

具体的使用,无非就是增删改查了,自己去点吧。

将自定义的Models加入到Admin管理中

上一篇Django模型-数据库操作,我们定义了三个模块:Publisher 、 Author 和 Book 。 让我们将自己的模块加入管理工具中,这样我们就能够通过这个后台管理界面添加、修改和删除数据库中的对象了。

还记得新建的books app初始化的几个文件吗?

Django后台管理界面

打开admin.py,添加内容如下

 from django.contrib import admin

 # Register your models here.
from mysite.books.models import Publisher, Author, Book admin.site.register(Publisher)
admin.site.register(Author)
admin.site.register(Book)

这些代码通知管理工具为这些模块逐一提供界面。你可能需要先停止,然后再启动服务(runserver),才能使其生效。

Django后台管理界面

 点开新加的三个模块,点开Books,外键publisher用一个选择框显示,多对多字段author用一个多选框显示,日期字段也是datepicker样式的选择,有没有很强大。
Django后台管理界面

Admin是如何工作的

当服务启动时,Django从urls.py引导URLconf,然后执行admin.autodiscover()语句。 这个函数遍历INSTALLED_APPS配置,并且寻找相关的 admin.py文件。 如果在指定的app目录下找到admin.py,它就执行其中的代码。

在books应用程序目录下的admin.py文件中,每次调用admin.site.register()都将那个模块注册到管理工具中。 管理工具只为那些明确注册了的模块显示一个编辑/修改的界面。

应用程序django.contrib.auth包含自身的admin.py,所以Users和Groups能在管理工具中自动显示。

字段设置

我们尝试添加一个作者信息,发现一些现象,每个字段都是必填项,Email也有专门的格式验证。如果我们不想要这些限制,该怎么做呢?

Django后台管理界面

修改我们的models.py如下

 class Author(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=40)
email = models.EmailField(blank=True) def __unicode__(self):
return u'%s %s' % (self.first_name,self.last_name)

标红部分是新添加的属性,这些代码告诉Django,作者的邮箱地址允许输入一个空值。

所有字段都默认blank=False,这使得它们不允许输入空值。

刷新页面,将会发现Email的标签不再是粗体,这意味它不是一个必填字段。

针对日期和数字的设置

Django生成CREATE TABLE语句自动为每个字段显式加上NOT NULL,在大多数情况下,这种默认的行为对你的应用程序来说是最佳的(消除NULL和空字符串的数据不一致)。

但是,其它数据类型有例外:日期型、时间型和数字型字段不接受空字符串。 如果你尝试将一个空字符串插入日期型或整数型字段,你可能会得到数据库返回的错误,这取决于那个数据库的类型。 (PostgreSQL比较严禁,会抛出一个异常;MySQL可能会也可能不会接受,这取决于你使用的版本和运气了。)在这种情况下,NULL是唯一指定空值的方法。 在Django模块中,你可以通过添加null=True来指定一个字段允许为NULL

如果你想允许一个日期型(DateFieldTimeFieldDateTimeField)或数字型(IntegerFieldDecimalFieldFloatField)字段为空,你需要使用null=True  和 blank=True

添加null=True比添加blank=True复杂。因为null=True改变了数据的语义,即改变了CREATE TABLE语句,把publication_date字段上的NOT NULL删除了。 要完成这些改动,我们还需要更新数据库。然而Django不会尝试自动更新数据库结构,所以你必须执行ALTER TABLE语句将模块的改动更新至数据库。

使用manage.py dbshell进入数据库服务环境,执行命令

ALTER TABLE books_book ALTER COLUMN publication_date DROP NOT NULL;

现在回到管理工具,添加book的编辑页面就允许输入一个空的publication date。

 日期和数字的设置这部分,由于我本地环境问题,manage.py dbshell总有问题,所以该部分内容,我没进行相应操作。
Django后台管理界面
 我本地的搜索路径如下,是不是缺少Sqlite3的命令路径?有大牛知道的,请告知,谢谢! Django后台管理界面

自定义字段标签

在编辑页面中,每个字段的标签都是从模块的字段名称生成的。规则很简答:用空格替换下划线;首字母大写。比如上边新增作者的那个截图:first_name变成了First name。

有些情况下,我们想展示自定的标签名。为做到这个,我们只需要在models的模块定义中指定verbose_name即可。

比如我们要将Author.email的标签改成e-mail,中间有个横线,可以这样做

 class Author(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=40)
email = models.EmailField(blank=True,verbose_name='e-mail')

重新启动服务,刷新页面,效果如下

Django后台管理界面

最后还需注意的是,为了使语法简洁,你可以把它当作固定位置的参数传递。 这个例子与上面那个的效果相同。
 class Author(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=40)
email = models.EmailField('e-mail', blank=True)

但这不适用于ManyToManyField 和ForeignKey字段,因为它们第一个参数必须是模块类。 那种情形,必须显式使用verbose_name这个参数名称。

自定义ModelAdmin类

我们做的blank=Truenull=Trueverbose_name修改其实是模块级别,而不是管理级别的。 也就是说,这些修改实质上是构成模块的一部分,并且正好被管理工具使用,而不是专门针对管理工具的。除了这些,Django还提供了大量选项让你针对特别的模块自定义管理工具。 这些选项都在ModelAdmin classes里面,这些类包含了管理工具中针对特别模块的配置。

自定义列表

让我们更深一步:自定义Author模块的列表中的显示字段。 列表默认地显示查询结果中对象的__unicode__()
 class Author(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=40)
email = models.EmailField(blank=True,verbose_name='e-mail') def __unicode__(self):
return u'%s %s' % (self.first_name,self.last_name)
Django后台管理界面

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

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

 from django.contrib import admin
from models import * # Register your models here. class AuthorAdmin(admin.ModelAdmin):
list_display = ('first_name', 'last_name', 'email') admin.site.register(Publisher)
admin.site.register(Author,AuthorAdmin)
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列表页面,你会看到列表中有三列:姓氏、名字和邮箱地址。 另外,点击每个列的列头可以对那列进行排序。
Django后台管理界面
 
让我们再添加一个快速查询栏。 向AuthorAdmin追加search_fields,如:
 class AuthorAdmin(admin.ModelAdmin):
list_display = ('first_name', 'last_name', 'email')
search_fields = ('first_name', 'last_name')

刷新页面,效果如下

Django后台管理界面

Django后台管理界面
 
接下来,为Book列表页添加一些过滤器,如下
 from django.contrib import admin
from models import * # Register your models here. class AuthorAdmin(admin.ModelAdmin):
list_display = ('first_name', 'last_name', 'email')
search_fields = ('first_name', 'last_name') class BookAdmin(admin.ModelAdmin):
list_display=('title','publisher','publication_date')
list_filter=('publication_date',) admin.site.register(Publisher)
admin.site.register(Author,AuthorAdmin)
admin.site.register(Book,BookAdmin)

刷新效果如下:

Django后台管理界面

list_filter这个字段元组创建过滤器,它位于列表页面的右边。 Django为日期型字段提供了快捷过滤方式,它包含:今天、过往七天、当月和今年。

另外一种过滤日期的方式是使用date_hierarchy选项,如:
 class BookAdmin(admin.ModelAdmin):
list_display=('title','publisher','publication_date')
list_filter=('publication_date',)
date_hierarchy = 'publication_date'

修改好后,页面中的列表顶端会有一个逐层深入的导航条,效果如图 6-11. 它从可用的年份开始,然后逐层细分到月乃至日。

查看结果如下

Django后台管理界面

请注意,date_hierarchy接受的是* 字符串* ,而不是元组。因为只能对一个日期型字段进行层次划分。
 
最后,让我们改变默认的排序方式,按publication date降序排列。 列表页面默认按照模块class Meta中的ordering所指的列排序。详细请看Django模型-数据库操作。该实例中没有指定ordering,所以排序是没定义的。
 class BookAdmin(admin.ModelAdmin):
list_display=('title','publisher','publication_date')
list_filter=('publication_date',)
date_hierarchy = 'publication_date'
ordering = ('-publication_date',)

这个ordering选项基本像模块中class Metaordering那样工作。效果是Publication date列头现在有一个小箭头显示排序。

Django后台管理界面

自定义编辑表单

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

 class BookAdmin(admin.ModelAdmin):
list_display=('title','publisher','publication_date')
list_filter=('publication_date',)
date_hierarchy = 'publication_date'
ordering = ('-publication_date',)
fields = ('authors', 'title', 'publisher')

顺序是我们自定义的,可编辑的字段也是我们可选择的。效果如下:

Django后台管理界面

此时新增记录,Django会简单地将publication_date设置为None,以确保这个字段满足null=True的条件。

因为之前我说的,本地的Python manage.py dbshell 失败,导致我无法修改数据库结构,

publication_date = models.DateField(blank=True,null=True)

这段代码是失效的,所以我在这里提交代码会出错,如下:

Django后台管理界面

如果你本地的命令没问题,并且根据之前的说明修改了对应数据库字段可空(NULL和空字符串),则不会出错。

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

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

 class BookAdmin(admin.ModelAdmin):
list_display=('title','publisher','publication_date')
list_filter=('publication_date',)
date_hierarchy = 'publication_date'
ordering = ('-publication_date',)
#fields = ('authors', 'title', 'publisher')
filter_horizontal = ('authors',)

效果如下

Django后台管理界面

ModelAdmin类还支持filter_vertical选项。 它像filter_horizontal那样工作,除了控件都是垂直排列,而不是水平排列的。

filter_horizontalfilter_vertical选项只能用在多对多字段 上, 而不能用于 ForeignKey字段。 默认地,管理工具使用'下拉框' 来展现 外键 字段。下拉框选择就会将所有值加载到下拉列表,选中某个或许需要拖滚动条好久才能找到。

Django提供了raw_id_fields 选项,它是一个包含外键字段名称的元组,它包含的字段将被展现成’ 文本框‘和检索按钮的形式。

 class BookAdmin(admin.ModelAdmin):
list_display=('title','publisher','publication_date')
list_filter=('publication_date',)
date_hierarchy = 'publication_date'
ordering = ('-publication_date',)
#fields = ('authors', 'title', 'publisher')
filter_vertical = ('authors',)
raw_id_fields = ('publisher',)

Django后台管理界面

这个文框内可输入的值是publisher的id,通过检索弹框选择即可。

小结

这篇篇幅较长,内容不少。还有一部分关于权限的东西,这里不多说了,后台里多点点就能理解。

Django后台管理界面的更多相关文章

  1. 使用django的admin的后台管理界面

    django的admin后台管理界面是方便我们对数据库操作的  是一个在浏览器显示的  图形化界面数据库操作 我们先在django中的admin中把我们需要在图形化界面中进行操作的表导入进去: 先把m ...

  2. django后台管理-ModelAdmin对象

    Django最强大的部分之一是自动生成的管理后台界面. 它从你的模型中读取元数据,以提供一个快速的.以模型为中心的界面,信任的用户可以在这里管理你网站上的内容. 建议管理后台仅作为组织的一个内部管理工 ...

  3. Django笔记 —— Admin(Django站点管理界面)

    最近在学习Django,打算玩玩网页后台方面的东西,因为一直很好奇但却没怎么接触过.Django对我来说是一个全新的内容,思路想来也是全新的,或许并不能写得很明白,所以大家就凑合着看吧- 本篇笔记(其 ...

  4. django后台管理-admin

    0922自我总结 django后台管理-admin 一.模型注册 admin.py 注册方式一: #在对于注册的app中的admin文件中导入模型然后注册模型 admin.site.register( ...

  5. Django——后台管理

    1.要使用Django-admin后台的前提 INSTALLED_APPS = [ 'simpleui', 'django.contrib.admin', #必须有这一项 'django.contri ...

  6. vuejs 和 element 搭建的一个后台管理界面

    介绍: 这是一个用vuejs2.0和element搭建的后台管理界面. 相关技术: vuejs2.0:渐进式JavaScript框架,易用.灵活.高效,似乎任何规模的应用都适用. element:基于 ...

  7. vue2.0+element+node+webpack搭建的一个简单的后台管理界面

    闲聊: 今天是六一儿童节哟,小颖祝大家节日快乐哈哈哈.其实这个demo小颖断断续续做了将近两个礼拜了,心塞的,其实这个也没有多难,主要是小颖有点最近事情有点多,所以就把这个一直拖着,今天好不容易做好了 ...

  8. 使用vuejs2.0和element-ui 搭建的一个后台管理界面

    说明: 这是一个用vuejs2.0和element-ui搭建的后台管理界面. 相关技术: vuejs2.0:一套构建用户界面的渐进式JavaScript框架,易用.灵活.高效. element-ui: ...

  9. 使用Bootstrap+metisMenu完成简单的后台管理界面

    零. 写在前面 作者最近在一个小项目中需要写后台管理界面,在互联网上绕了一圈,最后决定使用Bootstrap+metisMenu来完成.理由1:Bootstrap是目前流行的前端框架,风格简约,简单易 ...

随机推荐

  1. Devexpress EXCEL导出

    #region EXCEL导出 /// <summary> /// EXCEL导出 /// </summary> /// <param name="saveFi ...

  2. Python ORM Storm 源码修改

    安装 storm : pip install storm 目标:修改 Storm 源代码以支持自动重连文件:python安装目录/site-packages/storm/database.py 在41 ...

  3. This version of android studio is incompatible with the gradle version used&period;Try disabling the instant run解决办法

    今天打开android studio又碰到一个奇怪的问题:This version of android studio is incompatible with the gradle version ...

  4. c&num;调用c&plus;&plus;开发的dll const char&ast; 返回值接收问题

    原文:c#调用c++开发的dll const char* 返回值接收问题 用c#调用视频接口相关的dll,dll使用c++开发. c++接口定义如下: PLATFORM const char* Pla ...

  5. input 即时搜索 监听输入值的变化

    在 Web 开发中经常会碰到需要动态监听输入框值变化的情况,如果使用 onkeydown.onkeypress.onkeyup 这个几个键盘事件来监测的话,监听不了右键的复制.剪贴和粘贴这些操作,处理 ...

  6. javascript知识详解之8张思维导图

    学习的道路就是要不断的总结归纳,好记性不如烂笔头,so,下面将po出8张javascript相关的思维导图. 思维导图小tips:思维导图又叫心智图,是表达发射性思维的有效的图形思维工具 ,它简单却又 ...

  7. 23个Python爬虫开源项目代码,让你一次学个够

    今天为大家整理了23个Python爬虫项目.整理的原因是,爬虫入门简单快速,也非常适合新入门的小伙伴培养信心.所有链接指向GitHub,祝大家玩的愉快 1.WechatSogou [1]– 微信公众号 ...

  8. MVC的多页面后台管理系统

    MVC的多页面后台管理系统 同样功能的后台管理系统,也是可以使用 ASP.NET MVC .Web API 和JQuery 来制作. 所有的功能都与Angular js的单页面相同.应用层所有的方法都 ...

  9. visual studio code 输出乱码

    问题: 解决方法: 首先,这个与VS本身无关,问题是出现在windows的dos显示设置上. 如何解决这个问题? 1.打开运行,输入cmd: 2.界面顶部右键,选择默认值: 3.将437(OEM-美国 ...

  10. MySQL数据约束

    定义:建表时在各字段类型后设置,用来对用户操作表的数据进行约束. 代码: 1.默认值  :   default ' ' 作用:当用户对使用默认值的字段不插入值的时候,就使用默认值(自动填充). 注意: ...