Djanog admin 有用的设置

1、编辑界面设置

首先多ManyToMany多对多字段设置。可以用filter_horizontal或filter_vertical:

1. # Many to many 字段
2. filter_horizontal=('tags',)

效果如下图:

这样对多对多字段操作更方便。

另外,可以用fields或exclude控制显示或者排除的字段,二选一即可。

例如,我想只显示标题、作者、分类标签、内容。不想显示是否推荐字段,可以如下两种设置方式:

fields =  ('caption', 'author', 'tags', 'content')

或者

exclude = ('recommend',) #排除该字段

设置之后,你会发现这些字段都是一个字段占一行。若想两个字段放在同一行可以如下设置:

fields =  (('caption', 'author'), 'tags', 'content')

2、编辑字段集合

不过,我不怎么用fields和exclude。用得比较多的是fieldsets。该设置可以对字段分块,看起来比较整洁。如下设置:

fieldsets = (
    ("base info", {'fields': ['caption', 'author', 'tags']}),
    ("Content", {'fields':['content', 'recommend']})
)

效果如下:

3、一对多关联

还有一种比较特殊的情况,父子表的情况。编辑父表之后,再打开子表编辑,而且子表只能一条一条编辑,比较麻烦。

这种情况,我们也是可以处理的,将其放在同一个编辑界面中。

例如,有两个模型,一个是订单主表(BillMain),记录主要信息;一个是订单明细(BillSub),记录购买商品的品种和数量等。

admin.py如下:

#coding:utf-8
from django.contrib import admin
from bill.models import BillMain, BillSub
 
@admin.register(BillMain)
class BillMainAdmin(admin.ModelAdmin):
    inlines = [BillSubInline,]    #Inline把BillSubInline关联进来
    list_display = ('bill_num', 'customer',)
    
class BillSubInline(admin.TabularInline):
    model = BillSub
    extra = 5 #默认显示条目的数量

这样就可以快速方便处理数据。

4.设置只读字段

在使用admin的时候,ModelAdmin默认对于model的操作只有增加,修改和删除,但是总是有些字段是不希望用户来编辑的。而 readonly_fields 设置之后不管是admin还是其他用户都会变成只读,而我们通常只是想限制普通用户。 这时我们就可以通过重写 get_readonly_fields 方法来实现对特定用户的只读显示。

代码:

class MachineInfoAdmin(admin.ModelAdmin):
 
    def get_readonly_fields(self, request, obj=None):
        """  重新定义此函数,限制普通用户所能修改的字段  """
        if request.user.is_superuser:
            self.readonly_fields = []
        return self.readonly_fields
     
    readonly_fields = ('machine_ip', 'status', 'user', 'machine_model', 'cache',
                       'cpu', 'hard_disk', 'machine_os', 'idc', 'machine_group')

效果:

5、数据保存时进行一些额外的操作(通过重写ModelAdmin的save_model实现)

代码:

def save_model(self, request, obj, form, change):
    """  重新定义此函数,提交时自动添加申请人和备案号  """
 
    def make_paper_num():
        """ 生成随机备案号 """
        import datetime
        import random
        CurrentTime = datetime.datetime.now().strftime("%Y%m%d%H%M%S")  # 生成当前时间
        RandomNum = random.randint(0, 100)  # 生成的随机整数n,其中0<=n<=100
        UniqueNum = str(CurrentTime) + str(RandomNum)
        return UniqueNum
 
    obj.proposer = request.user
    obj.paper_num = make_paper_num()
    super(DataPaperStoreAdmin, self).save_model(request, obj, form, change)

 这样,在添加数据时,会自动保存申请人和备案号。

我们也可以在修改数据时获取保存前的数据:

通过change参数,可以判断是修改还是新增,同时做相应的操作。上述代码就是在替换磁盘的时候修改状态,并写入日志。

代码:

