一、环境说明
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