Django-admin模块

Posted 2020-07-05 cwm_kylin

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