このガイドでは、ユーザー同期、グループ管理、アクセス制御を含む、DiscourseフォーラムでのPatreon統合の設定と構成方法について説明します。
必要なユーザーレベル：管理者
Discourse Patreonプラグインのインストールが必要です
概要
このガイドでは、以下の項目について説明します。
- Patreon API認証情報のセットアップ
- Discourse Patreonプラグインの構成
- PatreonユーザーとDiscourseグループの同期
- 後援者グループ設定の管理
- リアルタイム更新のためのWebhookの設定
- Patreonサポーターへのサイトアクセス制限
チア参加（ティアメンバーシップへの出資）を行ったメンバーのみがDiscourseグループに同期されます。無料ユーザーや7日間の無料トライアル中のユーザーは同期されません。
Patreon認証情報の作成
- Patreon クライアント & API キー ページに移動します。
- 「クライアントの作成」をクリックします。
- フォームに以下の情報を入力します。
- アプリ名 (App Name)
- 説明 (Description)
- アプリのカテゴリ (App Category)
- 作成者 (Author)
- 会社ドメイン (Company Domain):
discourse.example.com - プライバシーポリシー URL (Privacy Policy URL):
https://discourse.example.com/privacy - 利用規約 URL (Terms of Service URL):
https://discourse.example.com/tos - リダイレクト URI (Redirect URIs):
https://discourse.example.com/auth/patreon/callback - クライアント API バージョン (Client API Version):
1に設定します。
このプラグインは現在内部的にPatreon API v1エンドポイントを使用しているため、クライアント API バージョンは 1 に設定する必要があります。2 に設定すると、v2専用クライアントはv1エンドポイントにアクセスできないため、認証エラーが発生します。PatreonはAPI v1が将来廃止されることを発表している点に注意してください。
- 「クライアントの作成」をクリックします。
- 次のステップのために認証情報を保存します。
Discourseプラグインの構成
- 管理画面 → サイト設定パネルに移動します。
- 検索バーに
Patreonと入力します。 - Patreonクライアントから以下の情報をコピーしてDiscourseに貼り付けます。
patreon client idpatreon client secretpatreon creator access tokenpatreon creator refresh token
オプション設定：
patreon donation prompt enabledをチェックし、キャンペーンURLを設定して寄付プロンプトを有効にします。patreon creator discourse usernameを設定し、patreon login enabledをチェックしてPatreonログインを有効にします。patreon enabledをチェックしてプラグインをアクティブ化します。
Patreonデータの同期
https://discourse.example.com/admin/plugins/patreonにアクセスします。- 「Patreon データを更新 & グループを同期」をクリックします。
同期が成功すると、確認メッセージが表示されます。
PatreonティアとDiscourseグループのリンク
- グループのドロップダウンからDiscourseグループを選択します。
- RewardsドロップダウンからPatreonリワードティアを選択します。
- 保存アイコンをクリックします。
グループをリンクした後、既存のユーザーを同期するために、もう一度「Patreon データを更新 & グループを同期」をクリックします。
Patronグループのカスタマイズ
デフォルトのPatronグループには以下が含まれます。
- アバターの装飾 (Avatar flair)
- Patronバッジ
これらをカスタマイズするには：
- Patronグループページにアクセスします。
- 「管理 (Manage)」タブをクリックします。
- 装飾やグループの説明設定を調整します。
Webhookの設定（オプション）
リアルタイム同期を有効にするには：
- Platform | Applications | Patreon にアクセスします。
https://discourse.example.com/patreon/webhookを指すWebhookを作成します。
- 以下のトリガーを有効にします。
- チア作成 (
pledges:createまたはmembers:pledge:create) - チア更新 (
pledges:updateまたはmembers:pledge:update) - チア削除 (
pledges:deleteまたはmembers:pledge:delete)
- Webhookシークレットを
patreon webhook secretサイト設定にコピーします。
Patreonサポーターへのサイトアクセス制限
サイトへのアクセスをPatreonユーザーに制限するには：
- Patreonログインが機能していることを確認します。
- 以下の設定を無効にします。
enable local logins（ローカルログインを有効にする）enable local logins via email（メール経由のローカルログインを有効にする）
Patreonサポーターのみにアクセスを制限するには：
- カテゴリのセキュリティ設定を構成します。
- カテゴリをPatreon接続済みグループにリンクします。
トラブルシューティング
patreon verbose log 設定を有効にして、詳細なロギングを有効にします。ログは https://discourse.example.com/logs で確認できます。