Configurer l'intégration Patreon avec Discourse

[Discourse]

Ce guide explique comment configurer et paramétrer l’intégration de Patreon avec votre forum Discourse, y compris la synchronisation des utilisateurs, la gestion des groupes et le contrôle d’accès.

Niveau d’utilisateur requis : Administrateur

Nécessite l’installation du plugin Discourse Patreon

Résumé

Ce guide couvre :

• Configuration des informations d’identification de l’API Patreon
• Configuration du plugin Discourse Patreon
• Synchronisation des utilisateurs Patreon avec les groupes Discourse
• Gestion des paramètres des groupes de mécènes
• Configuration des webhooks pour les mises à jour en temps réel
• Restriction de l’accès au site aux supporters Patreon

Seuls les membres qui se sont abonnés à un niveau d’adhésion seront synchronisés avec les groupes Discourse. Les utilisateurs gratuits et les utilisateurs sous l’essai gratuit de 7 jours ne seront pas synchronisés.

Création des informations d’identification Patreon

1. Allez à la page Clés API et clients Patreon
2. Cliquez sur « Create Client » (Créer un client)

3. Remplissez le formulaire avec ces détails :

• App Name (Nom de l’application)
• Description
• App Category (Catégorie de l’application)
• Author (Auteur)
• Company Domain (Domaine de l’entreprise) : discourse.example.com
• Privacy Policy URL (URL de la politique de confidentialité) : https://discourse.example.com/privacy
• Terms of Service URL (URL des conditions d’utilisation) : https://discourse.example.com/tos
• Redirect URIs (URI de redirection) : https://discourse.example.com/auth/patreon/callback
• Client API Version (Version de l’API du client) : Définir à 1

Le plugin utilise actuellement les points de terminaison de l’API v1 de Patreon en interne, par conséquent, la version de l’API du client doit être définie sur 1. La définir sur 2 provoquera des erreurs d’authentification car les clients v2 uniquement ne peuvent pas accéder aux points de terminaison v1. Notez que Patreon a annoncé que l’API v1 sera dépréciée à l’avenir.

4. Cliquez sur « Create Client » (Créer un client)
5. Enregistrez vos informations d’identification pour l’étape suivante

Configuration du plugin Discourse

1. Accédez à votre panneau Administration → Paramètres du site
2. Entrez Patreon dans la barre de recherche.
3. Copiez et collez les éléments suivants depuis votre client Patreon vers Discourse :

• patreon client id (identifiant client patreon)
• patreon client secret (secret client patreon)
• patreon creator access token (jeton d’accès du créateur patreon)
• patreon creator refresh token (jeton de rafraîchissement du créateur patreon)

Paramètres optionnels :

• Activez les invites de don en cochant patreon donation prompt enabled et en définissant votre URL de campagne
• Activez la connexion Patreon en définissant votre patreon creator discourse username (nom d’utilisateur discourse du créateur patreon) et en cochant patreon login enabled (connexion patreon activée)
• Cochez patreon enabled (patreon activé) pour activer le plugin

Synchronisation des données Patreon

1. Visitez https://discourse.example.com/admin/plugins/patreon
2. Cliquez sur « Update Patreon Data & Sync Groups » (Mettre à jour les données Patreon et synchroniser les groupes)

Une synchronisation réussie affichera un message de confirmation :

Lier les niveaux Patreon aux groupes Discourse

1. Sélectionnez un groupe Discourse dans le menu déroulant Group
2. Choisissez un niveau de récompense Patreon dans le menu déroulant Rewards
3. Cliquez sur l’icône Enregistrer

Après avoir lié les groupes, cliquez à nouveau sur « Update Patreon Data & Sync Groups » pour synchroniser les utilisateurs existants.

Personnalisation du groupe de mécènes

Le groupe Patron par défaut comprend :

• Flair d’avatar
• Badge de mécène

Pour personnaliser ceux-ci :

1. Visitez la page du groupe Patron
2. Cliquez sur l’onglet « Manage » (Gérer)
3. Ajustez les paramètres de flair et de description du groupe

Configuration des webhooks (facultatif)

Pour activer la synchronisation en temps réel :

1. Visitez Platform | Applications | Patreon
2. Créez un webhook pointant vers https://discourse.example.com/patreon/webhook

3. Activez ces déclencheurs :

• Créer un engagement (pledges:create ou members:pledge:create)
• Mettre à jour l’engagement (pledges:update ou members:pledge:update)
• Supprimer l’engagement (pledges:delete ou members:pledge:delete)

4. Copiez le secret du webhook dans votre paramètre de site patreon webhook secret

Restriction de l’accès au site aux supporters Patreon

Pour limiter l’accès au site aux utilisateurs Patreon :

1. Assurez-vous que la connexion Patreon fonctionne
2. Désactivez ces paramètres :

• enable local logins (activer les connexions locales)
• enable local logins via email (activer les connexions locales par e-mail)

Pour restreindre l’accès uniquement à vos supporters Patreon :

1. Configurez les paramètres de sécurité des catégories
2. Liez les catégories aux groupes connectés à Patreon

Dépannage

Activez la journalisation verbeuse en activant le paramètre patreon verbose log. Accédez aux journaux à l’adresse https://discourse.example.com/logs.

Ressources supplémentaires

• Discourse Patreon
• Comprendre les groupes et les autorisations de catégories
• Clés API et clients Patreon