一.簡介

xadmin 是一個開源項目。 針對于 django admin ，頁面美化程度，功能不完善 等問題 , 額外開發(fā)的一個模塊。目前 xadmin 的最新版本已經(jīng)是 xadmin 3.0 ，但是 xadmin 3.0 已經(jīng)變成了一個純前端項目，有興趣的同學可以自己研究下。目前 作者已經(jīng)不對 xadmin 2.0 做版本維護了，所以社區(qū)并不是很好，建議選擇 其他的持續(xù)維護的開源項目。

文檔:https://xadmin.readthedocs.io/en/latest/index.html

二.安裝

環(huán)境：python 3.6
Django 2.2

1.通過如下命令安裝xadmin的最新版，它文檔里面的安裝方法好久沒有更新了，會導致你安裝不成功，所以我們使用下面的網(wǎng)址進行安裝

pip3 install https://codeload.github.com/sshwsfc/xadmin/zip/django2

2.在配置文件中注冊如下應用

INSTALLED_APPS = [
  ...
  'xadmin',
  'crispy_forms',
  'reversion',
  ...
]

3.修改語言和時區(qū)

# 修改使用中文界面
LANGUAGE_CODE = 'zh-Hans'

# 修改時區(qū)
TIME_ZONE = 'Asia/Shanghai'

4.xadmin有建立自己的數(shù)據(jù)庫模型類，需要進行數(shù)據(jù)庫遷移

友情提示：在執(zhí)行這一步時先到配置文件看一下自己當前Django版本

我的原本是Django2.2版本，安裝完xadmin后自動給我升級為3.2版本，導致執(zhí)行數(shù)據(jù)庫遷移命令時報錯

python3 manage.py makemigrations
python3 manage.py migrate

5.配置路由信息

import xadmin
xadmin.autodiscover()

# version模塊自動注冊需要版本控制的 Model
from xadmin.plugins import xversion
xversion.register_models()

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

7.如果沒有創(chuàng)建超級用戶需要創(chuàng)建，我是因為已經(jīng)創(chuàng)建了就不需要了

python3 manage.py createsuperuser

三.全局配置

import xadmin
from xadmin import views

class BaseSetting(object):
  """xadmin的基本配置"""
  enable_themes = True # 開啟主題切換功能
  use_bootswatch = True # 引導控制盤(其實就是我們的左側(cè)菜單欄)

xadmin.site.register(views.BaseAdminView, BaseSetting)

class GlobalSettings(object):
  """xadmin的全局配置"""
  site_title = "kuokay" # 設置站點標題
  site_footer = "kuokay學python" # 設置站點的頁腳
  menu_style = "accordion" # 設置菜單折疊

xadmin.site.register(views.CommAdminView, GlobalSettings)

站點Model管理

xadmin可以使用的頁面樣式控制基本與Django原生的admin一直。

可以在models類中定義個__str__方法來定義對象顯示成什么內(nèi)容

• list_display 控制列表展示的字段
• search_fields 控制可以通過搜索框搜索的字段名稱，xadmin使用的是模糊查詢
• list_filter 可以進行過濾操作的列，對于分類、性別、狀態(tài)
• ordering 默認排序的字段
• show_detail_fields 在列表頁提供快速顯示詳情信息
• list_editable 在列表頁可以快速直接編輯的字段
• refresh_times 指定列表頁的定時刷新
• list_export 控制列表頁導出數(shù)據(jù)的可選格式
• show_bookmarks 控制是否顯示書簽功能
• data_charts 控制顯示圖表的樣式
• model_icon 控制菜單的圖標【圖標的設置可以參考font-awesome的圖標css名稱】
• readonly_fields 在編輯頁面的只讀字段
• exclude 在編輯頁面隱藏的字段,比如判斷這個數(shù)據(jù)是否刪除的delete_status字段，一般就是用來標識一下字段是不是被刪除了，但是數(shù)據(jù)庫中不刪除

到此這篇關于Django xadmin安裝及使用詳解的文章就介紹到這了,更多相關Django xadmin安裝使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論