Django Xadmin 官方文档之一 Xadmin 快速入门指南

欢迎大家扫码关注我的微信公众号：
数据之恋

一、安装

使用 pip：

pip install django-xadmin

使用源码安装：

可以从 https://github.com/sshwsfc/django-xadmin 下载最新的源码包，或者从 git 仓库克隆。然后在项目目录下执行：

pip install -r requirements.txt

【注意】在执行命令前，您可以选择是否再次编辑 requirements.txt 文件。如果您不需要导出 Excel 工作手册，您可以删除其中的 xlwt，因为它不是必须的。

二、运行 Demo

如果您已经下载了 Xadmin 的源码，您能发现在项目下有一个名为 demo_app 的目录。下面的命令能够快速创建一个 Xadmin 的演示实例：

cd demo_app
python manage.py runserver

接着，您可以在浏览器地址栏输入 http://127.0.0.1:8000 来查看运行的结果。

三、在现有的项目上操作

作为一个 Django 应用程序， Xadmin 可以轻松的插入 Django 支持的网站。

首先，编辑您的 settings.py，将 Xadmin 添加到 INSTALLED_APPS中。（请注意， Django admin 应用程序的依赖项也必须安装，但是 Django admin 本身不需要安装）

INSTALLED_APPS = {
	...
	'xadmin',
	'crispy_forms',
	'reversion',
	...
}

然后添加 URL 模式并做 autodiscover：

# -*- coding: utf-8 -*-
import xadmin
xadmin.autodiscover()

# version 模块自动注册需要版本控制的 Model
from xadmin.plugins import xversion
xversion.register_models()

urlpatterns = patterns('', 
	url(r'^xadmin/', include(xadmin.site.urls)),
)

收集媒介：

python manage.py collectstatic

访问如下如所示：
Django admin 后台管理登录页面：
admin的后台管理登录页面
Django Xadmin 后台管理登录页面：
Xadmin的后台管理登录页面

四、后记

我自己按照步骤操作了一遍，其中第三部分是安装完成后，系统自动添加的，无须我们手动操作。但是部分代码略有不同。如：

urlpatterns = patterns('', 
	url(r'^xadmin/', include(xadmin.site.urls)),
)

在系统自动生成的时候，是：

urlpatterns = [
    url(r'^admin/', include(admin.site.urls)),
    url(r'^', include(xadmin.site.urls))
]

这样，使用 http://127.0.0.1:8000 便能直接访问 Django 的 Xadmin，但是如果按照 url(r'^xadmin/', include(xadmin.site.urls)),的方式设置，就需要访问 http://127.0.0.1:8000/xadmin/才能访问到 Django 的 Xadmin。