Django之DjangoAdmin

前言：

当我们启动1个Django程序的时候，在程序的settings.py配置文件默认注册了1个名为'django.contrib.admin'的APP程序，并且配置了默认路由映射关系url(r'^admin/', admin.site.urls),这就是我们在安装Django时安装的后台管理插件DjangoAdmin，帮助我们快速对在model中定义的类（表）做增、删、改、查操作；

一、DjangoAdmin的基本使用

0、准备

创建admin后台管理用户

python manage.py createsuperuser

修改用户名密码

D:\Sensors_Data>python manage.py changepassword zhanggen

Changing password for user 'zhanggen'

Password:

Password (again):

Passwords do not match. Please try again.

Password:

Password (again):

Password changed successfully for user 'zhanggen'

创建数据库表

from django.db import models

class UserGroup(models.Model):

    title = models.CharField(verbose_name='组名称',max_length=32)

    def __str__(self):

        return self.title

class Role(models.Model):

    name= models.CharField(verbose_name='角色名称',max_length=32)

class UserInfo(models.Model):

    group = models.ForeignKey(verbose_name='用户组',to=UserGroup,null=True,blank=True)

    name = models.CharField(verbose_name='用户名',max_length=32)

    nickname =  models.CharField(verbose_name='昵称',max_length=32,null=True,blank=True)

    email = models.EmailField(verbose_name='邮箱',max_length=32)

    ctime = models.DateTimeField(verbose_name='创建时间',null=True,blank=True)

    roles = models.ManyToManyField(verbose_name='角色',to=Role)

    def __str__(self):

        return self.name

将表注册到admin.py

from django.contrib import admin

from . import models

admin.site.register(models.UserInfo)

admin.site.register(models.UserGroup)

设置编码

ALTER TABLE django_admin_log MODIFY COLUMN object_repr VARCHAR(255)  CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL;

setings.py设置中文版DjangoAdmin

LANGUAGE_CODE = 'zh-Hans'

TIME_ZONE = 'Asia/Shanghai'

1、使用DjangoAdmin进行数据库表的增、删、改、查操作，发现URL规则；

查看X表数据：DjangoAdmin生成url： http://127.0.0.1:8000/admin/app01/userinfo/

增加X表数据：DjangoAdmin生成url： http://127.0.0.1:8000/admin/app01/userinfo/add/

删除X表数据：DjangoAdmin生成url： http://127.0.0.1:8000/admin/app01/userinfo/2/del/

编辑X表数据：DjangoAdmin生成url： http://127.0.0.1:8000/admin/app01/userinfo/2/change/

发下URL规则：/app名称/表名/pk/操作

2、产生疑问 DjangoAdmin的URL是怎么通过组册到admin的表名自动生成的呢？

这就要看这行代码做了什么？

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

2.1.返回self.get_urls(),方法， 'admin', self.name

2.2.site对象的get_urls方法生成登录、注销、设置密码。。。url映射关系

2.3、还有

2.4、生成增、删、改、查的路由

2.5、猜想：Djangoadmin根据admin.py中注册的表名，自动生成/app名称/表名/pk/操作这样的url映射关系

二、自定义DjangoAdmin配置对象

1、通过 list_display列表，自定制显示数据库中已有列

from django.contrib import admin

from . import models

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

admin.site.register(models.UserInfo,Zhanggen)

admin.site.register(models.UserGroup)

通过装饰器的方式自定义配置类

@admin.register(models.UserInfo)  #使用装饰器的方法，注册表到admin

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','xx',]  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    def xx(self,obj):  #obj =当前行的对象

        # return '自定义列'+obj.name

        tpl=mark_safe('<a href="http://news.baidu.com/?tn=news/">链接</a>'.format(obj.pk))

        return tpl

# admin.site.register(models.UserInfo,Zhanggen) #支持表名使用[models.UserInfo，models.Group]，共同使用zhangen配置，一般不常用

admin.site.register(models.UserGroup)

2、通过 list_display列表，自定制显示的列（数据库中没有的字段）

from django.contrib import admin

from . import models

from django.utils.safestring import mark_safe

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','xx',]  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    def xx(self,obj):  #obj =当前行的对象

        # return '自定义列'+obj.name

        tpl=mark_safe('<a href="http://news.baidu.com/?tn=news/">链接</a>'.format(obj.pk))

        return tpl

admin.site.register(models.UserInfo,Zhanggen)

admin.site.register(models.UserGroup)

3、list_display_links 设置显示的列可以跳转

from django.contrib import admin

from . import models

from django.utils.safestring import mark_safe

# @admin.register(models.UserInfo)  #使用装饰器的方法，注册表到admin

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','xx',]  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    list_display_links = ['name','nickname']  #定制可以跳转的字段

    def xx(self,obj):  #obj =当前行的对象

        # return '自定义列'+obj.name

        tpl=mark_safe('<a href="http://news.baidu.com/?tn=news/">链接</a>'.format(obj.pk))

        return tpl

admin.site.register(models.UserInfo,Zhanggen) #支持表名使用[models.UserInfo，models.Group]，共同使用zhangen配置，一般不常用

