Xadmin 组件基础使用以及全局配置

xadmin 的安装

方式一 pip 安装

会因为编码问题导致报错 因此需要下载 更改 README.rst 后本地安装

详情点击这里

方式二 源码方式安装

在 github 上下载源码后 将 xadmin app 包直接以 第三方 app 的形式填入到我们的项目中

当然需要 settings.py 中注册

详情往下看简单使用示例

xadmin 简单使用

第一步  settings.py 设置

里面的添加 app

需要加两个

    'xadmin',
    'crispy_forms',

第二步 设置路由 

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

第三步 初始表创建

如果没有创建直接使用会有 1146 的报错

因此需要

python manage.py makemigrations
python manage.py migrate

第四步 注册表

新建一个 adminx.py 替代 admin.py ( 随意删除 )

然后注册和 admin 类似

import xadmin

from .models import UserAsk, UserCourse, UserMessage, CourseComments, UserFavorite

# 用户咨询注册
class UserAskAdmin(object):
    list_display = ['name', 'mobile', 'course_name', 'add_time']
    search_fields = ['name', 'mobile', 'course_name']
    list_filter = ['name', 'mobile', 'course_name', 'add_time']

xadmin.site.register(UserAsk, UserAskAdmin)

第五步 登录web查看

访问 127.0.0.1:8000/xadmin 自己设置的 url 访问

需要一个 super账号

创建也是从 manage.py  中 createsuperuser

登录后就可以看到相关的被注册的表可以进行后台数据操作了

Xadmin 全局配置

使能主题相关功能

在任意的 adminx.py 中做以下配置

from xadmin import views

class BaseSetting(object):
　　enable_themes = True  # 打开主题功能
　　use_bootswatch = True  # 打开可选主题库

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

更改显示名字以及按APP折叠

# 更改后台默认显示信息
class GlobalSetting(object):
    site_title = "羊驼后台管理系统"     # 左上角显示信息
    site_footer = "羊驼总经联合协会"    # 最下面公司信息
    menu_style = "accordion"    # 左侧表名按 APP 折叠

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

调整 app 显示名字

此功能与 Xadmin 本身无关, 是 django 自带的机制

需要修改 每个 APP 下的 init 和 apps 

apps.py 下 添加 verbose_name 

from django.apps import AppConfig

class UsersConfig(AppConfig):
    name = 'users'
    verbose_name = "用户信息"   # 设置显示名字

__init__.py 中 加入使能的配置类

default_app_config = "users.apps.UsersConfig"