# Discourse 欢迎模态框 **URL:** https://meta.discourse.org/t/discourse-welcome-modal/395095 **Category:** Theme component **Created:** [2026年二月3日 23:48 UTC](https://meta.discourse.org/t/discourse-welcome-modal/395095 "2026-02-03T23:48:20Z") **Posts on this page:** 1 **Showing post:** 1
### Author: ![noahl](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/noahl/32/552343_2.png) [@noahl](https://meta.discourse.org/u/noahl) #### Post date: [2026年二月3日 23:48 UTC](https://meta.discourse.org/t/discourse-welcome-modal/395095/1 "2026-02-03T23:48:20Z")
| | | | | --- | --- | --- | | ℹ | **摘要** | 一个欢迎模态框，旨在通过可操作的方式帮助新用户或回归社区成员开始探索/参与论坛 | | 👓 | **预览** | [Theme Creator](https://discourse.theme-creator.io/?preview_theme_id=10412) (需要登录) | | 🛠 | **代码仓库** | [GitHub - noahLovell/discourse-welcome-modal](https://github.com/noahLovell/discourse-welcome-modal) | | ❓ | **安装指南** | [如何安装主题或主题组件](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682) | | 📖 | **不熟悉 Discourse 主题？** | [Discourse 主题使用入门指南](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) | 安装此主题组件 ## 🚀 为什么要使用它？ 许多社区的注册率很高，但在“第一天流失”方面却很挣扎。通过提供可操作的路径，可以减少新成员的认知负担，并引导他们采取有助于长期留存的高价值行为。 * * * ## 📸 截图 ### 桌面端 ![Screenshot 2026-02-03 at 23.08.08](https://global.discourse-cdn.com/meta/original/4X/c/8/f/c8ffa0ee7375bf6bc6477bc4366b812f6d4ced2a.jpeg) ![Screenshot 2026-02-03 at 23.07.22](https://global.discourse-cdn.com/meta/original/4X/4/d/3/4d345eab6255b8dc6f11c61b2064dc91ff5cbdde.jpeg) ### 移动端 ![Screenshot_20260203_231759_Chrome](https://global.discourse-cdn.com/meta/original/4X/9/0/b/90bd84c143595ca836271dc7fed73055cb35c03e.jpeg) * * * ## 工作原理 该模态框使用基于逻辑的推出机制，因此您可以防止向已经熟悉您社区的常规成员打扰。 1. **新用户** ：自动向在您的 `feature_enabled_date` 之后注册的所有用户显示。 2. **宽限期** ：在可配置的时间窗口内，该组件会“静默地”将活跃用户标记为已查看过该模态框，以免打扰他们。 3. **旧用户** ：在宽限期结束后，向返回论坛的现有用户显示，帮助他们重新入职。 > **注意：** “已查看”状态存储在用户的浏览器本地，因此如果他们更换设备或清除缓存，该模态框可能会重新出现。 * * * ## ⚙ 设置 | 设置 | 类型 | 默认值 | 描述 | | --- | --- | --- | --- | | `enabled` | `bool` | `false` | 当您准备好对成员启用“Discourse 欢迎模态框”时，切换其状态。 | | `feature_enabled_date` | `string` | `\"2026-01-01\"` | 以 YYYY-MM-DD 格式输入日期。 | | `grace_period_months` | `integer` | `3` | 从功能启用日期算起，静默标记现有用户已查看的月数。 | | `card_layout` | `enum` | `\"grid\"` | 选择欢迎模态框中卡片的显示方式（`grid` 或 `list`）。 | | `card_content` | `objects` | `[]` | 配置欢迎模态框中显示的卡片（需要 `id`、`title`、`subtitle`、`imgUrl`、`altText`、`btnLabel` 和 `action`）。 | | `title` (翻译) | `text` | `Join the conversation` | 在模态框顶部显示的标题。 | | `close_btn` (翻译) | `text` | `Done` | 用于关闭模态框的按钮标签。 | 使用 `?show-welcome-modal=true` 可以强制显示欢迎模态框，无论功能是否启用，或者它是否已被查看过——非常适合在向社区正式发布之前进行测试 🙂 * * * _这是我的第一个 **正式** 主题组件 🙌 我很乐意听取反馈、想法以及可以做得更好的地方 😄_ --- _[View the full topic](https://meta.discourse.org/t/discourse-welcome-modal/395095)._