admin.site.register(models.UserGroup)

4、list_filter = ['group'] 定制右侧筛选条件

from django.contrib import admin

from . import models

from django.utils.safestring import mark_safe

# @admin.register(models.UserInfo)  #使用装饰器的方法，注册表到admin

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname',]  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    list_display_links = ['name','nickname',]  #定制可以跳转的字段

    list_filter = ['group','name']              #定制右侧筛选条件

    # def xx(self,obj):  #obj =当前行的对象

    #     # return '自定义列'+obj.name

    #     tpl=mark_safe('<a href="http://news.baidu.com/?tn=news/">链接</a>'.format(obj.pk))

    #     return tpl

admin.site.register(models.UserInfo,Zhanggen) #支持表名使用[models.UserInfo，models.Group]，共同使用zhangen配置，一般不常用

admin.site.register(models.UserGroup)

自定制筛选分组和页面数据筛选条件

from django.contrib import admin

from . import models

from django.utils.translation import ugettext_lazy as _

from django.utils.safestring import mark_safe

# @admin.register(models.UserInfo)  #使用装饰器的方法，注册表到admin

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    # list_display_links = ['name','nickname',]  #定制可以跳转的字段

   #自定制 分组 和筛选的条件

    class Ugg(admin.SimpleListFilter):

        title = _('圣诞快乐的解决')

        parameter_name = 'xxxxxx' #点击组名 a标签携带的值，执行queryset方法

        def lookups(self, request, model_admin):

            """

            显示筛选选项

            :param request:

            :param model_admin:

            :return:

            """

            return models.UserGroup.objects.values_list('id','title')

        def queryset(self, request, queryset):

            """

            点击筛选查询时候，筛选用户表符合筛选条件的内容

            """

            v = self.value()

            if v:

                return queryset.filter(group_id=v)

            else:

                return queryset    # print(queryset)   #查询userinfo表的全部数据

    list_filter = ['group',Ugg]      #定制右侧筛选条件，通用场景把组里所有的人列出来

    # def xx(self,obj):  #obj =当前行的对象

    #     # return '自定义列'+obj.name

    #     tpl=mark_safe('<a href="http://news.baidu.com/?tn=news/">链接</a>'.format(obj.pk))

    #     return tpl

admin.site.register(models.UserInfo,Zhanggen) #支持表名使用[models.UserInfo，models.Group]，共同使用zhangen配置，一般不常用

admin.site.register(models.UserGroup)

5、list_select_related = ['group']，如果显示的列间存在foreign key关系，可以自动select_related，提高性能；

6、分页相关

  list_per_page = 1  #一页显示数据库中多少条数据

    list_max_show_all = 200 #最大显示行数

    paginator = Paginator

7、list_editable = ['nickname', ]进入编辑模式

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_editable = ['nickname', ] #进入编辑模式

    list_display = ['name','nickname','group']

8、search_fields = ('name',) #根据字段，做模糊搜索功能

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    search_fields = ('name',)

    list_display = ['name','nickname','group']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

9、 date_hierarchy = 'ctime'，列表时，对Date和DateTime类型进行搜索

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    date_hierarchy = 'ctime' #根据时间进行筛选

10、preserve_filters=True，页面跳转回来之后保留搜素条件

10、 save_as = False，详细页面，按钮为“Sava as new” 或 “Sava and add another”

11.、save_as_continue = True，点击保存并继续编辑

12、inlines = [UserInfoInline, ]，在操作foreign key的表时，联动操作从表；（在增加组的时候，也可以增加组里的用户）

class UserInfoInline(admin.StackedInline):  # TabularInline

    extra = 0

    model = models.UserInfo

class GroupAdminMode(admin.ModelAdmin):

    list_display = ( 'title',)

    inlines = [UserInfoInline, ]

admin.site.register(models.UserGroup,GroupAdminMode)

主表和从表直间横向显示，继承TabularInline类

class UserInfoInline(admin.TabularInline):  # 继承TabularInline类，排列的方式不同

    extra = 0

    model = models.UserInfo

class GroupAdminMode(admin.ModelAdmin):

    list_display = ( 'title',)

    inlines = [UserInfoInline, ]

admin.site.register(models.UserGroup,GroupAdminMode)

13、扩展admin的操作，actions = [zhanggen,] 例如：增、删、改、查

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    search_fields = ('name',)  # 根据字段搜素，框

    def zhanggen(self,request,queset):

        print(self,request,queset)

        print(request.POST.getlist('_selected_action'))  #拿到前端选择 的id

    zhanggen.short_description = '中文显示自定义Actions'

    actions = [zhanggen,]

14、change_list_template = ['test.html'] 把DjangoAdmin的路径，更换成自己的模板路径；

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    change_list_template = ['test.html'] #更换自己的查询时显示模板路径

    add_form_template = ['add.ttml']   #增加

    delete_confirmation_template = None #删除

    delete_selected_confirmation_template = None ##选中之后批量

    object_history_template = None

15、raw_id_fields，详细页面，针对FK和M2M字段变成以Input框形式

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    raw_id_fields = ('group', 'roles',) #在详细页面，把'FK字段', 'M2M字段'显示成input框

