xadmin 安装的正确姿势

xadmin 作为 django 框架的一个外置插件，提供强大的后台管理功能，且支持自定义插件、功能等，具有较高的灵活性。

由于 django 版本的更新，xadmin 也需要做出相应版本更新与功能适配，所以本文仅提供一个可用的 django+xadmin 版本组合和安装配置方式。

下载源码

前往 xadmin 的 git 仓库，直接”download zip“或 clone 到本地

Django环境搭建

• 一个python环境（虚拟环境也OK，版本３）
• 安装 Django 环境

$ pip install django==2.0

植入xadmin插件

（前提：自行创建好一个 Django 项目，使用的 python 环境如上述，以下操作在 PyCharm 中进行）

• 在项目根目录创建文件夹”extra-apps“，右键 -> "make directory as.." -> "sources root"
• 将下载的源码解压，复制其中的 xadmin 文件夹，粘贴至 ”extra-apps“ 文件夹中
• 编辑 settings.py，添加：

import sys

sys.path.insert(0, os.path.join(BASE_DIR, 'extra-apps'))

# 在 INSTALLED_APPS 中添加
INSTALLED_APPS = [
    ...
    'xadmin',
    'crispy_forms',
    ...
]

• 编辑 urls.py，修改：

# 原来
path('admin/', admin.site.urls),

# 修改
import xadmin
path('xadmin/', xadmin.site.urls),

• 至此，文件配置告一段落，若希望汉化 xadmin，只需要编辑 settings.py，修改：

LANGUAGE_CODE = 'zh-hans'

TIME_ZONE = 'Asia/Shanghai'

USE_TZ = False

• 想要运行项目，还需要安装一些 xadmin 需要的依赖包：

$ pip install future
$ pip install django-crispy-forms
$ pip install django-formtools
$ pip install httplib2
$ pip install six
$ pip install django-import-export

• 接下来便可以运行 django 项目了

$ python manage.py makemigrations

$ python manage.py migrate

# 创建超级用户，用以登录 xadmin 后台
$ python manage.py createsupreuser

$ python manage.py runserver

至此，环境部署与插件植入完成，可以愉快的使用 xadmin 了。