Erlo

【tips】xadmin - django第三方后台管理系统

时间:2019-01-02   阅读:848次   来源:博客园
页面报错
点赞

  Django 为大家提供了一个完善的后台管理系统—admin,但是这个后台管理系统总体来说不太适合国人的习惯,所以有大神就使用 bootstrap 和 jQuery,为我们开发了一个第三 方的 Django 后台管理系统—xadmin,这个界面的友好度比较高,目前企业的使用频率比较高,我们来学习一些它的使用吧。


  一、下载安装(tips:如安装过程中出现3444错误,可在文章最后查看楼主亲测可用的解决方案):

1、在虚拟环境下 使用 pip install 安装

  通过此命令安装,会同时安装 Xadmin 所需的依赖库:django-crispy-forms-1.6.1、django-formtools-2.0httplib2-0.9.2、以及 xadmin-0.6.1,

pip install django-xadmin

 

  不过这种方式可能会出现编码等问题,不推荐。

2、下载源码安装:首先下载源代码,下载地址:https://github.com/sshwsfc/xadmin

  可对源码修改,体验更新特性,推荐。

  2.1 解压缩后将名为 xadmin 的文件夹拷贝进项目根目录下,当做一个模块存在。

  

 

  2.2 setting 文件中配置:


INSTALLED_APPS = [
...
'xadmin',
'crispy_forms',
'reversion',
]

 

 

      2.3 配置主路由,取代 Django 默认的 admin::

from django.conf.urls import url
from django.conf.urls import include
# from django.contrib import admin

# xadmin后台管理系统主路由配置
import xadmin
from xadmin.plugins import xversion
xadmin.autodiscover()
xversion.register_models()


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

 

      2.4 同步数据库
      
xadmin有建立自己的数据库模型类,需要进行数据库迁移

python manage.py makemigrations    # 此句可以不用执行, xadmin已自动生成migrations文件
python manage.py migrate

 

      2.5 创建超级用户:

python manage.py createsuperuser

      

 

      2.6 大功告成, 使用超级用户准备登录(公司项目基本不会给你管理员权限,这里只做演示用)。

      

 

      2.7 登陆成功,访问后台,界面如下:

        如果出现错误,可以使用如下命令升级

pip install --upgrade django-formtools

        注意,升级的过程中,如果将 Django 也升级了,如果不想升级 Django 的话,卸载了重新安装即可


  二 、 使用(后台管理)

    xadmin不再使用Django的admin.py,而是需要编写代码在adminx.py文件中。

    xadmin的站点管理类不用继承admin.ModelAdmin,而是直接继承object即可。

 

     站点的全局配置

 

import xadmin
from xadmin import views

from . import models

class BaseSetting(object):
    """xadmin的基本配置"""
    enable_themes = True  # 开启主题切换功能
    use_bootswatch = True

xadmin.site.register(views.BaseAdminView, BaseSetting)

class GlobalSettings(object):
    """xadmin的全局配置"""
    site_title = "xxxxxxxx"  # 设置站点标题
    site_footer = "xxxxxxx"  # 设置站点的页脚
    menu_style = "accordion"  # 设置菜单折叠

xadmin.site.register(views.CommAdminView, GlobalSettings)

View Code

 

     站点Model管理

 

xadmin可以使用的页面样式控制基本与Django原生的admin一直。

    list_display 控制列表展示的字段
    search_fields 控制可以通过搜索框搜索的字段名称,xadmin使用的是模糊查询
    list_filter 可以进行过滤操作的列
    ordering 默认排序的字段
    readonly_fields 在编辑页面的只读字段
    exclude 在编辑页面隐藏的字段
    list_editable 在列表页可以快速直接编辑的字段
    show_detail_fileds 在列表页提供快速显示详情信息
    refresh_times 指定列表页的定时刷新
    list_export 控制列表页导出数据的可选格式
    show_bookmarks 控制是否显示书签功能
    data_charts 控制显示图标的样式
    model_icon 控制菜单的图标

View Code

 

 


最后附上一个楼主安装遇到的一个小问题和解决办法:

问题:python3安装xadmin出现 UnicodeDecodeError: 'gbk' codec can't decode byte 0xa4 in position 3444

解决办法:

  1、README.rst这个文件的编码有问题,可是内容没什么重要的,可以直接到github上下载安装包,然后新建一个txt空文件,把文件名改成        README.rst,替换原来的文件。

    下载安装包,下载zip压缩文件,下载地址:

    https://github.com/sshwsfc/xadmin

  2、替换成功后,把压缩包放到一个文件夹中,在命令窗口中进入存放压缩包的文件下,执行pip命令。

  

 

  

 

 

参考资料:

xadmin 文档:http://xadmin.readthedocs.io/en/docs-chinese/

xadmin 官网:http://sshwsfc.github.io/xadmin/

 

一身污浊、自得其乐

 

 

 

 

    

 

 

评论留言

还没有评论留言,赶紧来抢楼吧~~

吐槽小黑屋()

* 这里是“吐槽小黑屋”,所有人可看,只保留当天信息。

  • Erlo吐槽

    Erlo.vip2021-02-25 21:51:22Hello、欢迎使用吐槽小黑屋,这就是个吐槽的地方。
  • 返回顶部

    给这篇文章打个标签吧~

    棒极了 糟糕透顶 好文章 PHP JAVA JS 小程序 Python SEO MySql 确认