Extension d'abonnement Discourse

[Discourse]

	Résumé	Le plugin Discourse Subscriptions permet aux propriétaires de sites de vendre des abonnements récurrents et des achats ponctuels qui donnent accès à un groupe sur une instance Discourse.
	Guide d’installation	Ce plugin est inclus avec le noyau de Discourse. Il n’est pas nécessaire de l’installer séparément.

Étant donné qu’il s’agit d’un plugin #officiel maintenu par l’équipe Discourse, les demandes de Support, de Contribute > Bug, de Contribute > UX et de Contribute > Feature peuvent être formulées dans les catégories respectives ici sur Meta, et étiquetées avec l’étiquette de plugin appropriée. Cliquez sur un lien ci-dessous pour en créer un.

Support Bug UX Fonctionnalité

Le plugin Discourse Subscriptions vous permet de créer des abonnements ponctuels ainsi que récurrents que les utilisateurs peuvent payer pour accéder à un contenu protégé. C’est 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 les abonnements depuis le panneau d’administration
• Créer des plans d’abonnement ponctuels ou récurrents
• Ajouter des essais gratuits aux abonnements récurrents
• Prise en charge de SCA/3D Secure
• Ajouter/retirer des utilisateurs des groupes de plan lorsqu’ils s’abonnent/annulent
• Annuler un abonnement depuis le profil utilisateur
• Annulation de l’abonnement à la fin de la période d’abonnement
• Support optionnel de Stripe Checkout
• Calcul et collecte automatiques de la taxe sur les ventes
• Les utilisateurs peuvent mettre à jour leur carte pour des abonnements individuels

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

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

Après qu’un utilisateur ait rempli ses coordonnées de paiement et son adresse et ait 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 afin que vous puissiez facilement voir quels utilisateurs se sont abonnés, ainsi que fournir un contenu protégé dans des catégories que seul ce groupe peut voir.

Termes

• Abonnement - Les abonnements sont un plan de paiement récurrent qui vous permet de contrôler l’accès au contenu sur 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 - Un produit dans les termes de Stripe 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-le à la place. Vous pouvez utiliser du Markdown.
• Plan - Un plan contient un prix, un cycle récurrent et est associé à un groupe auquel vos abonnés obtiennent l’accès.

Faites très attention à garder vos clés privées Stripe en sécurité à tout moment.

Si vous deviez fermer votre instance de Discourse, désinstaller ce plugin ou si votre site était hors ligne, Stripe continuerait à facturer vos clients pour votre service jusqu’à l’annulation de l’abonnement.

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 de webhook) sous Admin > Plugins > Installés > Subscriptions > Paramètres /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Créer un groupe pour que vos abonnés y rejoignent via l’achat
6. Créer un produit et un plan sous Admin > Plugins > Subscriptions
7. Profitez-en !

Configurer votre passerelle de paiement.

Tout d’abord, vous aurez besoin d’un compte avec la passerelle de paiement Stripe. Pour commencer, vous pouvez configurer un compte en mode test et voir comment tout fonctionne sans effectuer de transactions réelles ni avoir à configurer un compte bancaire. Il n’y a pas de bascule de mode test dans le plugin ; assurez-vous plutôt d’utiliser vos clés de développeur (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 sur certaines transactions. Vous pouvez saisir cela dans votre tableau de bord Stripe sous Endpoints > URL.

Adresse des Webhooks : [votre adresse serveur]/s/hooks – où [votre adresse 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
• checkout.session.async_payment_succeeded

Ajouter les clés API et Webhook de Stripe à vos paramètres de 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 et un secret de signature pour vos webhooks.

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

L’ajout de clés de production effectuera des paiements réels. Si vous prévoyez de tester, assurez-vous de passer en mode View test data et d’obtenir des clés pk_test et sk_test sous Developers.

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

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

Ajoutez ces clés sous les paramètres appropriés dans Admin > Plugins > Installés > Subscriptions > 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 que sa transaction de carte de crédit a été traitée, il est ajouté à un groupe d’utilisateurs. En assignant des utilisateurs à un groupe d’utilisateurs, vous pouvez gérer à 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, à part ajouter et retirer des utilisateurs du groupe que vous avez associé à votre Plan.

Créer un ou plusieurs produits avec des plans.

Sous Admin > Plugins > Subscriptions, cliquez sur ajouter un nouveau Produit. Une fois que vous avez enregistré un produit, vous pouvez lui ajouter des plans. Gardez à l’esprit que les prix et les intervalles de facturation des plans ne peuvent pas être modifiés une fois créés. C’est pour éviter toute confusion autour de la gestion des abonnements.

Si vous jetez un œil à 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 carte de test : Test card numbers | Stripe Documentation

Visitez /s et effectuez quelques transactions de test.

Passage en production

Une fois que vous êtes prêt à passer en production, changez vos clés API et secret de webhook pour 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 de manière similaire à l’image ci-dessous et de configurer les webhooks comme décrit ci-dessus.

Mettre à jour les informations de paiement

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

Stripe Checkout avec les tableaux de prix Stripe

Vous pouvez également choisir de remplacer les pages de produit et de caisse du plugin Subscription et d’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 Products > Product catalog
2. Cliquez sur le produit que vous souhaitez inclure dans le tableau de prix
3. Cliquez sur Edit product
4. More Options et saisissez les éléments suivants sous Metadata :
   • Key : group_name
   • Value : Le nom du groupe sur Discourse (par ex. trust_level_0)
5. Cliquez sur Update product pour enregistrer

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

Créer votre tableau de prix Stripe

1. Allez dans Products > Pricing tables
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 après la fin du checkout, sinon il restera sur une page de confirmation Stripe sans lien vers votre site.

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

Collecte automatique de la taxe

Pour activer la collecte automatique de la taxe, 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 la taxe, les utilisateurs peuvent voir cette fenêtre contextuelle après avoir terminé le processus de caisse :

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

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

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

Paramètres

Nom	Description
discourse subscriptions enabled	Active le plugin Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Affiche 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 de 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 pour votre campagne de soutien (abonnés ou montant collecté).
discourse subscriptions campaign type	Sélectionne le type de campagne à exécuter (abonnés ou montant mensuel collecté).
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 en arrière-plan sur 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	Affiche les avatars des achats les plus récents de produits d’abonnement.
discourse subscriptions campaign product	L’ID du produit Stripe à envoyer aux supporters lorsqu’ils cliquent sur le bouton sur la campagne. Si ce paramètre est vide, les supporters seront dirigé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 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 sur les ventes sera collectée. Nécessite une configuration dans Stripe.
discourse_subscriptions_enable_verbose_logging	Active une journalisation plus détaillée pour faciliter le 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