看板

| |
|—|—|
| :discourse2: | 摘要 | 看板板 允许您使用看板界面显示和组织主题。
| :eyeglasses: | 预览 | 在 Discourse 主题创建器中预览|
| :hammer_and_wrench: | 仓库链接 | https://github.com/discourse/discourse-kanban-theme
| :open_book: | 初次接触 Discourse 主题? | 使用 Discourse 主题的入门指南

安装此主题组件

:discourse2: 由我们托管? 主题组件可在我们的 Pro、Business 和 Enterprise 计划中使用。

摘要

看板板主题组件改变了您组织和可视化论坛主题的方式。它提供了一个拖放界面,让您可以在代表类别、标签或用户分配的列之间移动主题,使其成为项目管理、工作流可视化和内容组织的理想选择。

功能

多种组织模式

看板板提供三种不同的模式来组织您的主题:

  1. 类别模式:按分配的类别组织主题
  2. 标签模式:按分配的标签组织主题
  3. 分配模式:按分配给用户的主题进行组织

您可以在列表之间拖放主题以自动更改相应的属性:

性能优化

列表采用“懒加载”方式,这意味着组件仅在需要时加载内容。即使处理大量类别或主题,也能确保合理的性能。

设置和配置

默认看板模式选择

默认看板模式将根据以下标准自动确定:

  • 如果是顶级页面,使用 类别 模式
  • 如果是类别且存在子类别,使用 类别模式
  • 否则,使用 标签 模式。(列表基于“顶级标签”列表构建)

更改看板模式

您可以使用左侧的过滤按钮更改看板模式,配置更改将反映在 URL 中。用户可以在浏览器中书签他们喜欢的配置。

设置

网站管理员可以通过主题设置自定义主题组件的默认设置:

摘要
设置 描述
显示类别 显示“看板”按钮的类别列表。如果留空,则 everywhere 显示。对于子类别,不要包含父级 slug。使用 @ 表示顶级视图。
默认模式 覆盖每个类别的默认看板模式。使用语法 category:mode:params。例如,support:assigned:david,sam,joffrey。使用 @ 代替类别表示顶级视图(例如 @:tags:todo,done)。使用 @untagged 显示未标记的列。
默认视图 “看板”作为默认视图的类别列表。(注意:尚不支持顶级默认视图)
需要确认 在更改主题的标签/类别之前显示确认模态框
显示标签 在主题卡片上显示标签
卡片样式 确定主题卡片的视觉样式(目前可用“详细”样式)
显示主题缩略图 在卡片底部显示主题缩略图
显示活动指示器 显示卡片活动指示器。如果主题在 7 天前或 20 天前被提升过,将应用不同的样式

每个设置的默认值如下所示:

文本自定义

管理员可以自定义整个看板板界面中使用的文本标签 自定义文本。以下文本元素可以自定义:

摘要
翻译 默认 描述
no_topics 无主题 当列中没有主题时显示
confirm_change_tags 从’%{title}'中移除‘#%{remove}‘并添加‘#%{add}’? 更改标签时的确认消息
confirm_close 关闭主题’%{title}'? 关闭主题时的确认
confirm_open 重新打开主题’%{title}'? 重新打开主题时的确认
confirm_change_category 移动主题’%{title}'? 更改主题类别时的确认
menu_label 看板 看板导航菜单项的文本
copy_link 复制链接到剪贴板 复制链接的工具提示
configure 配置看板板 配置按钮的文本
fullscreen 切换全屏 全屏切换按钮的文本
no_lists 未配置任何看板列表… 未配置任何列表时显示
controls 看板板控件 控件部分的标题
last_post_by 最后发帖人 最后发帖人信息的标签
modal.title 配置看板 配置模态框的标题
modal.tags_placeholder 要显示的标签… 标签输入字段的占位符
modal.categories_placeholder 要显示的类别… 类别输入字段的占位符
modal.usernames_placeholder 要显示的用户… 用户输入字段的占位符
modal.apply 应用 应用按钮的文本
modal.mode 看板模式 看板模式选择器的标签
modal.lists 列表 列表配置部分的标签

有效使用技巧

设置标签列

在标签模式下,最直观的设置是在 启用“仅从此组中选择一个标签”的标签组 中组织标签。这确保主题只能有一个状态标签,使看板板像传统的工作流板一样运行。

控制标签模式下的列顺序

您可以使用 default modes 设置指定确切的列顺序。例如,指定 roadmap:tags:discovery,design,build,testing 将以特定顺序显示列:

赋能您的用户

由于在看板列之间移动主题的机制是通过更改标签,因此您必须确保目标用户确实可以执行此操作。选项:

  1. 确保您的目标用户是 @staff@trust_level_4 或类别版主
  2. 更改 post edit time 站点设置(这允许用户在更长时间内更改自己主题的标题/标签)
  3. 将所有主题设为维基(不过他们需要编辑维基才能更改标签,这不太好)

常见问题

我可以在移动设备上使用看板板吗?

