快速入门指南

要使用Xadmin,需要安装Django 2.2并且必须激活管理站点

安装

pip install xadmin-py3

运行演示

如果已下载或克隆xadmin-py3源码,则可以进入demo_app目录,运行演示实例:

cd demo_app
python manage.py runserver

指向浏览器以http://127.0.0.1:8000查看结果。

使用现有项目

首先,编辑settings.py,添加 Xadmin 到INSTALLED_APPS

INSTALLED_APPS = [
    ...

    'xadmin',
    # django-crispy-forms DRY表单
    'crispy_forms',
    # django-reversion 版本控制
    'reversion',

    ...
]

然后添加URL模式并执行autodiscover

from django.urls import path
from django.contrib import admin

# 取消注释接下来的两行以启用管理员:
import xadmin
xadmin.autodiscover()

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


urlpatterns = [
    path(r'admin', admin.site.urls),
]

urlpatterns += [
    path(r'', xadmin.site.urls),
]

收集静态资源(安装在服务器才需要):

python manage.py collectstatic