def save_model(self, request, obj, form, change):
    if change:  # 更改的时候
        machine_code = self.model.objects.get(pk=obj.pk).machine
        disk_id = self.model.objects.get(pk=obj.pk).disk_id
        disk_code = self.model.objects.get(pk=obj.pk).disk
        machine.Device.objects.filter(pk=disk_id).update(device_status='待报废')
        data = {'server_code': machine_code,
                'device_type': '硬盘',
                'original_code': disk_code,
                'way': '变更',
                'current_code': obj.disk}
        common.DeLog.objects.create(**data)  # 创建日志
    else:  # 新增的时候
        data = {'server_code': obj.machine,
                'device_type': '硬盘',
                'original_code': '',
                'way': '新增',
                'current_code': obj.disk}
        common.DeLog.objects.create(**data)  # 创建日志
    super(MachineExDiskAdmin, self).save_model(request, obj, form, change)

同样的,还有delete_model:

def delete_model(self, request, obj):
    machine.Device.objects.filt
    er(pk=obj.pk).update(device_status='待报废')
    data = {'server_code': obj.machine,
            'device_type': '硬盘',
            'original_code': obj.disk,
            'way': '删除',
            'current_code': '',
            'user_name': request.user}
    common.DeLog.objects.create(**data)  # 创建日志
    super(MachineExDiskAdmin, self).delete_model(request, obj)

6. 修改模版 chang_form.html 让普通用户 无法看到 “历史” 按钮

默认 普通用户下 是存在 “历史” 按钮的:

此时 chang_form.html 的代码为:

to

7.对单条数据 显示样式的修改

每条数据都有 个确认标识(上图红框中),如果已经确认,用户再点击进入查看信息的时候全部只读显示,即不能在做修改,如果没确认在可以修改。如下:

  • 已确认

  • 未确认

  • 实现方法:

change_view 方法 和 get_readonly_fields 方法 配合,代码:
def get_readonly_fields(self, request, obj=None):
    """  重新定义此函数,限制普通用户所能修改的字段  """
    if request.user.is_superuser:
        self.readonly_fields = ['commit_date', 'paper_num']
    elif hasattr(obj, 'is_sure'):
        if obj.is_sure:
            self.readonly_fields = ('project_name', 'to_mail', 'data_selected', 'frequency', 'start_date',
                                    'end_date')
    else:
        self.readonly_fields = ('paper_num', 'is_sure', 'proposer', 'sql', 'commit_date')
 
    return self.readonly_fields
 
def change_view(self, request, object_id, form_url='', extra_context=None):
    change_obj = DataPaperStore.objects.filter(pk=object_id)
    self.get_readonly_fields(request, obj=change_obj)
    return super(DataPaperStoreAdmin, self).change_view(request, object_id, form_url, extra_context=extra_context)

change_view方法,允许您在渲染之前轻松自定义响应数据。(凡是对单条数据操作的定制,都可以通过这个方法配合实现)

8.修改app的显示名称

Django在Admin后台默认显示的应用的名称为创建app时的名称。

我们如何修改这个app的名称达到定制的要求呢,其实Django已经在文档里进行了说明。

从Django1.7以后不再使用app_label,修改app相关需要使用AppConfig。我们只需要在应用的__init__.py里面进行修改即可:

from django.apps import AppConfig
import os
 
 
default_app_config = 'hys_operation.PrimaryBlogConfig'
 
VERBOSE_APP_NAME = u"1-本地服务器资源"
 
 
def get_current_app_name(_file):
    return os.path.split(os.path.dirname(_file))[-1]
 
 
class PrimaryBlogConfig(AppConfig):
    name = get_current_app_name(__file__)
    verbose_name = VERBOSE_APP_NAME

9.自定义列表字段

在DataPaperStore模型中有 end_date 字段,如果当前时间大于end_date 是我们想显示一个“已过期”,但 admin 列表显示不能直接用该字段,也显示不出来。此时可以通过自定义列表字段显示。如下设置admin:

