一、下载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):

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

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

三、基本设置

1.整个界面主题设置

在其中一个应用的adminx.py中添加:

from xadmin import views

class BaseSetting:     
    enable_themes = True  # 开启主题功能
    use_bootswatch = True

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

刷新后端管理页面后,右上角变为(增加了主题标签):

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

点击主题标签,可以选择喜欢的主题样式。

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'

刷新页面,显示中文:

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

补充,如果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图标设置

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

左侧菜单栏中,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'

修改后,刷新页面,显示图标已添加:

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