如何更改Django Wagtail的管理logo

Question

我正在做一个小项目，想试试wagtail这个工具。现在我在想，怎么才能更改wagtail管理界面左上角的侧边栏logo（下面图片中的那个）呢？

我可以直接修改/static/wagtailadmin/images/wagtail-logo.svg这个文件，但这样做是不对的；）。

Answer 1

这个logo是在这里定义的：

https://github.com/torchbox/wagtail/blob/master/wagtail/wagtailadmin/templates/wagtailadmin/base.html#L7

如果你想要替换它，你需要一个包含 templates/wagtailadmin/base.html 的应用，并且这个应用要在 INSTALLED_APPS 中排在wagtail之前。

祝你好运！

Answer 2

Wagtail已经在官方文档中提供了解决方案，使用的是django-overextends这个工具：

如果你想替换默认的logo，可以创建一个模板文件，路径是your_app/templates/wagtailadmin/base.html，在这个文件中覆盖branding_logo这个部分，具体做法如下：

{% overextends "wagtailadmin/base.html" %}

{% block branding_logo %}
    <img src="{{ STATIC_URL }}images/custom-logo.svg" alt="Custom Project" width="80" />
{% endblock %}

想了解更多细节，可以查看Wagtail的自定义品牌。

---

(2020年12月更新)

注意：在最新版本的Wagtail中，已经不再需要使用django-overextends。现在它直接使用Django模板的默认extends标签。想了解更多信息，可以查看文档。