django-simpleui 後臺主題框架安裝使用

一、簡介

simpleui 是一個基於django後臺管理的主題，主要是爲了美化和簡化django內置的後臺管理界面。

    內置28款流行的主題

    pip閃電安裝100%兼容原生admin無需修改代碼

    多標籤頁面，各個模塊更加清晰明瞭

    配置簡單，極速上手，在settings.py中加入simpleui後啓動立即生效，效率提升 100%！讓後端開發得心應手。

    Element-UI + Vue 加持，讓古老的django admin 煥然一新。

二、安裝simpleui模板

pip install simpleui

在項目中的settings.py文件中加入一行simpleui

INSTALLED_APPS = [
    'simpleui',
]

1、在settings.py中加入：

STATICFILES_DIRS = [
     os.path.join(BASE_DIR, "static"),
 ]

2、在項目下新建目錄static
3、克隆靜態資源到項目的靜態目錄，然後交由nginx處理

python manage.py collectstatic

啓動項目查看效果

python manage.py runserver

瀏覽器打開：
http://localhost:8000/admin/輸入用戶名/密碼登錄：

基本配置

修改LOGO

• 自定義SIMPLEUI的Logo

SIMPLEUI_LOGO = 'https://avatars2.githubusercontent.com/u/13655483?s=60&v=4'

 

配置首頁模塊

首頁默認展示3個模塊，服務器信息、快速操作、最近動作，大家可以根據需要來顯示或者隱藏某些模塊。

 

服務器信息

隱藏：

SIMPLEUI_HOME_INFO = False

顯示：

SIMPLEUI_HOME_INFO = True

 

快速操作

隱藏：

SIMPLEUI_HOME_QUICK = False

顯示：

SIMPLEUI_HOME_QUICK = True

 

最近動作

隱藏：

SIMPLEUI_HOME_ACTION = False

顯示：

SIMPLEUI_HOME_ACTION = True

 

使用分析

默認開啓，統計分析信息只是爲了更好的幫助simpleui改進，並不會讀取敏感信息。並且分析數據不會分享至任何第三方。

SIMPLEUI_ANALYSIS = False

值	說明
True	收集分析，一天只上報一次分析數據。默認爲True
False	不收集分析信息

 

菜單

 

自定義菜單

system_keep 保留系統菜單

該字段用於告訴simpleui，是否需要保留系統默認的菜單，默認爲False，不保留。 如果改爲True，自定義和系統菜單將會並存

menu_display 過濾顯示菜單和排序功能

該字段用於告訴simpleui，是否需要開啓過濾顯示菜單和排序功能。
默認可以不用填寫，缺省配置爲默認排序，不對菜單進行過濾和排序。
開啓認爲傳一個列表，如果列表爲空，則什麼也不顯示。列表中的每個元素要對應到menus裏面的name字段

dynamic 開啓動態菜單功能

該字段用於告訴simpleui，是否需要開啓動態菜單功能。
默認可以不用填寫，缺省配置爲False，不開啓動態菜單功能。
開啓爲True，開啓後，每次用戶登陸都會刷新左側菜單配置。
需要注意的是：開啓後每次訪問admin都會重讀配置文件，所以會帶來額外的消耗。

menus說明

字段	說明
name	菜單名
icon	圖標，參考element-ui和fontawesome圖標
url	鏈接地址，絕對或者相對,如果存在models字段，將忽略url
models	子菜單

例子

import time
SIMPLEUI_CONFIG = {
    'system_keep': False,
    'menu_display': ['Simpleui', '測試', '權限認證', '動態菜單測試'],      # 開啓排序和過濾功能, 不填此字段爲默認排序和全部顯示, 空列表[] 爲全部不顯示.
    'dynamic': True,    # 設置是否開啓動態菜單, 默認爲False. 如果開啓, 則會在每次用戶登陸時動態展示菜單內容
    'menus': [{
        'name': 'Simpleui',
        'icon': 'fas fa-code',
        'url': 'https://gitee.com/tompeppa/simpleui'
    }, {
        'app': 'auth',
        'name': '權限認證',
        'icon': 'fas fa-user-shield',
        'models': [{
            'name': '用戶',
            'icon': 'fa fa-user',
            'url': 'auth/user/'
        }]
    }, {
        'name': '測試',
        'icon': 'fa fa-file',
        'models': [{
            'name': 'Baidu',
            'url': 'http://baidu.com',
            'icon': 'far fa-surprise'
        }, {
            'name': '內網穿透',
            'url': 'https://www.wezoz.com',
            'icon': 'fab fa-github'
        }]
    }, {
        'name': '動態菜單測試' ,
        'icon': 'fa fa-desktop',
        'models': [{
            'name': time.time(),
            'url': 'http://baidu.com',
            'icon': 'far fa-surprise'
        }]
    }]
}

如果SIMPLEUI_CONFIG中存在menus字段，將會覆蓋系統默認菜單。並且menus中輸出的菜單不會受權限控制。

 

默認圖標

simpleui對所有菜單提供了一個默認的file圖標，是爲了統一風格。也許你並不喜歡，你可以選擇關閉默認圖標

SIMPLEUI_DEFAULT_ICON = False

值	說明
True	開啓默認圖標，默認爲True
False	關閉默認圖標

 

自定義圖標

simpleui僅爲系統默認模塊提供了圖標，如果要爲其他模塊指定圖標，可以自定義配置。圖標參考請查閱：圖標說明

優先級： 自定義->系統配圖->默認圖標

注：simpleui 原則上不涉及代碼，所以採用setting方式。後續可考慮擴展Model的 Meta class 進行配置圖標

字段	說明
name	模塊名字，請注意不是model的命名，而是菜單欄上顯示的文本，因爲model是可以重複的，會導致無法區分
icon	圖標
例子：

SIMPLEUI_ICON = {
    '系統管理': 'fab fa-apple',
    '員工管理': 'fas fa-user-tie'
}

https://github.com/newpanjing/simpleui_demo

https://github.com/newpanjing/simpleui

https://github.com/newpanjing/simpleui/blob/master/QUICK.md