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提供了很详细的权限设置方案。包括对每一张表的控制权限。