一、安装

  • 使用安装工具安装:
pip install git+git://github.com/sshwsfc/xadmin.git@django2
  • 下载源码:
git clone https://github.com/sshwsfc/xadmin.git

或者将文件夹中的xadmin文件夹,放到项目目录中,然后在setting.py中添加应用路径并注册app * 修改路由urls.py:

from django.urls import path
import xadmin

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

models注册

  • 在应用文件目录下新建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)。

二、基本设置

  • 整个界面主题设置 在其中一个应用的adminx.py中添加:
from xadmin import views

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

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

刷新后端管理页面后,右上角增加了主题标签,点击主题标签,可以选择喜欢的主题样式。

  • 左上角名称(Django Xadmin)、底部(我的公司)修改、左侧菜单栏折叠
class GlobalSettings:
    """
    后台修改
    """
    site_title = '修改后的名称'
    site_footer = '修改后的底部'
    menu_style = 'accordion'  # 开启分组折叠

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

刷新后台管理页面可以发现页面左上角、底部均已修改,且左侧菜单栏可折叠

  • 左侧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
  • 左侧每个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/,替换之前的文件夹