Xadmin 快速入门指南
要使用Xadmin,需要安装Django 1.4并且必须激活管理站点。
注:由于Xadmin已经停止维护,使用Django2.0 以上版本会存在许多兼容性问题
安装
使用pip
:
pip install django-xadmin
从源代码安装
从https://github.com/sshwsfc/django-xadmin下载最新的源代码或者从仓库git clone
。然后在项目目录中执行以下命令:
pip install -r requirements.txt
注:不建议使用pip直接安装,建议下载源码之后自行配置。配置方案参考其他中文博客。
运行演示
如果已下载Xadmin的源代码,你将会在工程目录找到一个demo_app
文件夹。以下命令可以用来快速创建Xadmin的演示实例:
cd demo_app
python manage.py runserver
使用浏览器访问http://127.0.0.1:8000
查看结果。
使用现有项目
作为Django应用程序,Xadmin可以轻松插入Django支持的站点。
首先,编辑你的setting.py
,将Xadmin添加到INSTALLED_APPS
。(请注意,还需要安装原Django admin app的依赖项,但Django admin 自身不需要):
INSTALLED_APPS = (
...
'xadmin', # 必选
'crispy_forms', # 必选
'reversion', # 可选
...
)
然后添加urlpatterns
并执行autdiscover
:
# -*- 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)),
)
收集 media:
python manage.py collectstatic