16、fields，详细页面时，显示字段的字段

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    fields = ['name','nickname']  #定义显示页面，显示的字段

17、exclude = ['name'] 配置显示页面，不显示的字段

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    exclude = ['name']  #定义显示页面，不显示的字段

18、readonly_fields = ['name'] 配置显示页面，某字段只读不允许修改

19、fieldsets，详细页面时，使用fieldsets标签对数据进行分割显示

@admin.register(models.UserInfo)

class UserAdmin(admin.ModelAdmin):

    fieldsets = (

        ('基本数据', {

            'fields': ('user', 'pwd', 'ctime',)

        }),

        ('其他', {

            'classes': ('collapse', 'wide', 'extrapretty'),  # 'collapse','wide', 'extrapretty'

            'fields': ('user', 'pwd'),

        }),

    )

20、详细页面时，M2M显示时，数据移动选择（方向：上下和左右）

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    filter_vertical = ("roles",) #选中多对多字段时，上下显示

    filter_horizontal=('roles') #选中多对多字段时，左右显示

21、ordering = ('-id',) 数据排序规则

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    # ordering = ('id',)   #按id大小 排序显示

    ordering = ('-id',)#倒序显示

22、view_on_site，编辑页面，显示view on set按钮，可以设置跳转会显示页面

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    def view_on_site(self, obj):

        return 'https://www.baidu.com'

23、radio_fields，详细页面时，使用radio显示选项（FK默认使用select）

radio_fields = {"ug": admin.VERTICAL} # 或admin.HORIZONTAL

24、show_full_result_count = True，列表时，模糊搜索后面显示的数据个数样式

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    search_fields = ('user',)

    show_full_result_count = True  # 1 result (12 total)

25、 formfield_overrides = {}，详细页面时，指定现实插件

from django.forms import widgets

from django.utils.html import format_html

class MyTextarea(widgets.Widget):

    def __init__(self, attrs=None):

        # Use slightly better defaults than HTML's 20x2 box

        default_attrs = {'cols': '', 'rows': ''}

        if attrs:

            default_attrs.update(attrs)

        super(MyTextarea, self).__init__(default_attrs)

    def render(self, name, value, attrs=None):

        if value is None:

            value = ''

        final_attrs = self.build_attrs(attrs, name=name)

        return format_html('<textarea {}>\r\n{}</textarea>',final_attrs, value)

@admin.register(models.UserInfo)

class UserAdmin(admin.ModelAdmin):

    formfield_overrides = {

        models.models.CharField: {'widget': MyTextarea},

    }

26、prepopulated_fields = {}，同步填充input框中的数据

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    prepopulated_fields = {"email": ("name", "nickname",)}

27. form = ModelForm，自定义表单验证组件

from django.contrib import admin

from django.core.paginator import Paginator

from . import models

from django.utils.translation import ugettext_lazy as _

from django.utils.safestring import mark_safe

from django.forms import ModelForm

from django.forms import fields

class MyForm(ModelForm):

    others = fields.CharField()

    class Meta:

        model = models = models.UserInfo

        fields = "__all__"

        error_messages = {'name': {'required': '用户不能为空'}}

# @admin.register(models.UserInfo)  #使用装饰器的方法，注册表到admin

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    form = MyForm

28. empty_value_display = "列数据为空时，设置显示默认值"

@admin.register(models.UserInfo)

class UserAdmin(admin.ModelAdmin):

    empty_value_display = "列数据为空时，默认显示"

    list_display = ('user','pwd','up')

    def up(self,obj):

        return obj.user

    up.empty_value_display = "指定列数据为空时，默认显示"

三、DjangoAdmin配置总结：

每个注册到DjangoAdmin的1张表对应一个自定制类（继承admin.ModelAdmin默认配置类），表中数据按配置进行显示；2张表的自定义的配置类相互不影响，如果没有自定义配置类，会自动使用默认配置；

使用：

1、在model.py中创建表

2、把表名注册到admin.py

A、admin.site.registe（表名，自定义配置类）

admin.site.register(models.UserInfo,Zhanggen)

B、装饰器方式注册表

# @admin.register(models.UserInfo)  #使用装饰器的方法，注册表到admin

3.自定义配置类，扩展功能

类名（admin.ModelAdmin）注意继承默认配置，才能扩展功能；

class Zhanggen(admin.ModelAdmin): #必须继承admin.ModelAdmin基础配置类

    list_display = ['name','nickname','group','ctime']  #列表中 包含数据库中哪个字段，就在DjangoAdmin页面显示哪个字段

    form = MyForm

通过在每张表中定义配置类的静态字段，显示表中内容

4、自动生成了表名对应的URL映射发下URL规则：/app名称/表名/pk/操作

参考博客链接银角大王：http://www.cnblogs.com/wupeiqi/articles/7444717.html

巴特西

Django之DjangoAdmin

前言：

一、DjangoAdmin的基本使用

二、自定义DjangoAdmin配置对象

三、DjangoAdmin配置总结：

最新文章

热门文章