二、xadmin----简单使用
1、中文设置:
settings.py中直接配置:
LANGUAGE_CODE = "zh-hans"
TIME_ZONG = "Asia/Shanghai"
2、菜单折叠:
在users/xadmin.py中添加GLOBALSETTINGS
from xadmin import views
class GlobalSettings(object):
site_title = "头部名称"
site_footer = "脚部名称"
menu_style = "accordion" # 菜单折叠
apps_icons = {"appname":"icon"} #设置app的显示图标
xadmin.site.register(views.CommAdminView, GlobalSettings)
3、页面布局定制:
class UserAdmin(object):
def get_form_layout(self):
if self.org_obj:
self.form_layout = (
Main(
Filedset('',
'username', 'password', css_class="unsort no_title"
),
Fieldset(_('Personal info'),
Row('firstname', 'lastname'), email
),
Fieldset(
_('permissions'),
'grounps', 'userpermissions'
),
Fieldset(
_('important dates'),
'last_login', 'date_joined'
),
),
Side(
Fieldset(
_('status'),
'is_active', 'is_stuff', "is_superuser"
)
)
)
return self.super(UserAdmin, self).get_form_layout()
4、更改图标
更改app图标 通过app_icons来设置
class GlobalSetting(object): site_title = "上海诺行信息技术有限公司" site_footer = "COPYRIGHT © 2010 - 2018 ALL RIGHTS RESERVED" menu_style ="accordion" apps_icons = {"home":"fa fa-home", "products":"", "companyintroduction":"", "certifications":"fa fa-certificate", "contactus":"fa fa-phone", "forum":"","logisticinformation":"", "sourcedownload":"fa fa-download","trade":"fa fa-shopping-cart","users":"fa fa-user", "wechatuser":"fa fa-user"}
更改model图标,通过model_icon来设置
class relativeFilesAdmin(object):
model = relativeFiles
extra = 0
model_icon = "fa fa-download"
inField = "company"
可选的图标可查看 font awesome,可自行下载最新的图标包来替换现有的
font awesome : http://fontawesome.dashgame.com/
5、显示排序
通过ordering配置
class ProductListAdmin(object):
...
ordering = ["sales_num",]
6、只读字段:
readonly_fields = ["",""],如果想要自定义只读字段显示方式,可以重写get_readonly_fields():函数
7、不包含及不在list列表界面显示
exclude = ["",""]
注意,exclude和readonly_fields是冲突的,配置了readonly_fields,则exclude是无效的
8、inlineAdmin嵌套编辑
假设A是B的外键
class AAdmin(object):
model = A
extra = 1
class BAdmin(object):
list_display = ["",""]
inlines = [A,]
这样在编辑B的时候,就可以同时对A进行增删改查
但是要注意一个问题,这里的A,里面一定要写明model =A,不能像B写list_display = [""],否则会报错 'NoneType' object has no attribute '_meta'
extra:表示的是在编辑B的时候,展示几个A的可编辑框。不设置的话默认是3个,设置为0的话,则表示A编辑框是收起的。
9、两个管理器管理一张表
对于A 继承B 的情况,我们可以对A和B使用同一张表来管理,而不用分别为A和B建立表
10、Xadmin中的View对应含义:
1)views-->base.py:
BaseAdminView:所有的AdminView的基类,继承自BaseAdminObject和Djano.views.generic.View,注册在该View上的插件 可以影响所有的AdminView,对应的模板是 base.html
CommAdminView:继承于BaseAdminView,此类是用户登录后显示用到的View,也是登录后所有View的基类。该类的主要作用是创建Xadmin的通用元素,如系统菜单,用户信息等全局设置。
所有 关于菜单,列表界面显示的样式等 都可以在此类中完成设置,如上面2中设置全局的属性用到的就是此基类。
此基类对应的模板为:base_site.html, include/sitemenu_default.html
ModelAdminView:基于model的AdminView的基础类,注册的插件可以影响所有基于model的view
如我们在model里面设置的verbose_name,注册model时设置的model_icon等 通过在此类中展示
2)views-->list.py
ListAdminView:model列表页面view,它实现了数据排序和分页功能
包含的可选择设置属性:
list_display = [] | () 可以是列表或者元组,设置要在list界面展示的字段
list_display_link = () 设置作为链接去展示详情的字段
search_fields = () 设置搜索字段
ordering = () 设置排序字段
3)views-->edit.py
ModelFormAdminView:model编辑页面View
此类是一个基类,CreateAdminView和UpdateAdminView继承自此类
options 属性:
readonly_fields = () #定义只读字段
exclude = ["",""] #定义的字段不会显示在编辑界面,但是和readonly_fields使用冲突,定义了readonly_fields的字段再定义exclude是无效的
style_fields = () #定义该字段样式 如 style_fields= ("content":"ueditor"),以富文本方式展示
save_as = True/False #是否显示另存为按钮
form_layout = () #可以自定义detail界面的样式:
def get_form_layout(self):
self.form_layout = (
Main(
Fieldset("title",
Row("name", "index"),
"link"
),
Fieldset("title",
Row("name", "index"),
"link"
),
),
Side(...)
)
return super(modelAdmin, self).get_form_layout()
relfield_style = "fk-ajax" # 对于下拉框采用ajax异步搜索加载的方式呈现
list_editable = ["",""] #直接以可编辑的方式展示,无需点开详情界面即可编辑
CreateAdminView(ModelFormAdminView): model创建页面View
UpdateAdminView(ModleFormAdminView):model修改页面View
4)views--->delete.py
DeleteAdminView(ModelFormAdminView):mode删除页面View
5)views---->detail.py
DetailAdminView(ModelFormAdminView):model详情页面View