Plugin d'abonnements Discourse

[Discourse]

	Résumé	Le plugin Discourse Subscriptions permet aux propriétaires de sites de vendre des abonnements récurrents et des achats uniques qui accordent l’accès à un groupe sur une instance Discourse.
	Guide d’installation	Ce plugin est inclus dans le noyau de Discourse. Aucune installation séparée du plugin n’est nécessaire.

Étant donné qu’il s’agit d’un plugin #officiel maintenu par l’équipe Discourse, les demandes de Support, de rapport de bug, d’amélioration de l’expérience utilisateur (ux) et de nouvelle fonctionnalité (#feature) peuvent être formulées dans les catégories respectives sur Meta, en les étiquetant avec le tag approprié du plugin. Cliquez sur un lien ci-dessous pour en démarrer un.

Support Bug UX Fonctionnalité

Le plugin Discourse Subscriptions vous permet de créer des abonnements uniques ainsi que récurrents que les utilisateurs peuvent payer pour accéder à du contenu restreint. Cela peut être un excellent moyen de financer les coûts d’hébergement de votre communauté.

Fonctionnalités

Le plugin Discourse Subscriptions prend en charge les fonctionnalités suivantes :

• Créer de nouveaux produits et plans depuis le panneau d’administration
• Annuler et rembourser des abonnements depuis le panneau d’administration
• Créer des plans d’achat unique ou des abonnements récurrents
• Ajouter des périodes d’essai gratuites aux abonnements récurrents
• Prise en charge de la SCA/3D Secure
• Ajouter/supprimer des utilisateurs des groupes de plans lors de l’abonnement/annulation
• Annuler un abonnement depuis le profil de l’utilisateur
• Annulation de l’abonnement à la fin de la période d’abonnement
• Support optionnel pour Stripe Checkout
• Calcul et collecte automatiques des taxes de vente
• Les utilisateurs peuvent mettre à jour leur carte pour des abonnements individuels

Le bouton « S’abonner » situé dans la barre de navigation supérieure vous mènera à la page d’abonnement /s, où sont répertoriés les abonnements que vous avez configurés pour votre site :

Une fois qu’un utilisateur clique sur le bouton « S’abonner » d’un plan spécifique, la page de paiement pour ce plan s’ouvre :

Après qu’un utilisateur a rempli ses informations de paiement et son adresse, puis cliqué sur « S’abonner », un message « Merci ! » s’affiche et il est redirigé vers sa page de facturation :

L’utilisateur est également automatiquement ajouté à un groupe de votre choix, ce qui vous permet de voir facilement quels utilisateurs se sont abonnés et de fournir du contenu restreint dans des catégories visibles uniquement par ce groupe.

Termes

• Abonnement - Les abonnements sont des plans de paiement récurrents qui vous permettent de contrôler l’accès au contenu de votre communauté. Lorsqu’un abonnement est créé ou supprimé, un utilisateur est ajouté ou retiré du groupe d’utilisateurs associé à votre plan d’abonnement. Un abonnement est composé d’un produit et de plans.
• Produit - Dans les termes de Stripe, un produit est ce que vous vendez. Un produit peut contenir un ou plusieurs plans.
  • Pour ajouter une description à votre produit, ajoutez un champ de métadonnées nommé « description » et utilisez celui-ci à la place. Vous pouvez utiliser Markdown.
• Plan - Un plan contient un prix, un cycle récurrent et est associé à un groupe auquel vos abonnés ont accès.

Soyez très prudent pour garder vos clés privées Stripe en sécurité en tout temps.

Si vous arrêtez votre instance Discourse, désinstallez ce plugin ou si votre site devient hors ligne, Stripe continuera de facturer vos clients pour votre service jusqu’à ce que l’abonnement soit annulé.

Configuration

1. Installer et activer le plugin
2. Configurer la passerelle de paiement (Stripe)
3. Configurer les Webhooks et les événements dans Stripe
4. Ajouter vos clés Stripe (publique, secrète, secret webhook) sous Admin > Plugins > Installés > Abonnements > Paramètres /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Créer un groupe auquel vos abonnés peuvent rejoindre via un achat
6. Créer un produit et un plan sous Admin > Plugins > Abonnements
7. Profit !

Configurer votre passerelle de paiement.

Tout d’abord, vous aurez besoin d’un compte auprès de la passerelle de paiement Stripe. Pour commencer, vous pouvez configurer un compte en mode test et voir comment tout fonctionne sans effectuer de vraies transactions ni avoir à configurer un compte bancaire. Il n’y a pas d’interrupteur de mode test dans le plugin ; assurez-vous plutôt d’utiliser vos clés de développement (elles commencent par pk_test, sk_test).

