如果想使用 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。