Django admin美化插件suit应用[原创]

前言

由于比较懒，自己弄了一个用户验证，没有自己写后台，用了django自带的user认证，并通过admin直接进行管理，但默认的admin并不漂亮，于是使用了这个django-suit插件，效果对比一下。

我用的是django-1.9.9它的admin是这样的。老版本的django admin长的更丑。

使用了suit之后的admin是这样的。

清凉了很多吧，现在开始搞它。

基础环境

我的环境

python: 2.7.10

django: 1.9.9
安装

pip install django-suit # 安装完毕了

配置部分

表结构

使用了自带的user，由于要添加一个字段，所以做了OneToOneField

models.py

from django.db import models

from django.contrib.auth.models import User, Group

class UserProfile(models.Model):

    user = models.OneToOneField(User)

    name = models.CharField(u'姓名', max_length=32, blank=True, null=False)

    class Meta:

        verbose_name = u'用户详情'

        verbose_name_plural = u"用户详情"

settings.py设置

INSTALLED_APPS = [

'suit',  # 添加suit支持

'django.contrib.admin',

'django.contrib.auth',

'django.contrib.contenttypes',

'django.contrib.sessions',

'django.contrib.messages',

'django.contrib.staticfiles',

'web_sso',

]

......

LANGUAGE_CODE = 'zh-Hans'  # 设置成中文，老版本django使用'zh_CN'

TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_L10N = False  # 注意是False 配合下边时间格式

USE_TZ = False  # 如果只是内部使用的系统，这行建议为false，不然会有时区问题

DATETIME_FORMAT = 'Y-m-d H:i:s'  # suit在admin里设置时间的一个小bug。需要把时间格式指定一下

DATE_FORMAT = 'Y-m-d'

......

SUIT_CONFIG = {  # suit页面配置

    'ADMIN_NAME': '统一认证平台',  #登录界面提示

    'LIST_PER_PAGE': 20,

    'MENU': ({'label': u'用户管理', 'app': 'web_sso', 'models': ('web_sso.MyUser', 'auth.Group', 'web_sso.User_ex')},  #每一个字典表示左侧菜单的一栏

             # {'label': u'SQL管理', 'app': 'web_sso', 'models': ('web_sso.Sql', 'web_sso.PreSql', 'web_sso.Direction')},  # 可以是多个字典

             ),

    # label表示name，app表示上边的install的app，models表示用了哪些models

}

admin.py配置

这里只介绍一些最基础的admin的配置，详细可以参考django book的admin部分，后续的定制化admin部分请参考我后边的博文，将对admin进行较为深度的改造以便较适应复杂的需求。

from django.contrib import admin

from web_sql import models

class UserProfileAdmin(admin.ModelAdmin):

    list_display = ('user', 'name', 'get_email', 'get_is_active')  # 定义admin总览里每行的显示信息，由于email是在userprofile的外键user表中，所以需要特殊返回，注意这个字段不能用user__email的形式

    search_fields = ('user__username', 'name')  # 定义搜索框以哪些字段可以搜索，因为username是在user表中，所以用user__username的形式，这里需要注意下，不能直接用user表名，要用字段名，表名__字段名

    list_filter = ('user__groups', 'user__is_active')  #传入的需要是列表，设定过滤列表

    def get_email(self, obj):  # 定义这个函数是由于email是在userprofile表的外键表user里，所以需要单独return一下

        return obj.user.email

    get_email.short_description = 'Email'  #list展示时候显示的title

    get_email.admin_order_field = 'user__email'  #指定排序字段

    def get_is_active(self, obj):

        return obj.user.is_active

    get_is_active.short_description = '有效'

    get_is_active.admin_order_field = 'user__is_active'

admin.site.register(models.UserProfile, UserProfileAdmin) # 引用的固定格式，注册的model和对应的Admin，Admin放在后边，同样还有noregister方法：比如admin.site.noregister(Group)，把group这个表在admin中去掉（默认user和group都是注册到admin中的）

其他admin小技巧，admin自定义js或css，以实现一些自己想要的效果

admin.py

class DirectionAdmin(admin.ModelAdmin):

    list_display = ('describe', 'db_name')

    class Media:

        js = ('js/my_own_admin.js',)

        css = {

             'all': ('css/admin/my_own_admin.css',)

        }

admin.site.register(models.Direction, DirectionAdmin)

# 然后把对应的js或css文件写入到static下边的指定文件里吧，运行admin的页面会额外引用你自己的css和js文件

效果展示如下

结语

先写到这里，其实除了美化，admin还可以做很多事情，但是由于都在django的源码里，可定制化不如自己写的后台那么灵活，但也是可以定制的，定制的方法，请参考我后边的文章。Django admin定制化，User字段扩展[原创]