配置 Patreon 与 Discourse 的集成

[Discourse]

本指南介绍如何设置和配置 Patreon 与您的 Discourse 论坛的集成，包括用户同步、群组管理和访问控制。

所需用户级别：管理员

需要安装 Discourse Patreon 插件

摘要

本指南涵盖：

• 设置 Patreon API 凭证
• 配置 Discourse Patreon 插件
• 将 Patreon 用户与 Discourse 群组同步
• 管理赞助者群组设置
• 设置 Webhook 以实现实时更新
• 限制网站访问权限给 Patreon 支持者

只有已认捐分级会员资格的用户才会同步到 Discourse 群组。免费用户和 7 天免费试用用户将不会被同步。

创建 Patreon 凭证

1. 前往 Patreon 客户端和 API 密钥页面
2. 点击“创建客户端”

3. 使用以下详细信息填写表格：

• 应用名称
• 描述
• 应用类别
• 作者
• 公司域名：discourse.example.com
• 隐私政策网址：https://discourse.example.com/privacy
• 服务条款网址：https://discourse.example.com/tos
• 重定向 URI：https://discourse.example.com/auth/patreon/callback
• 客户端 API 版本：设置为 1

该插件目前在内部使用 Patreon API v1 端点，因此客户端 API 版本必须设置为 1。将其设置为 2 将导致身份验证错误，因为仅 v2 的客户端无法访问 v1 端点。请注意，Patreon 已宣布 API v1 将在未来弃用。

4. 点击“创建客户端”
5. 保存您的凭证以备下一步使用

配置 Discourse 插件

1. 导航到您的管理员 → 站点设置面板
2. 在搜索栏中输入 Patreon。
3. 将以下内容从您的 Patreon 客户端复制并粘贴到 Discourse：

• patreon client id（Patreon 客户端 ID）
• patreon client secret（Patreon 客户端密钥）
• patreon creator access token（Patreon 创建者访问令牌）
• patreon creator refresh token（Patreon 创建者刷新令牌）

可选设置：

• 通过选中 patreon donation prompt enabled 并设置您的活动网址来启用捐赠提示
• 通过设置您的 patreon creator discourse username（Patreon 创建者 Discourse 用户名）并选中 patreon login enabled 来启用 Patreon 登录
• 选中 patreon enabled 以激活插件

同步 Patreon 数据

1. 访问 https://discourse.example.com/admin/plugins/patreon
2. 点击“更新 Patreon 数据并同步群组”

同步成功将显示一条确认消息：

将 Patreon 等级链接到 Discourse 群组

1. 从“群组”下拉菜单中选择一个 Discourse 群组
2. 从“奖励”下拉菜单中选择一个 Patreon 奖励等级
3. 点击保存图标

链接群组后，再次点击“更新 Patreon 数据并同步群组”以同步现有用户。

赞助者群组自定义

默认的赞助者群组包括：

• 头像装饰
• 赞助者徽章

要自定义这些：

1. 访问赞助者群组页面
2. 点击“管理”选项卡
3. 调整装饰和群组描述设置

设置 Webhook（可选）

要启用实时同步：

1. 访问 平台 | 应用程序 | Patreon
2. 创建一个指向 https://discourse.example.com/patreon/webhook 的 Webhook

3. 启用以下触发器：

• 创建认捐 (pledges:create 或 members:pledge:create)
• 更新认捐 (pledges:update 或 members:pledge:update)
• 删除认捐 (pledges:delete 或 members:pledge:delete)

4. 将 Webhook 密钥复制到您的 patreon webhook secret 站点设置中

限制网站访问权限给 Patreon 支持者

要将网站访问权限限制给 Patreon 用户：

1. 确保 Patreon 登录正常工作
2. 禁用以下设置：

• enable local logins（启用本地登录）
• enable local logins via email（通过电子邮件启用本地登录）

要将访问权限仅限于您的 Patreon 支持者：

1. 配置类别安全设置
2. 将类别链接到已连接 Patreon 的群组

故障排除

通过激活 patreon verbose log（Patreon 详细日志）设置来启用详细日志记录。在 https://discourse.example.com/logs 访问日志。

附加资源

• Discourse Patreon
• 了解群组和类别权限
• Patreon 客户端和 API 密钥