Django2.2 学习笔记 (9)_配置xadmin

一、环境说明

python 3.7

Django 2.2

Pycharm 2019.1

二、下载Xamin

1、官方下载路径 https://github.com/sshwsfc/xadmin 选择branch 选择 django2 

2、考虑到官方版本适配Django 2.2时会有较多错误，这里提供亲测可完美适用于Django2.2的版本

三、配置

1、为了区分自建应用和引用的第三方应用，新建apps和extra_app目录，并将两个目录设置为项目资源文件

选中目录 → 右键 → Mark Directory as → Sources Root

2、为了让程序识别该app需在settings.py中配置相应路径

# MxOnline/MxOnlie/settings.py
import os
import sys     # 新增

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))      # 新增
sys.path.insert(0, os.path.join(BASE_DIR, 'extra_apps'))        # 新增

3、将下载下来的xadmin文件夹完整拷贝到extra_app目录中

4、在setting.py文件中注册xadmin

# MxOnline/MxOnlie/settings.py

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'apps.users.apps.UsersConfig',
    'apps.courses.apps.CoursesConfig',
    'apps.operations.apps.OperationsConfig',
    'apps.organizations.apps.OrganizationsConfig',
    'crispy_forms',        # 新增，特别注意！
    'xadmin',        # 新增
]

5、在urls.py中配置xadmin的访问地址

# MxOnline/MxOnlie/urls.py

from django.contrib import admin
from django.urls import path
import xadmin        # 新增

urlpatterns = [
    path('admin/', admin.site.urls),
    path('xadmin/', xadmin.site.urls),]        # 新增

6、安装xadmin文件夹中requirements.txt提到的依赖包

django-crispy-forms
django-import-export
django-reversion
django-formtools
future
httplib2
six
xlwt
xlsxwriter
requests

7、执行makemigrations和migrate命令，同步相应的表

python manage.py makemigrations
python manage.py migrate

8、【如果之前使用Django自带的admin已经配置过则可忽略这步】

1）创建超级用户

# 在Terminal中输入命令

createsuperuser

2）在settings.py中配置中文和时区

# MxOnline/MxOnlie/settings.py

LANGUAGE_CODE = 'zh-hans'        # 更改

TIME_ZONE = 'Asia/Shanghai'        # 更改

USE_TZ = False        # 更改。默认True（虽然前端显示的时区更改了，但是引用系统时间写进数据库时，仍旧是Django的默认时区，而不是更改后Asia/Shanghai）

9、测试

启动项目并打开链接：http://127.0.0.1:8000/xadmin/

end