一、下载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'
修改后,刷新页面,显示图标已添加:
本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:xadmin2.0(for Django2.0) 基本设置 - Python技术站