Discourse 监视类别按钮

目前发布在 Dev,但可能更适合 Theme component(我对其是只读的)

:discourse2: 摘要 关注分类按钮 (Watch Category Button) 在帖子中添加一个标记 span,使其成为一个“关注此分类”按钮。
:hammer_and_wrench: 仓库 \u003chttps://github.com/pacharanero/discourse-watch-category-button\u003e
:open_book: 初次接触 Discourse 主题? Discourse 主题使用入门指南

安装此主题组件

\u003c!-- disabled

disabled –\u003e

\u003e :information_source: 此主题组件使用登录用户的会话来更新分类通知级别;不需要 API 密钥。

功能

  • 使用一个可安全消毒的 span 在帖子内添加一个“关注此分类”按钮。

  • 点击按钮会将当前用户的分类通知级别设置为关注(Watching),对象是当前分类或通过 CategoryId 选择的分类。

  • 只有由允许的组(默认:staff)撰写的帖子才会被转换为按钮(这是为了减少此主题组件被误用以使人们通过误导来关注分类的可能性)。

  • 支持定位特定的分类 ID 或当前帖子的分类。

  • 挂接到现有的 Discourse 关注通知功能,不改变用户在偏好设置、按分类或在电子邮件通知退订中管理关注状态的方式。

用法

设置特定分类

\u003cspan data-watch-category=\"3\"\u003e关注此分类\u003c/span\u003e

使用当前帖子的分类

\u003cspan data-watch-category=\"current\"\u003e关注此分类\u003c/span\u003e

结果:

设置

此组件尚不包含主题设置。下一步是确保没有重大错误,并且此主题组件对其他人有用。

安全和隐私注意事项

  • 目前,只有 Staff 用户可以创建这些按钮
  • 需要用户明确点击才能更改通知设置。
  • 不使用 API 密钥;它依赖于登录会话。

路线图想法

  • 通过主题设置使可以创建按钮的组可配置。
  • 通过主题设置使按钮样式可配置。
  • 使通知级别可配置(例如,跟踪、关注、静音)。

贡献

我欢迎贡献!请在 GitHub 仓库上提交问题或拉取请求。理想情况下,让我们改进_这个_组件,而不是为了更改 ALLOWED_GROUPS 或其他细微更改而对其进行分支。

:discourse2: 摘要 关注分类按钮 (Watch Category Button) 在帖子中添加一个标记 span,使其成为一个“关注此分类”按钮。
:eyeglasses: 预览 在此处添加截图/GIF
:hammer_and_wrench: 仓库 \u003chttps://github.com/pacharanero/discourse-watch-category-button\u003e
:open_book: 初次接触 Discourse 主题? Discourse 主题使用入门指南

安装此主题组件

\u003e :information_source: 此主题组件使用登录用户的会话来更新分类通知级别;不需要 API 密钥。

功能

  • 使用一个可安全消毒的 span 在帖子内添加一个“关注此分类”按钮。
  • 点击按钮会将当前用户的分类通知级别设置为关注(Watching)。
  • 只有由允许的组(默认:staff)撰写的帖子才会被转换为按钮。
  • 支持定位特定的分类 ID 或当前帖子的分类。

用法

设置特定分类

\u003cspan data-watch-category=\"3\"\u003e关注此分类\u003c/span\u003e

使用当前帖子的分类

\u003cspan data-watch-category=\"current\"\u003e关注此分类\u003c/span\u003e

设置

此组件尚不包含主题设置。要更改可以创建按钮的用户组,请编辑:

  • javascripts/discourse/api-initializers/theme-initializer.gjs 中的 ALLOWED_GROUPS

注意事项

  • 需要用户明确点击(没有静默更改)。
  • 此更改反映了原生的分类通知菜单行为。
  • 访问分类页面时,页眉会更新,而无需完全刷新页面。

相关主题

在研究此主题组件是否已被创建时,我发现了一些请求类似功能的帖子:

Change notification level with a link
Can I create a link to subscribe to a category? - #3 by david
Make watching a category more prominent for users
Notification setting button with context

3 个赞