文档章节

三、xadmin----内置插件

o
 osc_1ee7cxmx
发布于 2018/08/07 17:07
字数 1130
阅读 14
收藏 0

行业解决方案、产品招募中!想赚钱就来传!>>>

1、Action

  Xadmin 默认启用了批量删除的事件,代码见xadmin-->plugins-->action.py  DeleteSelectedAction

  如果要为list列表添加其他事件,可自定义Action:

  1)自定义一个Action类,继承BasicActiveView

    from xadmin.plugins.actions import BasicActiveView

    class MyAction(BasicActiveView):

      """

        这里有必要三个属性:

          1)action_name="my_action name" # 相当于这个动作的唯一标识,尽量用比较有针对性的名字

          2)description = _(u'Test selected %(verbose_name_plural)s') # 描述,出现在Action菜单中,可以使用 '%(verbose_name_plural)s' 代替Model的名字

          3)model_perm ='change' # 该Action所需要的权限

      """

  2)实现do_action方法

    def do_action(self, queryset):

      # queryset 是包含了已经选择的数据的queryset

      for obj in queryset:

        # 对obj的操作

        ....

        return HttpResponse(...)

  3)将自定义的Action添加到 ActionPlugin 中

    xadmin.plugins.__init__.py中的 PLUGINS =(MyAction,)

     4) 在需要使用插件的modelAdmin中

    actions = ["MyActions",]

 

2、数据过滤 Data filters

   1)xadmin默认已经添加了模糊搜索,范围搜索和日期范围搜索

  使用方法:

    通过在Model对应的Xdamin中添加以下属性:

    1)list_filter属性:

      这个属性可以指定可以过滤的列名,然后系统会自动生成一个搜索器

    2)search_fields:

      这个属性指定可以通过搜索框搜索的数据列的名字,搜索框搜索使用的是模糊查找的方式

    3)free_query_filter:

      默认为True,指定是否允许免费搜索,如果允许,用户可以通过url指定参数来自定义搜索

class postsAdmin(object):
    list_display = ["navi_f", "navi_s", "author", "title",  "add_time", "is_recommend", "is_essence", "is_auth", "is_approval", "is_commit"]  # 指定展示的字段
    inField = "forum"  # 用于分组
    is_execute = True  # 是否启用自定义插件,二级联动查询
    list_filter = ["is_auth","is_recommend", "is_essence","navi_f", "navi_s", "author", "is_approval"]  # 过滤字段
    search_fields = ["title"]  # 搜索字段
    list_editable = ["is_approval"]  # 可编辑字段

    actions = ["linkage_filter",]  # 自定义插件

 

  2)自定义过滤器

    参考 xadmin.filter.py

    自定义过滤器 需要继承 BaseFilter

    并通过xadmin.filter.manage来注册或者通过@manager.register装饰器注册

 

3、图表插件

    在数据列表界面,根据列表数据生成图表,可以指定多个数据列生成多个图表

    在mode OptionClass(xadmin.py)中设定data_chars属性,该属性为dict类型,key是图表的标志名称,value是图表的具体设置属性

    如:

      class ReportCharAdmin(object):

        list_display = ["year","data"]

        list_per_page = 20

        data_charts = {

          "user_count":{"title":u"data charts", "x-field":"year", "y-field":("data",), "order":("year",)}

        }

    参数说明:

      title:图表的显示名称

      x-field:图表的x轴数据列,一般是时间,日期等

      y-field:图表的y轴数据列,该项是一个list,可以同时设置多个值,会在同一个列表中显示多条曲线

      order:排序信息,如果不写则使用数据列表的顺序

  源码参见 xadmin.plugins.chart.ChartsPlugin(BaseAdminPlugin)

       xadmin.plugins.chart.ChartsView(ListAdminView)

