定制过滤器

过滤器允许你将函数应用于变量。此函数可能需要 0 或 1 个参数。这是语法：

{{ variable|filter_name }} 
{{ variable|filter_name:argument }}

过滤器可以链接，因此这是完全有效的：

{{ variable|filter_name:argument|another_filter }}

如果转换为 python，上面的行会给出这样的结果：

print(another_filter(filter_name(variable, argument)))

在这个例子中，我们将编写一个适用于 Model（实例或类）或 QuerySet 的自定义过滤器 verbose_name。如果参数设置为 True，它将返回模型的详细名称或其详细名称复数。

@register.filter
def verbose_name(model, plural=False):
    """Return the verbose name of a model.
    `model` can be either:
      - a Model class
      - a Model instance
      - a QuerySet
      - any object refering to a model through a `model` attribute.

    Usage:
      - Get the verbose name of an object
          {{ object|verbose_name }}
      - Get the plural verbose name of an object from a QuerySet
          {{ objects_list|verbose_name:True }}
    """
    if not hasattr(model, '_meta'):
        # handle the case of a QuerySet (among others)
        model = model.model
    opts = model._meta
    if plural:
        return opts.verbose_name_plural
    else:
        return opts.verbose_name