Xadmin的配置及使用

xadmin是Django的第三方扩展，但是使Django的admin站点使用更方便。

1. 安装

经过以下命令安装xadmin的最新版

pip install https://github.com/sshwsfc/xadmin/tarball/master

在配置文件中注册以下应用

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

xadmin有创建本身的数据库模型类，须要进行数据库迁移

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

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

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

2. 使用

• 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) 

 

站点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 控制菜单的图标