安装或导入 xadmin

1 pip 安装

2 源码导入 在新建项目中新建extra_apps文件夹并将下载后的源码解压放入 （推荐，方便后续我们可以在源码中自定义一些插件的使用）

setting 的配置

1 如果采用源码放在django目录下extra_apps文件内的方式：则需将 extra_apps 文件加入到项目环境变量中去

sys.path.insert(0, os.path.join(BASE_DIR, 'extra_app'))

2 注册相关app， 找到INSTALLED_APPS，追加配置如下：

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

3 还有一些基础配置 语言时区等

LANGUAGE_CODE = 'zh-hans'

TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_L10N = True

USE_TZ = False

路由 url.py的配置

import xadmin
urlpatterns = [
 ......
 re_path('^xadmin/', xadmin.site.urls),
]

自定义modle类注册到后台管理界面：

在相关应用app文件夹中新建adminx.py 文件,并在其内进行相关设置

具体设置为：

1 对modle 相关表进行注册：

import xadmin
from .models import Book

class Bookadmin(object):
 list_display = ['name', 'author', 'bookType', 'ChapterNum', 'favNum', 'clickNum', 'add_time']
 list_filter = ['name', 'author', 'bookType', 'ChapterNum', 'favNum', 'clickNum', 'add_time']
 search_fields = ['name', 'author', 'bookType', 'ChapterNum', 'favNum', 'clickNum', ]

xadmin.site.register(Book, Bookadmin)

其中 list_display 为后台表中显示的列
其中 list_filter 为后台表中进行刷选功能的选项
其中 search_fields 为后台表中进行搜索功能的选项范围

2 对应用app显示名称的相关设置：

在相关app应用目录中的 apps.py 中进行相关设置：

class UsersConfig(AppConfig):
......
verbose_name = '应用名称'　　

在相关app应用目录中的 __init__.py 中进行相关设置：

default_app_config = 'users.apps.UsersConfig' # '应用名.apps.(apps.py中的相关Config名称)'

3 对xadmin进行全局设置：

在任意一个应用下的adminx.py中进行相关设置：#一般在user应用下设置

import xadmin
from xadmin import views

#主题功能配置注册
class BaseSetting(object):
 enable_themes = True
 use_bootswatch = True

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

#页眉页脚配置注册
class GlobalSetting(object):
 site_title = '小说网站后台管理'
 site_footer = '小说网站'
 menu_style = 'accordion' #应用下多表收缩
 
xadmin.site.register(views.CommAdminView, GlobalSetting)