Useful knowledge of Django - xadmin - 2

以默认的related_link为例(即最后一列)。

源码：xadmin.plugins.relate.RelatedMenuPlugin　　

class RelateMenuPlugin(BaseAdminPlugin):

    use_related_menu = True

    # ...若干删减

    def related_link(self, instance):
        #... 若干删减
        return '<div class="dropdown related_menu pull-right"><a title="%s" class="relate_menu dropdown-toggle" data-toggle="dropdown"><i class="icon fa fa-list"></i></a>%s</div>' % (_('Related Objects'), ul_html)

    related_link.short_description = '&nbsp;'
    related_link.allow_tags = True
    related_link.allow_export = False
    related_link.is_column = False

    def get_list_display(self, list_display):
        if self.use_related_menu and len(self.get_related_list()):
            list_display.append('related_link')
            self.admin_view.related_link = self.related_link
        return list_display

注解：

1. 重写了ListAdminView的get_list_display方法（控制哪些字段加载）。

2. 此处增加的字段是实际数据模型不存在的字段，否则无效。详细看xadmin.util中的lookup_field方法（需要触发字段不存在的异常，进入对应名称的同名方法调用并采用其返回值），源码如下：

   def lookup_field(name, obj, model_admin=None):

    opts = obj._meta
    try:
        f = opts.get_field(name)
    except models.FieldDoesNotExist:
        # For non-field values, the value is either a method, property or
        # returned via a callable.
        if callable(name):
            attr = name
            value = attr(obj)
        elif (model_admin is not None and hasattr(model_admin, name) and
              not name == '__str__' and not name == '__unicode__'):
            attr = getattr(model_admin, name)
            value = attr(obj)
        else:
            attr = getattr(obj, name)
            if callable(attr):
                value = attr()
            else:
                value = attr
        f = None
    else:
        attr = None
        value = getattr(obj, name)
    return f, attr, value
   

3. 字段的渲染逻辑需要自行实现，此处是 related_link方法， 最终返回html代码。

4. 自定义字段的html代码能正常解析，不被和谐，不许要设置方法的allow_tags属性。

   related_link.allow_tags = True

5. 栏位的名称，通过方法的short_description控制。

   related_link.short_description = ‘ ’

6. (待分析)很神奇的，该插件没有init_request方法，却能通过 use_related_menu属性控制插件是否加载。

新增字段默认返回html代码，要想其不被和谐， 方法的allow_tags属性需要为True，如下

related_link.allow_tags = True

　　—-后记————-

后来分析了下源码：xadmin/views/base.py (BaseAdminView类的init_plugin方法: 276行)

def init_plugin(self, *args, **kwargs):
        plugins = []
        for p in self.base_plugins:
            p.request = self.request
            p.user = self.user
            p.args = self.args
            p.kwargs = self.kwargs
            import pdb
            pdb.set_trace()
            result = p.init_request(*args, **kwargs)
            if result is not False:
                plugins.append(p)
        self.plugins = plugins

默认情况下， 父类（BaseAdminPlugin）的init_request 不返回任何值，即为None, None is not False， 因此，没有init_request方法的自定义插件默认加载。之所以貌似能够用use_related_menu属性来控制“加载”与否，纯粹因为实际逻辑是：

　　1. 默认加载控件

1. 如果use_related_menu为True，则渲染相关列菜单。否则啥都不做。

　　代码如下：xadmin/plugins/relate.py (79~83)

def get_list_display(self, list_display):
        if self.use_related_menu and len(self.get_related_list()):
            list_display.append('related_link')
            self.admin_view.related_link = self.related_link
        return list_display

最终效果，就是在列表后追加了一列，如下