def expired(self, ps):
    """自定义列表字段, 根据数据单截止日期和当前日期判断是否过期,并对数据库进行更新"""
    import datetime
    from django.utils.html import format_html
    end_date = ps.end_date
    if end_date >= datetime.date.today():
        ret = '未过期'
        color_code = 'green'
    else:
        ret = '已过期'
        color_code = 'red'
    DataPaperStore.objects.filter(pk=ps.pk).update(is_expired=ret)
    return format_html(
                '<span style="color: {};">{}</span>',
                color_code,
                ret,
            )
expired.short_description = '是否已过期'

通过自定义列表字段,获取相关数据再列表中显示,效果如下:

10.actions

代码如下:

def copy_one(self, request, queryset):
    # 定义actions函数
    # 判断用户选择了几条数据,如果是一条以上,则报错
    if queryset.count() == 1:
        old_data = queryset.values()[0]
        old_data.pop('id')
        # 将原数据复制并去掉id字段后,插入数据库,以实现复制数据功能,返回值即新数据的id(这是在model里__str__中定义的)
        r_pk = Record.objects.create(**old_data)
        # 修改数据后重定向url到新加数据页面
        return HttpResponseRedirect('{}{}/change'.format(request.path, r_pk))
    else:
        self.message_user(request, "只能选取一条数据!")
copy_one.short_description = "复制所选数据"
  • 为每个对象自定义 action

有时候你需要在单个对象上执行特定的 action。‘actions’工具当然可以完成这个任务,不过过程会显得很麻烦:点击对象、选择 action、再点击一个按钮……肯定有更便捷的方式,对吧?

让我们想办法只点击一次就全部搞定。

我们可以先自定义一个字段(上面提到过),让这个字段可以每次点击的时候帮我们做一些事情,比如:复制本条数据

自定义字段这个功能我们没问题,但是如何让它帮我们复制数据呢?

我们知道,django里所有的业务逻辑都是通过访问url从而指向对应的views来实现的,就是说我们想要实现复制数据,就必须有对应的url和views。

而admin为我们提供了对应的方法:get_urls

这个方法可以让我们临时添加一个url,并且可以防止手动输入此url实现操作。

代码:

class DailyReportDbaAdmin(admin.ModelAdmin):
 
    def copy_current_data(self, obj):
        """自定义一个a标签,跳转到实现复制数据功能的url"""
        dest = '{}copy/'.format(obj.pk)
        title = '复制'
        return '<a href="{}">{}</a>'.format(dest, title)
    copy_current_data.short_description = '复制'
    copy_current_data.allow_tags = True
 
    def get_urls(self):
        """添加一个url,指向实现复制功能的函数copy_one"""
        from django.conf.urls import url
        urls = [
            url('^(?P<pk>\d+)copy/?$',
                self.admin_site.admin_view(self.copy_one),
                name='copy_data'),
        ]
        return urls + super(DailyReportDbaAdmin, self).get_urls()
 
    def copy_one(self, request, *args, **kwargs):
        """函数实现复制本条数据,并跳转到新复制的数据的修改页面"""
        obj = get_object_or_404(DailyReportDba, pk=kwargs['pk'])
        old_data = {'create_date': obj.create_date,
                    'db_server': obj.db_server,
                    'db_user': obj.db_user,
                    'request_type': obj.request_type,
                    'request': obj.request,
                    'scripts': obj.scripts,
                    'de_proposer': obj.de_proposer,
                    'fde_proposer': obj.fde_proposer,
                    'operator': obj.operator,
                    'is_complete': obj.is_complete,
                    'remark': obj.remark,
                    }
 
        r_pk = DailyReportDba.objects.create(**old_data)
        co_path = request.path.split('/')
        co_path[-2] = "{}/change".format(r_pk)
        new_path = '/'.join(co_path)
        return redirect(new_path)
 
    # actions = ['copy_one']
    fieldsets = [
        ('时间和服务器*', {'fields': [('create_date', 'db_server', 'db_user')]}),
        ('需求和脚本*', {'fields': ['request_type', 'request', 'scripts']}),
        ('申请人和操作人*', {'fields': [('de_proposer', 'fde_proposer', 'operator', 'is_complete'), 'remark']})
    ]
    list_display = ('create_date', 'db_server', 'db_user', 'request', 'request_type',
                    'de_proposer', 'fde_proposer', 'operator', 'is_complete', 'copy_current_data', )

