xadmin2.0(for Django2.0) 基本設置

一、下載xadmin

1.使用安裝工具安裝：

pip install git+git://github.com/sshwsfc/xadmin.git@django2

2.下載源碼：

git clone https://github.com/sshwsfc/xadmin.git
# 或者將文件夾中的xadmin文件夾，放到項目目錄中，然后在setting.py中添加應用路徑並注冊app

3.修改路由urls.py：

from django.contrib import admin
from django.urls import path
import xadmin

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

二、models注冊

1.在應用文件目錄下新建adminx.py文件

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
__author__ = "問道編程"
__date__ = "5/29/18 10:41"

import xadmin

from .models import EmailVerification

class EmailVerificationAdmin:    # Python2 需要繼承object類
    """郵箱驗證后台管理"""
    list_display = ['email', 'code', 'send_type', 'send_time', 'is_delete']
    list_filter = ['email', 'code', 'send_type']
    search_fields = ['email', 'code', 'send_type', 'send_time', 'is_delete']
    fields = ['send_type', 'email', 'code', 'is_delete']

xadmin.site.register(EmailVerification, EmailVerificationAdmin)

需要注意的是：xadmin默認注冊user類（可在xadmin/adminx.py中查看），項目創建超級用戶，登錄127.0.0.1:8000/admin（或者其他IP/admin）：

三、基本設置

1.整個界面主題設置

在其中一個應用的adminx.py中添加：

from xadmin import views

class BaseSetting:     
    enable_themes = True  # 開啟主題功能
    use_bootswatch = True

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

刷新后端管理頁面后，右上角變為（增加了主題標簽）：

點擊主題標簽，可以選擇喜歡的主題樣式。

2.左上角名稱(Django Xadmin)、底部(我的公司)修改、左側菜單欄折疊

class GlobalSettings:
    """
    后台修改
    """
    site_title = '修改后的名稱'
    site_footer = '修改后的底部'
    menu_style = 'accordion'  # 開啟分組折疊

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

刷新后台管理頁面可以發現頁面左上角、底部均已修改，且左側菜單欄可折疊

3.左側apps中文顯示

首先在應用目錄下，修改apps.py文件為：

# _*_ coding:utf-8 _*_
from django.apps import AppConfig


class CoursesConfig(AppConfig):
    name = 'courses'
    verbose_name = '課程管理'

讓后修改__init__.py文件為：

default_app_config = 'courses.apps.CoursesConfig'

刷新頁面，顯示中文：

補充，如果models類顯示英文，需要在models.py中類添加：

    class Meta:
        verbose_name = '郵箱驗證信息'
        verbose_name_plural = verbose_name

    def __str__(self):    # Python3 使用
        return self.email

    def __unicode(self):   # Python2 使用
        return self.email

4.左側每個models圖標設置

左側菜單欄中，xadmin自動注冊的models在左側有小圖標，那么我們自己注冊的models小圖標如何修改呢？

首先找到xadmin存放圖標icon的文件:

　　xadmin/static/vendor/font-awesome/css/font-awesome.css文件設定圖標樣式

　　xadmin/static/vendor/font-awesome/fonts文件夾存放圖標的其他設置

打開font-awesome.css可以看到文件版本（一般默認都是比較早的版本）

然后登錄http://www.fontawesome.com.cn/網站下載最新版，解壓后，將css和fonts兩個文件夾復制到xadmin/static/vendor/font-awesome/，替換之前的文件夾

登錄http://www.fontawesome.com.cn/faicons/找到自己喜歡的圖標，點擊后，復制class='' ''里面的代碼，在adminx.py文件中在需要添加圖標的類里，添加代碼如：

model_icon = 'fa fa-comments'

修改后，刷新頁面，顯示圖標已添加：