Configurer les Webhooks et les événements dans votre compte Stripe

Les Webhooks sont nécessaires pour que les annulations d’abonnement fonctionnent pleinement. Assurez-vous qu’ils sont correctement configurés.

Une fois que vous avez un compte sur Stripe, vous devrez indiquer à Stripe l’adresse de votre site web afin qu’il puisse vous notifier de certaines transactions. Vous pouvez entrer cela dans votre tableau de bord Stripe sous Endpoints > URL.

Adresse du Webhook : [votre adresse de serveur]/s/hooks – où [votre adresse de serveur] est l’URL de votre installation Discourse.

Vous devrez également indiquer à Stripe quels événements il doit vous notifier via l’URL du webhook.

Actuellement, Discourse Subscriptions répond aux événements suivants :

• customer.subscription.deleted
• customer.subscription.updated
• checkout.session.completed

Ajouter les clés API et Webhook de Stripe aux paramètres de votre plugin

Stripe doit être autorisé à communiquer avec votre site web. Pour ce faire, il publie une paire de clés API privées et publiques ainsi qu’un secret de signature pour vos webhooks.

Pour autoriser les webhooks, ajoutez les clés API et le secret webhook de Stripe à votre page de paramètres (sous Développeurs).

L’ajout de clés de production effectuera des paiements en direct. Si vous prévoyez de tester, assurez-vous de passer en mode Voir les données de test et d’obtenir les clés pk_test et sk_test sous Développeurs.

Dans les paramètres de votre compte Stripe, consultez :

• https://dashboard.stripe.com/apikeys
• https://dashboard.stripe.com/webhooks

Ajoutez ces clés dans les paramètres appropriés sous Admin > Plugins > Installés > Abonnements > Paramètres /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Configurer vos groupes d’utilisateurs dans Discourse

Lorsqu’un utilisateur s’abonne avec succès à votre application Discourse, après le traitement de sa transaction par carte de crédit, il est ajouté à un groupe d’utilisateurs. En attribuant des utilisateurs à un groupe d’utilisateurs, vous pouvez gérer ce à quoi vos utilisateurs ont accès sur votre site web. Les groupes d’utilisateurs sont une fonctionnalité de base de Discourse et ce plugin ne fait rien avec eux, sauf ajouter et supprimer des utilisateurs du groupe que vous avez associé à votre Plan.

Créer un ou plusieurs produits avec des plans.

Sous Admin > Plugins > Abonnements, cliquez sur Ajouter un nouveau Produit. Une fois que vous avez enregistré un produit, vous pouvez y ajouter des plans. Gardez à l’esprit que les prix et les intervalles de facturation des plans ne peuvent pas être modifiés une fois qu’ils sont créés. Cela vise à éviter toute confusion dans la gestion des abonnements.

Si vous regardez votre Tableau de bord Stripe, vous verrez que tous ces produits et plans y sont répertoriés. Discourse Subscriptions ne les crée pas localement. Ils sont créés dans Stripe.

Tests

Testez avec ces numéros de carte de crédit :

• 4242 4242 4242 4242
• 4111 1111 1111 1111 (aucune authentification requise)
• 4000 0027 6000 3184 (authentification requise)

Pour plus de numéros de cartes de test : Test card numbers | Stripe Documentation

Visitez /s et effectuez quelques transactions de test.

Passage en production

Lorsque vous êtes prêt à passer en production, remplacez vos clés API et votre secret webhook par des clés de production. Vous devrez créer de nouveaux produits et plans en mode live.

Sachez que si vous ne configurez pas correctement les webhooks Stripe et que les paiements récurrents échouent pour une raison quelconque (carte de crédit expirée, etc.), les utilisateurs auront toujours accès au groupe. Pour que Stripe annule automatiquement les abonnements, assurez-vous de configurer vos paramètres Gérer les paiements échoués comme sur l’image ci-dessous et de configurer les webhooks comme décrit ci-dessus.

Mise à jour des informations de paiement

Les utilisateurs peuvent mettre à jour la carte utilisée pour des abonnements individuels en visitant la page de facturation et en cliquant sur le bouton Modifier à côté de l’abonnement, ce qui ouvrira cet écran :

Stripe Checkout avec les tableaux de prix Stripe

Vous pouvez également choisir de remplacer les pages de produit et de paiement du plugin d’abonnement et utiliser à la place Stripe Checkout avec les Tableaux de prix Stripe.

Dans votre tableau de bord Stripe :

