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'

修改后，刷新页面，显示图标已添加：