Django2.x 配置 Xadmin

Django2.x 配置 Xadmin -   本文来自 萨卡卡的文章 - 知乎 https://zhuanlan.zhihu.com/p/98396026

 

首先 Django2.x 需要 Xadmin-Django2 的支持（此为源码安装）

1.适配版地址：sshwsfc/xadmin (直接下载zip,下载后直接解压)

2.在项目内创建一个目录或者文件包名字自取(如: extra_apps)，创建成功后通过pycharm 选中extra_apps文件夹点击鼠

标右键选中菜单mark directory as 选择 sources root就可以变成上面的蓝色文件夹目录。

  

 3.将步骤一解压好的文件里面的 xadmin 复制到步骤二中所创建的目录中，并在项目的虚拟环境中安装目录下 requirements.txt 内的所需包。

  

4.接着开始配 settings.py 文件。

在BASE_DIR下面添加:
sys.path.insert(0, os.path.join(BASE_DIR, 'extra_apps'))
在INSTALLED_APPS里面添加:
    'xadmin',
    'crispy_forms',
    'reversion',
配置静态文件，以防xadmin界面加载不出来样式
STATIC_URL = '/static/'
STATICFILES_DIRS = [
    os.path.join(BASE_DIR,'static')
]

5.配置路由

from django.urls import path, include,re_path
import xadmin

urlpatterns = [
    re_path('xadmin/', xadmin.site.urls),
    path('admin/', admin.site.urls),
]

6.迁移文件生成数据库创建 xadmin 用户

python manage.py makemigrations 
python manage.py migrate 生成数据库
python manage.py createsuperuser 创建超级用户（用户名密码一定要记住，邮箱可以直接回车跳过）
python manage.py runserver 0.0.0.0:8080

7.成功启动后就可以访问页面

http://127.0.0.1:8080/xadmin/

 

 

 8.接下来可以进行配置xadmin管理后台的显示，在你的app下创建adminx.py文件，内容文件如下：

import xadmin
from .models import YourModel
from xadmin import views


class GlobalSiteSetting(object):
    # 设置后台顶部标题
    site_title = 'xxxxxx'
    # 设置后台底部标题
    site_footer = 'xxxx'
    # 设置可折叠
    menu_style = 'accordion'


# 启用主题管理器
class BaseXadminSetting(object):
    enable_themes = True
    # 使用主题
    use_bootswatch = True

# 配置图标
class SafeAdmin(object):
    model_icon = 'fa fa-key'

# 注册
xadmin.site.register(views.CommAdminView, GlobalSiteSetting)
xadmin.site.register(views.BaseAdminView, BaseXadminSetting)

# 注册密码库后台管理
xadmin.site.register(YourModel, SafeAdmin)

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

补充: 

如果想让这两个地方显示自定义的名字，请在你的项目app下的apps和models内分别添加verbose_name，verbose_name_plural