Discourse 每日挑战

[R23D_Printing]

	摘要	运行限时每日签到挑战，包括排行榜、自动帖子和徽章奖励。
	仓库链接	GitHub - R23DPrinting/discourse-daily-challenge · GitHub
	安装指南	如何在 Discourse 中安装插件

背景故事

我运营着一个健康和保健社区，该社区最近从 Discord 迁移到了 Discourse。在 Discord 上，我曾构建了一个自定义机器人来运行月度健身挑战——成员会发布他们每日的锻炼情况，机器人会跟踪签到、发布每周排行榜，并在每个月末宣布获胜者。这是我们最受欢迎的功能之一。

迁移到 Discourse 后，成员们开始要求恢复这些挑战。我搜索了现有的插件，但一无所获。于是我决定自己开发一个。

最初只是一个快速的解决方案，结果却变成了一个功能齐全的挑战系统，老实说，它比原来的 Discord 机器人效果更好。由于它可能对其他社区也有用，所以在这里分享给大家。

功能

• 通过主题标签或照片签到——成员通过发布挑战主题标签（例如 #AprilFitness）或上传图片到挑战主题上来签到。两者都会触发有效的签到。
• 每日一次签到——在应用程序和数据库层面强制执行。每个用户的每日时间窗口基于其个人资料时区。
• 每个挑战独立时区——独立于服务器时区设置挑战时区，这样就不会有成员在 UTC 午夜时被截止。
• 实时管理员仪表板——同时显示所有活跃挑战，包括参与者数量、平均签到次数、连胜跟踪、完成百分比和排名靠前的排行榜。
• 多个同步进行的挑战——可以同时运行多个挑战，每个挑战都有自己的主题、主题标签、时间表和徽章。
• 已归档的挑战——已完成的挑战保存在一个可折叠的存档中，显示最终统计数据、获胜者和完成率。
• 自动每周排行榜帖子——在挑战时区中，于可配置的日期和时间发布到挑战主题中。
• 最终结果帖子——在挑战结束后第二天自动发布，列出所有达到签到目标的成员。
• 自定义徽章奖励——自动为每个挑战创建一个 Discourse 徽章，并在挑战结束时颁发给符合条件的参与者。
• 管理员签到管理——直接从管理面板为任何用户添加或删除签到记录。
• 手动触发排行榜——可以随时从挑战详情页面触发发布排行榜。
• 包容性的结束日期——如果将结束日期设置为 3 月 31 日，3 月 31 日的签到也会被计算在内。

配置

创建挑战

转到 管理 → 插件 → 每日挑战 → 挑战 → 新建挑战

输入一个主题 ID 以将挑战链接到现有主题。插件将显示主题标题以供确认。填写主题标签触发器、开始和结束日期，以及完成挑战所需的签到次数。

设置挑战时区为您社区的主要时区，以确保日期边界能为您的成员正确评估。

如果您需要自动的每周排行榜帖子，请启用该开关并设置日期和时间。如果您需要一个完成徽章，请启用该开关并输入一个徽章名称（例如“四月健身冠军”）。

点击保存挑战——如果启用了徽章奖励，徽章将自动创建。

运行挑战

创建后，挑战立即生效。成员通过在链接的主题中发布带有主题标签或图片的帖子来签到。管理员仪表板（管理 → 插件 → 每日挑战 → 仪表板）显示所有活跃挑战的实时统计数据。

提示

• 要求成员在个人资料 → 偏好设置 → 界面 → 时区中设置其时区，以确保每日签到窗口准确。
• 使用挑战详情页面上的立即发布排行榜按钮，随时触发排行榜帖子。
• 使用挑战详情页面上的签到部分，为任何用户手动添加或删除签到记录。

设置

名称	描述
daily_challenge_enabled	插件的主开关
Topic ID	参与者发布签到的主题 ID
Hashtag trigger	监控的主题标签，不含 # 符号
Start date	接受签到的第一天
End date	接受签到的最后一天（包含）
Check-ins needed	完成挑战并获得徽章所需的签到次数
Description	关于挑战的可选内部注释（不向参与者显示）
Challenge timezone	用于日期边界和每周发布时间表的时区
Enable weekly leaderboard post	开启/关闭自动每周帖子
Post day of week	发布每周帖子的星期
Post hour (0-23)	在挑战时区中发布每周帖子的小时（0-23）
Award completion badge	开启/关闭自动创建和奖励徽章
Badge name	为此挑战创建的徽章的名称

后续计划

v2 计划内容：

• 每次签到后发送包含当前统计数据的私信确认
• 向尚未签到的参与者发送每日提醒私信
• 用于查询个人统计数据的 @提及 命令

支持和功能请求

如果您遇到任何问题或有新功能方面的想法，请在 GitHub 上提交问题或回复此主题。