1. Après avoir créé les produits sur Discourse, allez dans Produits > Catalogue de produits
2. Cliquez sur le produit que vous souhaitez inclure dans le tableau de prix
3. Cliquez sur Modifier le produit
4. Plus d'options et saisissez les éléments suivants sous Métadonnées :
   • Clé : group_name
   • Valeur : Le nom du groupe sur Discourse (par exemple, trust_level_0)
5. Cliquez sur Mettre à jour le produit pour enregistrer

Assurez-vous que le nom du groupe correspond au groupe sélectionné sous User_Groups sur Discourse

Créez votre tableau de prix Stripe

1. Allez dans Produits > Tableaux de prix
2. Créez un nouveau tableau et ajoutez les produits que vous venez de créer
3. Après avoir publié le tableau, copiez l’ID du tableau de prix trouvé dans le code d’intégration (il commence par prctbl_...)
4. Collez l’ID du tableau de prix dans votre discourse_subscriptions_pricing_table_id et activez le paramètre du tableau de prix des abonnements.
5. Cliquez sur les coches vertes pour enregistrer les deux paramètres.

Étape recommandée :

Lors de la configuration du Tableau de prix dans Stripe, il est recommandé de rediriger l’utilisateur vers votre site une fois le paiement terminé, sinon il restera sur une page de confirmation Stripe sans lien vers votre site.

Rediriger vers https://<votre-site>/my/billing/subscriptions est un bon choix pour les abonnements. Pour des paiements ponctuels, vous pourriez lier directement à https://<votre-site>/my/billing/payments.

Collecte automatique des taxes

Pour activer la collecte automatique des taxes, cochez la case du paramètre du site pour discourse_subscriptions_enable_automatic_tax.

Si vous l’activez, mais que vous n’avez pas correctement configuré votre instance Stripe pour collecter les taxes, les utilisateurs pourraient voir cette fenêtre contextuelle après avoir terminé le processus de paiement :

Il existe ce guide pour plus d’informations, mais il ne devrait pas y avoir grand-chose à faire puisque le plugin transmet désormais le paramètre approprié automatic_tax[enabled]=true (étape 5).

Assurez-vous également de configurer vos inscriptions (étape 4) :

Voici un exemple de transaction du plugin Discourse Subscription dans Stripe montrant que la taxe a été collectée automatiquement :

Paramètres

Nom	Description
discourse subscriptions enabled	Activer le plugin Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Afficher le bouton S’abonner dans la navigation principale
discourse subscriptions public key	Clé publique Stripe
discourse subscriptions secret key	Clé secrète Stripe
discourse subscriptions webhook secret	Secret webhook Stripe
discourse subscriptions currency	Code de devise par défaut. Cela peut être remplacé lors de la création d’un plan d’abonnement.
discourse subscriptions campaign enabled	Active une bannière de campagne pour promouvoir le soutien financier de cette communauté.
discourse subscriptions campaign goal	L’objectif numérique de votre campagne de soutien (abonnés ou montant recueilli).
discourse subscriptions campaign type	Sélectionne le type de campagne à lancer (abonnés ou montant mensuel recueilli).
discourse subscriptions campaign banner location	Sélectionne l’emplacement de la bannière de campagne (haut ou barre latérale).
discourse subscriptions campaign banner bg image	Téléchargez une image personnalisée à utiliser comme arrière-plan de la bannière de campagne.
discourse subscriptions campaign banner shadow color	Sélectionne la couleur de l’ombre portée de la bannière de campagne.
discourse subscriptions campaign show contributors	Afficher les avatars des achats les plus récents de produits d’abonnement.
discourse subscriptions campaign product	L’ID de produit Stripe à envoyer aux supporters lorsqu’ils cliquent sur le bouton de la campagne. Si ce paramètre est vide, les supporters seront redirigés vers la page principale des produits.
discourse subscriptions campaign grant	Accorde à l’utilisateur un mois d’abonnement gratuit
discourse subscriptions pricing table id	L’ID du tableau de prix Stripe issu du code d’intégration
discourse subscriptions pricing table enabled	Active l’utilisation du tableau de prix Stripe et remplace la page d’abonnement existante
discourse_subscriptions_enable_automatic_tax	Bascule si la taxe de vente sera collectée. Nécessite une configuration dans Stripe.
discourse_subscriptions_enable_verbose_logging	Active une journalisation plus détaillée pour aider au débogage. Veuillez ne pas laisser activé en permanence en production.

Hébergé par nous ? Ce plugin est disponible sur nos plans d’hébergement Pro, Business et Enterprise Subscriptions | Discourse - Civilized Discussion