4、数据导出

  默认可以导出格式:Excel,CSV, XML 和 Json,如果想要导出Excel,需要安装xlwt

  可以通过在Model OptionClass中设置list_export来指定导出格式,或者设置None禁用导出功能

    class UserAdmin(object):

      list_export = ('xls', "xml", "json")

      可以通过设置list_export_fields来指定导出列

      list_export_fields = ('id', "title", "status", "create_time")

 

5、List界面自动定时刷新

  要启用自动刷新功能,只需要简单在Model OptionClass中设置refresh_times即可

   class UserAdmin(object):

      refresh_times = (3,5) #用户可以选择三秒或者5秒刷新一次

 

6、展示详情

  此插件可以在List列表界面显示相关字段的详细信息,通过Ajax实现

  使用:

    通过在Model OptionClass中设置 show_detail_fields属性来指明需要在哪些字段上显示详情

    class UserAdmin(object):

      show_detail_fields = ["name", "age"]

 

7、即时编辑数据

  此插件使用Ajax立即修改某些字段的值,对于一些经常需要修改的字段,如状态等 非常有用

  此插件可以通过OptionClass的list_editable属性设置,‘list_editable’是一个列表,用来指定可以编辑的字段

  class UserAdmin(object):

    list_editable = ["name", "age"]

 

8、设置readonly只读

  class UserAdmin(object):

    # 因为只是单纯的设置readonly_fields属性的话,会同时限定了普通用户和超级用户,但是很多时候我们并不希望限制超级用户,所有重定义get_readonly_fields函数

    def get_readonly_fields(self):

      if self.user.is_superuser:

        self.readonly_fields = []

      return self.readonly_fields

    readonly_fields = ("username", "age")

  

9、书签

  在Model OptionClass中设置如下属性:

    show_bookmarks = True # 默认值就为True

    list_bookmarks # 用户可以在List列表自行添加书签,也可以预先设置书签,预先设置书签如下:

      list_bookmarks = [{

        "title":"Femal", # 书签的名字

        "query":{"gender":True}, # 过滤参数,是标准的queryset过滤

        "order":("-age"), #排序参数

        "cols":("firstname", "age", "phones"),  # 显示的列

        "search":'Tom', #搜索参数,指定搜索的内容

      },{...}

      ]

 

o
粉丝 0
博文 500
码字总数 0
作品 0
私信 提问
加载中
请先登录后再评论。

暂无文章

【Python成长之路】对不起,今天的所有红包我都要抢走了

哈喽大家好,我是鹏哥。 今天要记录的内容是 —— 用python完成微信抢红包。 ~~~上课铃~~~ 1 写在前面 哈哈,今天的歌曲是过年必备款(主要是我懒得找适应节奏的流行歌)。向来对春晚不感冒的...

鹏哥贼优秀
01/24
0
0
说说TCP的拥塞控制

在某段时间,若对网络中某一资源的需求超过了该资源所能提供的可用部分,网络的性能就要变坏。这种情况就叫拥塞。拥塞控制就是为了防止过多的数据注入到网络中,这样就可以使网络中的路由器或...

Java学习提升
05/29
0
0
高并发下接口幂等性解决方案

点击上方☝ Java编程技术乐园,轻松关注! 及时获取有趣有料的技术文章 作者:抽离的心 https://blog.csdn.net/u011635492/article/details/81058153 一、背景 我们实际系统中有很多操作,是...

阿飞云
02/05
0
0
树莓派4B安装tensorflow2.0

这个GitHub上可以下载到tensorflow2.x:https://github.com/lhelontra/tensorflow-on-arm/releases 我就拿我下载的举例子吧:我下载的是这个版本的:tensorflow-2.0.0-cp37-none-linux_armv...

osc_f9krav3q
18分钟前
0
0
SpringBoot + Mybatis 多模块( module )项目搭建教程

来自:枫本非凡 | 责编:乐乐 链接:cnblogs.com/orzlin/p/9717399.html 粉丝福利,点击领取:教妹子手撸了50个项目实战后,我住院了…… 一、前言 最近公司项目准备开始重构,框架选定为Spr...

倪升武
07/12
0
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部