 |
摘要 | Homepage Feature（首页精选）会在您社区的首页展示最多 5 个带有图片的主题。 |
 |
预览 | 在 Discourse Theme Creator 上预览 |
 |
代码库链接 | https://github.com/discourse/discourse-homepage-feature-component |
 |
初次使用 Discourse 主题？ | Discourse 主题使用入门指南 |
安装此主题组件
功能特性
默认情况下，该主题会展示最近 3 个标记为 featured（精选）的主题，并提取该主题中的第一张图片。在设置中，您可以选择自定义标签、隐藏标签、设置自定义标题，并配置组件出现的位置。
移动端与小屏幕
默认情况下，在移动设备上它会减少显示的主题数量，直到仅剩 1 个。
您可以通过开启 show all always（始终全部显示）来更改此默认行为。这会使组件在小屏幕（< 1000px）上支持水平滚动。
在最小的屏幕（< 600px）上，您可以通过更改 mobile style（移动样式）设置，选择将主题垂直堆叠显示。
设置项
| 名称 | 描述 |
|---|---|
| featured tag（精选标签） | 设置用于提取主题的标签。匹配任意一个选定标签的主题都会被展示。 |
| number of topics（主题数量） | 在最大宽度下最多展示 5 个主题 |
| max number of topics（最大主题数量） | 精选主题的最大数量。如果设置得高于 number of topics，则会显示箭头以分页浏览主题。 |
| pages loop（页面循环） | 如果启用了分页（max number of topics > number of topics），浏览完最后一页后会循环回到第一页。 |
| hide featured tag（隐藏精选标签） | 启用时（默认设置），上述设置的精选标签对普通用户隐藏。管理员仍可见。 |
| show on（显示位置） | 组件出现的位置：homepage（首页）、top_menu 页面（在顶部菜单站点设置中指定的页面）或 all（所有）页面。 |
| show for（显示对象） | 哪些访客可以看到该组件：everyone（所有人）、仅 logged_in（已登录）用户，或仅 logged_out（未登录/匿名）访客。 |
| make collapsible（可折叠） | 使整个组件可折叠 |
| show title（显示标题） | 显示下方设置的文本（当 make_collapsible 开启时，标题始终显示） |
| title text（标题文本） | 标题的文本；如果您想本地化此文本，请使用 featured_topic_title 翻译项 |
| sort by created（按创建时间排序） | 禁用此项将改为按最近回复排序 |
| show all always（始终全部显示） | 默认情况下，显示的主题数量会随屏幕尺寸减小而减少，在移动端仅显示 1 个。勾选此项将在任何屏幕尺寸下显示所有主题。 |
| hide closed topics（隐藏已关闭主题） | 从精选主题列表中隐藏已关闭的主题 |
| always link to first post（始终链接到首帖） | 始终链接到主题的第一篇帖子，即使之前已经阅读过 |
| mobile style（移动样式） | 如果勾选了 show_all_always，默认情况下主题将通过水平滚动显示。您可以更改小屏幕上的此行为，选择在小于 600px 的屏幕上垂直堆叠显示。 |
| featured content position（精选内容位置） | 高级主题开发：这会更改组件的插件出口（plugin outlet） |
| featured image sizes（精选图片尺寸） | 为精选图片提供的调整大小后的变体（宽度x高度）。浏览器会加载适合当前屏幕尺寸和像素密度的最小图片，从而节省带宽。请提供几种涵盖标准和高分辨率屏幕的尺寸。 |
| 翻译项 | 默认值 |
|---|---|
| featured_topic_title |
由我们托管？ 主题组件可在我们的 Pro、Business 和 Enterprise 计划中使用。
。
