Xadmin 組件基礎使用以及全局配置

xadmin 的安裝

方式一 pip 安裝

會由於編碼問題致使報錯 所以須要下載 更改 README.rst 後本地安裝

詳情點擊 這裏 

方式二 源碼方式安裝

在 github 上下載源碼後 將 xadmin app 包直接以 第三方 app 的形式填入到咱們的項目中

固然須要 settings.py 中註冊

詳情往下看簡單使用示例

xadmin 簡單使用

第一步  settings.py 設置

裏面的添加 app

須要加兩個 

    'xadmin',
    'crispy_forms',

第二步 設置路由 

urlpatterns = [
    # url(r'^admin/', admin.site.urls),
    url(r'^xadmin/', xadmin.site.urls),
]

第三步 初始表建立

若是沒有建立直接使用會有 1146 的報錯

所以須要 

python manage.py makemigrations
python manage.py migrate

第四步 註冊表

新建一個 adminx.py 替代 admin.py ( 隨意刪除 )

而後註冊和 admin 相似 

import xadmin

from .models import UserAsk, UserCourse, UserMessage, CourseComments, UserFavorite


# 用戶諮詢註冊
class UserAskAdmin(object):
    list_display = ['name', 'mobile', 'course_name', 'add_time']
    search_fields = ['name', 'mobile', 'course_name']
    list_filter = ['name', 'mobile', 'course_name', 'add_time']

xadmin.site.register(UserAsk, UserAskAdmin)

第五步 登陸web查看 

 訪問 127.0.0.1:8000/xadmin 本身設置的 url 訪問

須要一個 super帳號 

建立也是從 manage.py  中 createsuperuser

登陸後就能夠看到相關的被註冊的表能夠進行後臺數據操做了

Xadmin 全局配置

使能主題相關功能

在任意的 adminx.py 中作如下配置 

from xadmin import views


class BaseSetting(object):
　　enable_themes = True  # 打開主題功能
　　use_bootswatch = True  # 打開可選主題庫


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

 更改顯示名字以及按APP摺疊

# 更改後臺默認顯示信息
class GlobalSetting(object):
    site_title = "羊駝後臺管理系統"     # 左上角顯示信息
    site_footer = "羊駝總經聯合協會"    # 最下面公司信息
    menu_style = "accordion"    # 左側表名按 APP 摺疊


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

調整 app 顯示名字

此功能與 Xadmin 自己無關, 是 django 自帶的機制

須要修改 每一個 APP 下的 init 和 apps 

apps.py 下 添加 verbose_name 

from django.apps import AppConfig


class UsersConfig(AppConfig):
    name = 'users'
    verbose_name = "用戶信息"   # 設置顯示名字

__init__.py 中 加入使能的配置類

default_app_config = "users.apps.UsersConfig"