xadmin的使用

• 通过如下命令安装xadmin的最新版

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

• 在配置文件中注册如下应用

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

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

python manage.py migrate

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

import xadmin

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

• 站点的全局配置

import xadmin
from xadmin import views

from goods import models

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

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

class GlobalSettings(object):
    """xadmin的全局配置"""
    site_title = "xxxx"  # 设置站点标题
    site_footer = "xxxx"  # 设置站点的页脚
    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 控制列表页导出数据的可选格式

• data_charts 控制显示图标的样式

• model_icon 控制菜单的图标

站点保存对象数据方法重写

• 在Django的原生admin站点中，如果想要在站点保存或删除数据时，补充自定义行为，可以重写如下方法：
  • save_model(self, request, obj, form, change)
  • delete_model(self, request, obj)
• 而在xadmin中，需要重写如下方法：
  • save_models(self)
  • delete_model(self)

在方法中，如果需要用到当前处理的模型类对象，需要通过self.obj来获取，如

class SKUSpecificationAdmin(object):
    def save_models(self):
        # 保存数据对象
        obj = self.new_obj
        obj.save()

        # 补充自定义行为
        from celery_tasks.html.tasks import generate_static_sku_detail_html
        generate_static_sku_detail_html.delay(obj.sku.id)

    def delete_model(self):
        # 删除数据对象
        obj = self.obj
        sku_id = obj.sku.id
        obj.delete()

        # 补充自定义行为
        from celery_tasks.html.tasks import generate_static_sku_detail_html
        generate_static_sku_detail_html.delay(sku_id)

自定义用户管理

import xadmin
# Register your models here.

from users.models import User
from xadmin.plugins import auth


class UserAdmin(auth.UserAdmin):
    list_display = ['id', 'username', 'mobile', 'email', 'date_joined']
    readonly_fields = ['last_login', 'date_joined']
    search_fields = ('username', 'first_name', 'last_name', 'email', 'mobile')
    style_fields = {'user_permissions': 'm2m_transfer', 'groups': 'm2m_transfer'}

    def get_model_form(self, **kwargs):
        if self.org_obj is None:
            self.fields = ['username', 'mobile', 'is_staff']

        return super().get_model_form(**kwargs)


xadmin.site.unregister(User)
xadmin.site.register(User, UserAdmin)