Django Admin实现动态添加按钮（带筛选参数传递）

要实现Django Admin订单列表页的动态添加按钮，核心是在列表页视图中捕获筛选参数，动态构造添加链接，再通过自定义模板替换默认的添加按钮链接。

1. 模型结构参考（适配smart_selects） #

假设你的models.py结构如下：

# models.py
from django.db import models
from smart_selects.db_fields import ChainedForeignKey

class Customer(models.Model):
    name = models.CharField(max_length=100)
    # 其他业务字段

    def __str__(self):
        return self.name

class Order(models.Model):
    order_customer = models.ForeignKey(Customer, on_delete=models.CASCADE)
    # 若使用smart_selects关联字段，替换为：
    # order_customer = ChainedForeignKey(Customer, chained_field="...", chained_model_field="...", on_delete=models.CASCADE)
    order_date = models.DateTimeField(auto_now_add=True)
    # 其他业务字段

    def __str__(self):
        return f"订单 {self.id} - {self.order_customer.name}"

2. 修改OrderAdmin类，动态生成添加链接 #

在admin.py中重写changelist_view方法，捕获筛选参数并构造对应URL：

# admin.py
from django.contrib import admin
from django.urls import reverse
from .models import Customer, Order

@admin.register(Customer)
class CustomerAdmin(admin.ModelAdmin):
    list_display = ("name",)
    # 其他自定义配置

@admin.register(Order)
class OrderAdmin(admin.ModelAdmin):
    list_display = ("order_customer", "order_date")
    list_filter = ("order_customer",)  # 开启客户筛选，自动生成order_customer__id参数

    def changelist_view(self, request, extra_context=None):
        extra_context = extra_context or {}
        # 从URL中提取客户筛选参数
        customer_id = request.GET.get("order_customer__id")
        if customer_id:
            # 构造带客户参数的添加链接
            add_url = f"{reverse('admin:catalog_order_add')}?order_customer={customer_id}"
        else:
            # 使用默认添加链接
            add_url = reverse("admin:catalog_order_add")
        # 将动态链接传入模板上下文
        extra_context["add_url"] = add_url
        return super().changelist_view(request, extra_context=extra_context)

3. 自定义订单列表模板，替换添加按钮 #

在你的应用目录下创建模板文件templates/admin/catalog/order/change_list.html（路径需匹配应用名和模型名）：

{% extends "admin/change_list.html" %}

{% block object-tools-items %}
    {% if has_add_permission %}
        <li>
            <a href="{{ add_url }}" class="addlink">
                {% blocktranslate with cl.opts.verbose_name as name %}添加{{ name }}{% endblocktranslate %}
            </a>
        </li>
    {% endif %}
    {{ block.super }}
{% endblock %}

4. 配置模板加载优先级 #

确保你的应用在settings.py的INSTALLED_APPS中排在django.contrib.admin之前，让自定义模板优先加载：

# settings.py
INSTALLED_APPS = [
    "your_app_name",  # 你的应用放在最前面
    "django.contrib.admin",
    # 其他应用
]

效果说明 #

• 当通过客户筛选进入订单列表页时，URL会携带order_customer__id=X参数，此时添加按钮会跳转到预填充客户字段的新增页面（如/admin/catalog/order/add/?order_customer=3）。
• 无筛选参数时，添加按钮使用默认链接，正常打开空白新增表单。

内容的提问来源于stack exchange，提问作者Sokil