宣布主题化站点设置

[martin (Martin Brennan)]

这是与公告 Themeable site settings are now available 相关的主题，以便开发者知晓。

@martin

它们在哪里定义？

可主题化的站点设置在核心 config/site_settings.yml 文件中定义。每个可主题化的站点设置都定义了 themeable: true 选项。

目前，只有两个站点设置是可主题化的——enable_welcome_banner 和 search_experience——但未来我们可能会使更多站点设置可主题化。

主题作者如何控制默认值？

主题作者可以在 about.json 文件中使用 theme_site_settings 键来定义主题站点设置覆盖，如下所示：

"theme_site_settings": {
  "enable_welcome_banner": false
}

此处的任何值都将保存到数据库并与主题相关联。一旦保存了值，当主题更新时，about.json 文件中的 theme_site_settings 的更改将不会影响当前保存的数据库值，因为我们无法知道管理员是否在此期间更改了设置。

可主题化站点设置的局限性是什么？

可主题化站点设置仅用于控制 UI 的元素，并且在检索其值时需要主题 ID，因此存在以下限制：

• 可主题化站点设置不能在 Sidekiq 作业中使用
• 可主题化站点设置不能在 Markdown 规则中使用
• 可主题化站点设置将使用主题 ID 作为键单独缓存，与客户端站点设置分开
• 可主题化站点设置将使用应用程序预加载器覆盖客户端上的 siteSettings 服务中的键
• SiteSetting.client_settings_json 不会包含可主题化站点设置，而是可以调用 SiteSetting.theme_site_settings_json 并传入主题 ID

总的来说，主题站点设置仅用于控制 UI 部分的简单设置，不涉及任何服务器端内容。

初始 PR 在这里 https://github.com/discourse/discourse/pull/32233

开发者文档在这里 https://meta.discourse.org/t/controlling-site-settings-with-themes/374376