二、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

  



原文地址:https://www.cnblogs.com/fiona-zhong/p/9438664.html