咨询Umbraco logo上传代码所在文件及自定义实现方法

嘿，我来帮你梳理下Umbraco里logo上传相关的问题，结合平时的开发经验给你讲讲：

1. 包含Logo上传功能代码的文件位置 #

Umbraco的logo上传属于后台设置模块的核心功能，不同版本的文件位置略有差异，而且这些都是Umbraco的核心文件，不建议直接修改（升级时会被覆盖）：

• Umbraco 8（.NET Framework版本）：
  • 处理上传请求的逻辑在Umbraco.Web.Editors.SettingsController的PostSaveLogo方法里，这个类封装在Umbraco.Web.dll中；
  • 负责渲染上传UI的视图是~/Views/Setting/ContentSettings.cshtml，里面包含了logo上传的表单元素。
• Umbraco 9+（.NET Core版本，包括10/11/12等）：
  • 上传逻辑的控制器是Umbraco.Cms.Web.BackOffice.Controllers.SettingsController的SaveLogo方法，位于Umbraco.Cms.Web.BackOffice.dll中；
  • 对应的UI视图是~/Views/Partials/Settings/ContentSettings.cshtml，用来展示logo上传的界面。

2. 如何自定义Umbraco的Logo上传功能 #

自定义的方式完全看你的需求，下面是几种常见场景的实现方案：

场景1：修改Logo存储路径或处理上传文件 #

如果想改变logo的存储位置，或者对上传的logo做压缩、加水印这类处理，最稳妥的方式是通过订阅Umbraco的通知事件来实现，不用修改核心代码：

1. 创建一个通知处理器类，实现INotificationHandler<SettingsSavedNotification>接口；
2. 在处理方法里获取上传的logo文件，编写自定义逻辑；
3. 在项目的Startup.cs里注册这个处理器。

举个Umbraco 10+的示例代码：

public class CustomLogoHandler : INotificationHandler<SettingsSavedNotification>
{
    private readonly IWebHostEnvironment _webHostEnvironment;

    public CustomLogoHandler(IWebHostEnvironment webHostEnvironment)
    {
        _webHostEnvironment = webHostEnvironment;
    }

    public void Handle(SettingsSavedNotification notification)
    {
        var logoPath = notification.Settings.UmbracoLogoPath;
        if (!string.IsNullOrEmpty(logoPath))
        {
            // 获取原始logo的物理路径
            var originalFilePath = Path.Combine(_webHostEnvironment.WebRootPath, logoPath.TrimStart('/'));
            // 自定义处理：比如复制到自定义目录
            var customLogoDir = Path.Combine(_webHostEnvironment.WebRootPath, "custom-logos");
            Directory.CreateDirectory(customLogoDir);
            var newLogoPath = Path.Combine(customLogoDir, Path.GetFileName(originalFilePath));
            File.Copy(originalFilePath, newLogoPath, overwrite: true);
            // 更新设置中的logo路径，指向新文件
            notification.Settings.UmbracoLogoPath = $"/custom-logos/{Path.GetFileName(originalFilePath)}";
        }
    }
}

然后在Startup.cs的ConfigureServices方法里添加注册：

services.AddNotificationHandler<SettingsSavedNotification, CustomLogoHandler>();

场景2：自定义上传UI界面 #

如果想修改上传界面的样式、添加字段或验证规则，可以通过覆盖默认视图实现：

1. 在你的项目里创建和核心视图相同的路径：比如Umbraco 9+中创建~/Views/Partials/Settings/ContentSettings.cshtml；
2. 复制Umbraco默认视图的内容到这个文件里，然后根据需求修改上传表单的HTML和逻辑。

场景3：完全替换上传逻辑 #

如果需要彻底自定义上传流程（比如对接第三方存储、添加复杂权限验证），可以：

1. 创建一个继承自UmbracoAuthorizedApiController的自定义控制器，实现自己的logo上传接口；
2. 编写自定义视图来展示新的上传界面；
3. 通过Umbraco的后台导航扩展，添加新的设置菜单项指向你的自定义页面，或者隐藏默认的logo设置项。

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