| 摘要 | 类别横幅 利用现有的类别详细信息为您的类别页面创建横幅(如需查看标签,请访问 Discourse 标签横幅)。 | |
| 预览 | 在 Discourse 主题创建器中预览 | |
| 仓库链接 | https://github.com/discourse/discourse-category-banners | |
| Discourse 主题新手? | 使用 Discourse 主题的入门指南 |
安装此主题组件
功能
类别横幅 利用现有的类别详细信息为您的类别页面创建横幅。它使用类别名称、描述和颜色在相关类别页面的顶部生成横幅(如需查看标签,请访问 Discourse 标签横幅)。
类别描述由每个类别的“关于此类别的…主题”中的第一段定义。横幅背景/文本颜色由您的类别徽章设置定义。
默认情况下,这将在桌面端和移动端的各类别和子类别页面上显示,但如果您未为类别提供描述,则不会显示。
设置
此组件提供了一些选项以覆盖默认设置:
| 名称 | 描述 |
|---|---|
| show description | 显示“关于此类别”帖子中的描述 |
| show mobile | 在移动设备上显示横幅 |
| show subcategory | 为子类别显示横幅 |
| hide if no description | 如果未设置类别描述,则隐藏横幅 |
| show category logo | 显示类别徽标 |
| align text | 对齐文本 |
| exceptions | 横幅不会显示在这些类别名称中 |
| categories | 为其显示横幅的类别 |
| plugin outlet | 更改横幅在页面上的位置 |
| show category icon | 显示类别设置中的类别图标或表情符号 * |
| override category icon color | 当使用类别图标时,启用此选项将使图标与横幅文本颜色匹配 |
- 请注意,此设置现在指的是 在类别设置中设置的类别图标或表情符号,而不是 类别图标 主题组件(该组件已弃用,推荐使用核心功能)。
自定义说明
如果您想使用一些额外的 CSS 进行自定义,可以通过以下结构针对特定的类别标题(example-category 是您的类别名称):
.category-title-header {
&.category-banner-example-category {
background: url(example.jpg);
}
}
此组件还会向 body 标签添加 category-header 类,作为额外的 CSS 目标。
由我们托管? 主题组件可在我们的标准版、商业版和企业版计划中使用。
