Wagtail CMS前端文档下载链接实现：是否有特定模板标签？

嘿，这个问题我太熟了！在Wagtail CMS里实现上传文档的前端下载功能其实很清晰，而且确实有专门的模板标签可用，我来给你详细说说：

首先你得在对应的Page模型里，用DocumentChooserPanel把文档字段加进去，这样才能在后台上传/关联文档。示例代码如下：

from django.db import models
from wagtail.models import Page
from wagtail.documents.edit_handlers import DocumentChooserPanel

class DownloadPage(Page):
    # 关联Wagtail的文档模型
    attached_document = models.ForeignKey(
        'wagtaildocs.Document',
        null=True,
        blank=True,
        on_delete=models.SET_NULL,
        related_name='+'
    )

    # 在后台编辑面板里添加文档选择器
    content_panels = Page.content_panels + [
        DocumentChooserPanel('attached_document'),
    ]

方式一：直接调用文档的URL属性 #

这是最直接的方式，只要在模板里拿到文档对象，就能用它的url属性生成下载链接，配合HTML5的download属性触发下载行为：

{% if page.attached_document %}
    <a href="{{ page.attached_document.url }}" download>点击下载文档</a>
{% endif %}

如果想指定下载后的文件名，还可以给download属性传值，比如download="我的自定义文档.pdf"。

方式二：使用Wagtail内置的document_url模板标签 #

Wagtail专门提供了{% document_url %}标签来生成文档的访问URL，这是更符合Wagtail最佳实践的方式——万一后续Wagtail的文档URL结构调整，你的代码不用跟着改。

步骤很简单：

1. 先在模板顶部加载文档标签库：

{% load wagtaildocs_tags %}

2. 然后用标签生成下载链接：

{% if page.attached_document %}
    <a href="{% document_url page.attached_document %}" download>下载{{ page.attached_document.title }}</a>
{% endif %}

这里我顺便把文档的标题也加上了，用户能更清楚自己下载的是什么。

• 你可以在模板里显示文档的大小、上传时间等信息，比如{{ page.attached_document.file.size|filesizeformat }}可以把文件大小转换成易读的格式（比如1.2MB）。
• 如果需要限制文档的访问权限（比如只让登录用户下载），可以结合Wagtail的权限系统，或者在视图层做校验，比如判断用户是否登录后再渲染下载链接。

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