Django Admin后台管理模块的使用

Admin后台管理模块的使用

Django的管理员模块是Django的标准库django.contrib的一部分。这个包还包括其它一些实用的模块：

django.contrib.auth

django.contrib.sessions

django.contrib.comments

激活admin模块的方法是：

1. 在INSTALLED_APPS设置文件中，加入'django.contrib.admin'

2. 再添加

'django.contrib.auth',

'django.contrib.contenttypes'

'django.contrib.sessions'

因为admin模块依赖

3. 在MIDDLEWARE_CLASSES属性中添加

'django.middleware.common.CommonMiddleware',

'django.contrib.sessions.middleware.SessionMiddleware'

'django.contrib.auth.middleware.AuthenticationMiddleware'.

也是因为依赖

4. 运行python manage.py syncdb，用于创建为admin等模块创建新的数据库表。

因为apps中有auth模块，会要求你创建一个超级用户。如果你取消这步，

也可以运行python manage.py createsuperuser。当且仅当，你安装了auth模块。

5. 在urls.py中设置admin映射

# Include these import statements...

from django.contrib import admin

admin.autodiscover()

# And include this URLpattern...

urlpatterns = patterns('',

# ...

(r'^admin/', include(admin.site.urls)),

# ...

)

6. 记住在你的模块中增添admin模板文件，可以复制django自带模板，注意在模块路径中添加

admin文件夹。

D:\Python27\Lib\site-packages\django\contrib\admin\templates\admin\base_site.html

7. 运行python manage.py runserver，网址中输入http://localhost:8000/admin/

8. admin界面默认是显示英语，如果要显示你需要的语言：

在MIDDLEWARE_CLASSES属性中添加'django.middleware.locale.LocaleMiddleware'，并确保它

排列在SessionMiddleware后面。重新刷新admin页面

在admin页面中管理models模块：

1. 需要在你的app下创建一个admin.py文件，并对你的model类进行注册

from django.contrib import admin

from mysite.books.models import Publisher, Author, Book

admin.site.register(Publisher)

admin.site.register(Author)

admin.site.register(Book)

2. 当你在project文件夹中添加新的文件时，需要重启server才能生效。

3. 如果想要你的admin界面中的添加数据功能生效，需要在MIDDLEWARE_CLASSES属性中添加

'django.contrib.messages.middleware.MessageMiddleware',

自定义admin模块的显示

1. 取消在添加数据时，每一个字段都需要输入的限制

在model类中做相应的修改就可以了：

class Author(models.Model):

first_name = models.CharField(max_length=30)

last_name = models.CharField(max_length=40)

email = models.EmailField(blank=True)

只需要在字段声明中，设置blank=True，默认是False

关于NULL与空字符串的区别

在数据库操作中，NULL和空字符串""是两上不同的概念，有些数据库类型即能接受NULL值，又能接受

空字符串类型，例如，varchar类型，到底什么时候使用这两者，久而久之，容易造成数据的不一致，为

了避免这样的情况，Django默认是把blank=True这样的字段，统一做为空字符串插入到数据库中。同

时，在创建数据表的时候，所有字段统一默认使用NOT NULL。

但是，当遇到时间，日期类型的时候，空字符串反而会出错。这个时候，又需要使用NULL，只需要在model

字段声明中加入：

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

一旦你加入null=True声明，这样就相当于改变了数据库表结构，类似SQL语句中的

alter table books_book modify publication_date date null;

然而之前说过，Django的python manage.py syncdb只能用表创建新表，不能更改表结构，所以这时你需要

在数据库中进行更新表结构操作。

在admin界面的编辑页面中，字段名字的显示是根据model类中的变量名来显示的，大写第一个字母，把下划线改

成空格显示出来。自定义显示可以使用verbose_name参数

email = models.EmailField(blank=True, verbose_name='e-mail')

使用ModelAdmin来管理model在admin页面中的显示

自定义chanle list界面

ModelAdmin类似界面管理类，可以定义不同的显示细节。用法如下：

from django.contrib import admin
from mysite.books.models import Publisher, Author, Book

class AuthorAdmin(admin.ModelAdmin):
list_display = ('first_name', 'last_name', 'email')#把字段信息全部显示出来

search_fields = ('first_name', 'last_name') #添加search bar，在指定的字段中search

class BookAdmin(admin.ModelAdmin):

list_display = ('title', 'publisher', 'publication_date')

list_filter = ('publication_date',)#页面右边会出现相应的过滤器选项

date_hierarchy = 'publication_date' #只接受日期类型的字段名

ordering = ('-publication_date',) #排序

admin.site.register(Publisher)
admin.site.register(Author, AuthorAdmin)
admin.site.register(Book, BookAdmin)

自定义edit form界面

fields = ('title', 'publisher', 'authors', 'publication_date') #edit界面就按这个顺序显示

还可以定义可编辑的字段

fields = ('title', 'authors', 'publisher')

这样Django会自动给publication_data设置为null，记得null=True设置为null值

当遇到many-to-many的多选的字段类型时，Django自动提供上图中的选择方式，不过还可以

选择用其它方式来进行多选，这种方式更加直观，不过只能作用于many-to-many的多选字段，

不能应用于foreignkey字段。

filter_horizontal = ('authors',)

当然也有filter_vertical...

对于ForeighKey字段，也有相应的设置，用来输入字段的ID，点击边上的

放大镜图标，也会弹出选择框

raw_id_fields = ('publisher',)

关于用户，组，权限

Django提供了很详细的权限设置方案。包括对每一张表的控制权限。