xadmin的安装和使用

安装

1. 安装

# 由于我们使用的python版本是3.6，因此需要下载和python3版本的xadmin安装包
# 有人说使用pip安装，但我使用pip安装总是python2的版本，不知道什么原因，你可以试一下
pip install https://github.com/sshwsfc/xadmin/tarball/master

在项目的根目录新建文件夹extra_apps，把下载的xadmin安装包放到该目录下

2. 注册

# 在配置文件中添加xadmin应用
INSTALLED_APPS = [
    ...
    'xadmin',
    'crispy_forms',
    'reversion',
    ...
]

3. xadmin有建立自己的数据库模型类，需要进行数据库迁移

python manage.py makemigrations
python manage.py migrate

4. 在总路由中添加xadmin的路由信息

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

使用

• xadmin不再使用Django的admin.py，而是需要编写代码在adminx.py文件中。
• xadmin的站点管理类不用继承admin.ModelAdmin，而是直接继承object即可。

1. 站点的全局配置

from xadmin import views
import xadmin

class BaseSetting(object):
    """xadmin的基本配置"""
    enable_themes = True  # 开启主题切换功能
    use_bootswatch = True  # 支持切换主题
xadmin.site.register(views.BaseAdminView, BaseSetting)


class GlobalSetting(object):
    """xadmin的全局配置"""
    site_title = "xxx后台管理系统"  # 设置站点标题
    site_footer = "xxx有限公司"  # 设置站点的页脚
    menu_style = "accordion"  # 设置菜单折叠，在左侧，默认的
xadmin.site.register(views.CommAdminView, GlobalSetting)

3. 模型站点管理
   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 控制菜单的图标

# 导入数据库模型
from company.models import CompanyNews
# 定义管理模型
class CompanyNewsAdmin(object):
    list_display = ['id', 'title', 'digest', 'author']
    search_fields = ['title', 'digest']
    ordering = ['-create_time', 'id']
    
# 把管理模型注册到站点
xadmin.site.register(CompanyNews, CompanyNewsAdmin)