Orchard Core 自定义配置

自定义设置允许站点管理员创建一组对网站全局的自定义属性。
这些设置在标准设置部分中进行编辑，可以使用特定权限进行保护。

创建自定义配置

自定义设置按配置节进行组织。每个部分都由带有CustomSettings构造型的Content Type表示。
创建此类配置节时，需要禁用Creatable, Listable, Draftable 和 Securable配置节，因为它们不适用。

警告：不要使用自定义配置构造任何现有的内容类型，因为这将破坏此类型的现有内容项。

与任何其他内容类型一样，自定义设置由部件和字段组成。
创建后，打开设置菜单项，这些配置节中的每个部分都应该出现在模块提供的部分旁边。

权限

每个自定义设置部分都获得专用权限，以允许特定用户对其进行编辑。
要编辑此权限，请打开角色编辑器并转到OrchardCore.CustomSettings功能组。

用法

Liquid

自定义设置(与其他设置一样)位于{{Site.Properties}}对象中。
每个部分都使用其名称提供。
例如，可以使用{{Site.Properties.BlogSettings.HtmlBodyPart}}访问名为BlogSettings的自定义设置节的HtmlBodyPart。

代码

自定义设置是ContentItem，通过将其作为ContentItem进行访问，您可以访问其部件和元数据。

您将需要使用依赖项注入注册ContentPart，参加ContentTypes文档中内容。

下面是获取名为BlogSettings的自定义设置节的HtmlBodyPart的示例：

public class MyController : Controller
{
    private readonly ISiteService _siteService;
    public MyController(ISiteService siteService)
    {
        _siteService = siteService;
    }
    public async Task<IActionResult> Index()
    {
        var siteSettings = await _siteService.GetSiteSettingsAsync();
        var blogSettings = siteSettings.As<ContentItem>("BlogSettings");
        var blogHtml = blogSettings.As<HtmlBodyPart>();

        return View();
    }
}