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