第5章通过xadmin快速搭建后台管理系统

忘是亡心i 2022-06-15 09:44 187阅读 0赞

> 慕课网《[强力django+杀手级xadmin 打造上线标准的在线教育平台][django_xadmin]》 学习笔记

--------------------

本章主要内容：

*  通过xadmin结合第4章设计的model快速的搭建一套完整的后台管理系统；
 *  本章首先介绍django admin的简单使用， 然后引出xadmin，在安装xadmin之后将model注册到xadmin中， 最后完成xadmin的全局配置

--------------------

### django admin 的简单使用 ###

![这里写图片描述][SouthEast]

*  更改语言和时区  
    在settings中更改

LANGUAGE_CODE = 'zh-hans'
    TIME_ZONE = 'Asia/Shanghai'     # 时区
    USE_TZ = False      # 使用本地时间，而不是UTC时间

*  注册模型  
    ![这里写图片描述][SouthEast 1]
 *  简单操作

### 更加强大的xadmin ###

*  github: [https://github.com/sshwsfc/xadmin][https_github.com_sshwsfc_xadmin]
 *  github.io：[http://sshwsfc.github.io/xadmin/][http_sshwsfc.github.io_xadmin]
 *  pip安装

pip install xadmin

![这里写图片描述][SouthEast 2]

*  源码安装（最新，新特性）
 *  将xadmin注册到settings中

'xadmin',
        'crispy_forms',

*  修改项目的urls.py，替换默认的admin

import xadmin
    urlpatterns = [
        url(r'^xadmin/', xadmin.site.urls),
    ]

*  设置pycharm文件模板

![这里写图片描述][SouthEast 3]

*  在每个app中新建adminx.py文件，在此处注册app的model  
    
    
     *  list\_display 展示
     *  search\_fields 搜索
     *  list\_filter 过滤

详细参考xadmin文档：[https://xadmin.readthedocs.io/en/latest/quickstart.html][https_xadmin.readthedocs.io_en_latest_quickstart.html]

# -*- coding: utf-8 -*-
    __author__ = 'bobby'
    __date__ = '2016/10/25 21:07'
    
    import xadmin
    from xadmin import views
    from xadmin.plugins.auth import UserAdmin
    from xadmin.layout import Fieldset, Main, Side, Row
    from django.utils.translation import ugettext as _
    
    from .models import EmailVerifyRecord, Banner, UserProfile
    
    
    class UserProfileAdmin(UserAdmin):
        def get_form_layout(self):
            if self.org_obj:
                self.form_layout = (
                    Main(
                        Fieldset('',
                                 'username', 'password',
                                 css_class='unsort no_title'
                                 ),
                        Fieldset(_('Personal info'),
                                 Row('first_name', 'last_name'),
                                 'email'
                                 ),
                        Fieldset(_('Permissions'),
                                 'groups', 'user_permissions'
                                 ),
                        Fieldset(_('Important dates'),
                                 'last_login', 'date_joined'
                                 ),
                    ),
                    Side(
                        Fieldset(_('Status'),
                                 'is_active', 'is_staff', 'is_superuser',
                                 ),
                    )
                )
            return super(UserAdmin, self).get_form_layout()
    
    class BaseSetting(object):
        enable_themes = True
        use_bootswatch = True
    
    class GlobalSettings(object):
        site_title = "慕学后台管理系统"
        site_footer = "慕学在线网"
        # menu_style = "accordion"
    
    class EmailVerifyRecordAdmin(object):
        list_display = ['code', 'email', 'send_type', 'send_time']
        search_fields = ['code', 'email', 'send_type']
        list_filter = ['code', 'email', 'send_type', 'send_time']
        model_icon = 'fa fa-address-book-o'
    
    class BannerAdmin(object):
        list_display = ['title', 'image', 'url', 'index', 'add_time']
        search_fields = ['title', 'image', 'url', 'index']
        list_filter = ['title', 'image', 'url', 'index', 'add_time']
    
    
    # from django.contrib.auth.models import User
    # xadmin.site.unregister(User)
    xadmin.site.register(EmailVerifyRecord, EmailVerifyRecordAdmin)
    xadmin.site.register(Banner, BannerAdmin)
    # xadmin.site.register(UserProfile, UserProfileAdmin)
    
    xadmin.site.register(views.BaseAdminView, BaseSetting)
    xadmin.site.register(views.CommAdminView, GlobalSettings)

![这里写图片描述][SouthEast 4]

### xadmin的全局配置 ###

*  users 的adminx.py里面

from xadmin import views
    
    # 基本的修改
    class BaseSetting(object):
        enable_themes = True   # 打开主题功能
        use_bootswatch = True  # 
    
    # 针对全局的
    class GlobalSettings(object):
        site_title = "慕学后台管理系统"  # 系统名称
        site_footer = "慕学在线网"      # 底部版权栏
        # menu_style = "accordion" # 将菜单栏收起来
    
    
    # 注册，注意一个是BaseAdminView，一个是CommAdminView
    xadmin.site.register(views.BaseAdminView, BaseSetting)
    xadmin.site.register(views.CommAdminView, GlobalSettings)

*  修改菜单栏的名称，需要修改两个地方  
    ![这里写图片描述][SouthEast 5]

![这里写图片描述][SouthEast 6]

*  最终结果  
    ![这里写图片描述][SouthEast 7]

[django_xadmin]: http://coding.imooc.com/class/78.html
[SouthEast]: /images/20220615/038c40e3c7154caa9c22640512eac684.png
[SouthEast 1]: /images/20220615/293a15154ba043d6b5644aca07f55ce9.png
[https_github.com_sshwsfc_xadmin]: https://github.com/sshwsfc/xadmin
[http_sshwsfc.github.io_xadmin]: http://sshwsfc.github.io/xadmin/
[SouthEast 2]: /images/20220615/ba532dc800b44f46be30d2dd997b35b5.png
[SouthEast 3]: /images/20220615/2770aaf5c1e24560ac4bb6c97ab4cbbb.png
[https_xadmin.readthedocs.io_en_latest_quickstart.html]: https://xadmin.readthedocs.io/en/latest/quickstart.html
[SouthEast 4]: /images/20220615/9962e9c1eb7a4c0f8f572e5a11a03220.png
[SouthEast 5]: /images/20220615/3b0183b1943347c2be727d9f9b4c9cbe.png
[SouthEast 6]: /images/20220615/bcd8b18d53d444a29e8feb7c257a7a22.png
[SouthEast 7]: /images/20220615/fade89513d8546448bc92b876365ce0b.png