Wagtail 邮件通知头图更新指南

问题背景

Wagtail CMS 在发送邮件通知时，邮件头部会显示一个包含 Wagtail 标志的背景图片。近期有用户反馈，当前使用的邮件头图仍然显示旧版 Wagtail 标志和绿色/蓝绿色背景，与新版 Wagtail 的紫色主题风格不符。

技术分析

邮件通知功能是 Wagtail 管理后台的重要组成部分，用于向用户发送各种系统通知，如内容审核、工作流状态变更等。邮件模板的基础结构位于 wagtail/admin/templates/wagtailadmin/notifications/base.html 文件中。

邮件头图的具体实现是通过静态文件 email-header.jpg 来呈现的，该文件位于 wagtail/admin/static_src/wagtailadmin/images/ 目录下。当前使用的图片仍然是旧版设计，需要更新为符合新版 Wagtail 品牌视觉规范的图片。

解决方案

要解决这个问题，需要进行以下步骤：

1. 设计新版邮件头图：根据 Wagtail 最新的品牌规范，创建一个新的邮件头图，包含新版 Wagtail 标志，并使用深紫色作为背景色。

2. 替换静态资源：将新设计的图片替换现有的 email-header.jpg 文件，保持相同的文件名和路径。

3. 测试验证：在本地开发环境中测试邮件通知功能，确保新图片正确显示，并且在不同邮件客户端中都能正常加载。

实现细节

对于开发者来说，更新邮件头图是一个相对简单的任务：

1. 首先需要准备符合要求的新图片，建议尺寸与原有图片保持一致（约 600px 宽度）。

2. 将新图片放置在正确的位置，覆盖原有文件。

3. 由于这是静态资源变更，可能需要重新收集静态文件才能使更改生效。

注意事项

• 图片格式应保持为 JPG 以保证兼容性
• 图片文件大小应尽可能优化，避免影响邮件加载速度
• 需要考虑不同邮件客户端对图片显示的支持情况
• 建议在深色和浅色主题下都测试图片的显示效果

这个改进虽然看似简单，但对于提升 Wagtail 用户体验和品牌一致性有着重要意义，能够让用户在使用邮件通知功能时感受到更加统一和专业的产品形象。