拖放功能目前在移动设备上无法工作,因为它们不支持 HTML5 拖放。您仍然可以在移动设备上查看看板,但无法在列之间移动卡片。

为什么设置后看板选项卡消失了?

如果在初始配置后看板选项卡消失,您可能需要确保在主题设置中正确输入了类别名称。请务必使用确切的类别 slug(如果适用,使用下划线而不是连字符),并分别配置父类别和子类别。

如何限制全站显示的标签?

您可以使用 default modes 设置配置在标签模式下显示的标签。指定哪些标签应作为列显示,以防止所有标签都出现。

如何更改卡片外观?

您可以使用多个设置自定义卡片外观:

  • 使用“卡片样式”设置选择显示格式
  • 通过“显示标签”选项启用或禁用卡片上的标签
  • 通过“显示主题缩略图”设置向卡片添加缩略图
  • 通过“显示活动指示器”设置添加视觉活动指示器

pr-welcome 功能:

  • 使列表更具可配置性。例如,允许管理员在一个显示中定义分配、标签和类别的组合

  • 添加对移动设备上拖动卡片的支持。不幸的是,它们不支持 HTML 拖放


159 个赞
Creative Uses of Discourse
Manage categories Trello style - a kanban service for Discourse
Kanban Board Overlay for Discourse Topics
Different themes per category?
I want to code a kanban interface to categories .. lets put a spec together
Project management in Discourse
Feature request: "I will follow on at this date"
Subcategory selection in the Kanban TC could be improved
Topic List Thumbnails
Add a new special character to Kanban theme component allowing users to define 'all categories'
FKB Pro - Social theme
Customizing your site with existing theme components
Roadmap Style Category
Creating a system to move topics based on given criteria such as a timestamp
Super long line in topic causing page to be sidescrolled (a lot!)
Roadmap Style Category
Using forum researcher to help organize and split large topics
How to embed Notion to Discourse
Nav Button Highlighter component - now working
Category homepage as default?
Added a section on user permissions to enable kanban changes to documentation
What is the best way to Integrate Trello with Discourse?
Manage categories Trello style - a kanban service for Discourse
Time tracking using Discourse?
New Theme: Tag-Pages Navigation
How would I able to list topics as boxes
Customize hamburger menu to add switch what switches theme and applies predefiend filter
Customize hamburger menu to add switch what switches theme and applies predefiend filter
Advise on how to organize my forum categories and tags
Anyone tried to implement a slipbox/zettelkasten in Discourse
List of categories not showing in "Display categories" control
Layouts Plugin
New Theme: Tag-Pages Navigation
Refactor structured data/microdata in ItemLists to become "simple" ListItem
Mandatory tags not being enforced for staff
Manage categories Trello style - a kanban service for Discourse

这个插件得到了很大的改进,感谢核心团队的投入!

我建议添加一个选项,以便始终将一个特定的置顶主题显示在看板表的顶部

这将有助于确保重要的信息 (如何使用 'support') 对所有用户保持可见,即使在使用看板视图时也是如此。

您能澄清一下,如果我在看板上使用标签(而不是分类)时,“默认模式”设置应该是什么吗?

这来自文档,但不是很清楚:

基本上,我有两个标签(tododone),并希望看板显示来自任何分类中带有这些标签的帖子。

我认为 @:tags:todo,done 应该可以满足你的要求

2 个赞

有效了!感谢 @Moin

编辑:我已经更新了原帖中的文档,使其更清晰

3 个赞

您好,

感谢您在插件上所做的出色工作。

目前在标签模式的配置中,是否有任何方法可以只显示分类下的卡片,而不显示子分类的卡片?

开始考虑迁移到 Horizon 主题——请问 Kanban 主题组件是否兼容?该组件不在列表中,我大致推测它可能不兼容,因为 Horizon 的设计非常具有倾向性,以合理的方式处理新 UI 可能会很困难。

如果不兼容,是否有办法将 Kanban 组件分叉修改为能够与 Horizon 配合使用的版本?

它在 Horizon 上应该能运行得相当不错。

刚在我的开发机器上启动了 Horizon,但看板完全无法使用——之前使用默认主题(几个版本之前)时是正常的。可能只是某个管理设置问题,但还是想问一下……

我会进一步调查……

1 个赞

我试了一下,在我这边可以正常工作。
你可以检查以下几点:

  • 组件是否已附加到主题?
  • 浏览器控制台是否有报错?
2 个赞

我一直很愉快地在 Horizon 上使用它。

我记得为了让看板有更宽的视图,我稍微调整了一下它,因为 Horizon 在中间部分的水平空间有点局促。这是我使用的 CSS:

// 允许看板视图占据主容器的整个宽度,并控制列宽
@media (min-width: 40rem) {
    body.kanban-active:not(.has-full-page-chat,.wizard) #main-outlet-wrapper #main-outlet>*:not(.experimental-screen,.activate-account) {
        max-width: none;
    }
}
.discourse-kanban-container .discourse-kanban-list {
    width: 350px;
}
4 个赞