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 後臺管理登錄頁面:
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。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章