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

如果想使用 Xadmin， 您需要安装 Django 1.4（及以上版本） 并且必须激活 Admin site（admin 站点管理）。

一、安装

使用 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 后台管理登录页面：

Django 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。