11. formfield_for_foreignkey

ModelAdmin.``formfield_for_foreignkey(db_field, request, **kwargs)

这个方法可以过滤下拉列表的数据,使之显示过滤后的数据

下面的代码表示,car字段会根据当前登录的用户显示此用户所拥有的车

class MyModelAdmin(admin.ModelAdmin):
    def formfield_for_foreignkey(self, db_field, request, **kwargs):
        if db_field.name == "car":
            kwargs["queryset"] = Car.objects.filter(owner=request.user)
        return super(MyModelAdmin, self).formfield_for_foreignkey(db_field, request, **kwargs)

12.Admin中使用二级联动

默认的django会自动根据我们定义的模型生成form给admin使用,使用到这个form的地方分别是change和add的时候。 最终生成的结果就是可以选择所有的省,也可以选择所有的市,这并不合理,正确的应该是在选择某个省的时候在市的下拉列表里只有该省的城市。 而,django原生并不能做到这么智能。下面介绍一下实现方法:

  • (1) admin.py

    class RecordAdmin(admin.ModelAdmin):
        change_form_template = 'admin/extras/record_change_form.html'
        ...

    使用change_form_template 重置 change_form所使用得模版

  • (2)在上一步配置的路径下新建html文件 record_change_form.html

    <div data-gb-custom-block data-tag="extends" data-0='admin/change_form.html'></div>
    <div data-gb-custom-block data-tag="load" data-0='18' data-1='8'></div>
     
    <div data-gb-custom-block data-tag="block"></div>{{ block.super }}
    <script type="text/javascript" src="<div data-gb-custom-block data-tag="url" data-0='admin:jsi18n'>"></script>
        <script>
            django.jQuery(function() {
                var select = django.jQuery("#id_machine_room_id");
                console.log(select);
                select.change(function(){
    {#                console.log("value change"+django.jQuery(this).val());#}
                    var url = "/report/sub_servers/"+django.jQuery(this).val();//能够正确的访问到view的url
    {#                console.log(url);#}
                    django.jQuery.get(
                        url,
                        function(data){
                            var target = django.jQuery("#id_server_ip_id");
                            target.empty();//先要清空一下
                            data.forEach(function(e){
                                // 将从view得到的id和db_user名称赋值给db_server的select
                                console.log(e,e.id,e.name);
                                target.append("<option value='"+e.id+"'>"+e.name+"<option>");
                                target.eq(0).attr('selected', 'true');
                            });
                    })
                });
     
            });
        </script>
    {#{{ media }}#}
    </div>

     注意:1.继承change_form.html 2.设计好url

    • (3)在urls.py中添加一条对应的url

      # urls.py
      from django.conf.urls import url
      from hys_operation import views
       
      urlpatterns = [
          # url(r'^sub_users/(?P<obj_id>\d+)', views.get_sub_users),
          url(r'^sub_servers/(?P<obj_id>\d+)', views.get_sub_servers),
      ]
      
      # views.py
      def get_sub_servers(request, obj_id):
          # 查找此机房id下的ip
          servers = MachineInfo.objects.filter(idc=obj_id)
          result = []
          for i in servers:
              # 对应的id和ip组成一个字典
              result.append({'id': i.id, 'name': i.machine_ip})
          # 返回json数据
          return HttpResponse(json.dumps(result), content_type="application/json")

        返回值就是过滤后的值。

      参考:https://www.cnblogs.com/wumingxiaoyao/p/6928297.html

Last updated