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 uniques qui donnent accès à un groupe sur une instance Discourse.
	Guide d’installation	Ce plugin est intégré au noyau de Discourse. Il n’est pas nécessaire d’installer le plugin séparément.

Comme il s’agit d’un plugin official maintenu par l’équipe Discourse, les demandes de Support, Contribute > Bug, Contribute > UX et Contribute > Feature peuvent être faites dans les catégories respectives sur Meta, et taguées avec le tag de plugin approprié. 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 uniques ainsi que des abonnements récurrents que les utilisateurs peuvent payer pour accéder à du contenu restreint. 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’achat unique ou d’abonnement récurrent
• Ajouter des périodes d’essai gratuites aux abonnements récurrents
• Prise en charge de SCA/3D Secure
• Ajouter/supprimer des utilisateurs des groupes de plans lors de l’abonnement/annulation
• Annuler l’abonnement depuis le profil utilisateur
• Annulation de l’abonnement à la fin de la période d’abonnement
• Support optionnel pour Stripe Checkout
• Calcul et collecte automatiques de la taxe de vente
• Les utilisateurs peuvent mettre à jour leur carte pour des abonnements individuels

Le bouton « S’abonner » situé dans la navigation supérieure vous dirigera vers la page d’abonnement /s où sont listés les abonnements que vous avez configurés pour votre site :

Une fois qu’un utilisateur clique sur le bouton « S’abonner » pour 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 et cliqué sur « S’abonner », il voit un message « Merci ! » et 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 et fournir du contenu restreint dans des catégories visibles uniquement par ce groupe.

Termes

• Abonnement - Les abonnements sont un plan de paiement récurrent qui vous permet 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 que vous associez à 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 le Markdown.
• Plan - Un plan contient un prix, un cycle de facturation récurrent, et est associé à un groupe auquel vos abonnés obtiennent accès.

Soyez très prudent et gardez 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. Installez et activez le plugin
2. Configurez la passerelle de paiement (Stripe)
3. Configurez les Webhooks et Événements dans Stripe
4. Ajoutez vos clés Stripe (publique, secrète, secret du webhook) sous Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Créez un groupe pour vos abonnés via l’achat
6. Créez un produit et un plan sous Admin > Plugins > Subscriptions
7. Profit !

Configurez 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 transactions réelles ou sans 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 développeur (elles commencent par pk_test, sk_test)

Configurez les Webhooks et Événements dans votre compte Stripe

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

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 ceci 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

Ajoutez les clés API et Webhook 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 et un secret de signature pour vos webhooks.

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

L’ajout de clés de production entraînera des paiements en direct. Si vous prévoyez de tester, assurez-vous de passer en mode View test data et d’obtenir les 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 > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Configurez vos groupes d’utilisateurs dans Discourse

Lorsqu’un utilisateur s’abonne avec succès à votre application Discourse, après le traitement de la transaction par carte de crédit, il est ajouté à un groupe d’utilisateurs. En assignant des utilisateurs à un groupe d’utilisateurs, vous pouvez gérer l’accès de vos utilisateurs à votre site web. Les groupes d’utilisateurs sont une fonctionnalité centrale de Discourse et ce plugin ne fait rien d’autre que d’ajouter et de retirer des utilisateurs du groupe que vous avez associé à votre Plan.

Créez un ou plusieurs produits avec des plans.

Sous Admin > Plugins > Subscriptions, cliquez sur ajouter un nouveau Produit. Une fois que vous avez un produit enregistré, 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. Cela est fait 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 listés. Discourse Subscriptions ne les crée pas localement. Ils sont créés dans Stripe.

Test

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.

Mise en production

Une fois que vous êtes prêt à passer en production, changez vos clés API et secret du webhook pour des clés de production. Vous devrez créer de nouveaux produits et plans en mode live.

Soyez conscient que si vous ne configurez pas correctement les webhooks Stripe, et que les paiements récurrents échouent pour une raison quelconque (carte expirée, etc.), les utilisateurs auront toujours accès au groupe. Pour que Stripe annule automatiquement les abonnements, assurez-vous de définir vos paramètres Gérer les paiements échoués similaires à 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 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 ouvrira cet écran :

Stripe Checkout avec les tables de prix Stripe

Vous pouvez également choisir de remplacer les pages de produit et de paiement du plugin Subscription et d’utiliser plutôt Stripe Checkout avec Stripe Pricing Tables.

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 la table de prix
3. Cliquez sur Edit product
4. More Options et entrez 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 sauvegarder

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

Créez votre table de prix Stripe

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

Étape recommandée :

Lors de la configuration de la Pricing Table dans Stripe, il est recommandé de rediriger l’utilisateur vers votre site une fois la commande terminée, sinon ils resteront sur la page de confirmation de Stripe sans lien vers votre site.

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

Collecte automatique de la taxe

Pour activer la collecte automatique de la taxe, cochez la case du paramètre de site 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 paiement :

Il y a 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 de configurer vos enregistrements (étape 4) également :

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	Active le plugin Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Affiche le bouton d’abonnement dans la navigation principale
discourse subscriptions public key	Clé publique Stripe
discourse subscriptions secret key	Clé secrète Stripe
discourse subscriptions webhook secret	Secret du webhook Stripe
discourse subscriptions currency	Code de devise par défaut. Cela peut être écrasé 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 à 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 à lancer (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 comme arrière-plan de la bannière de campagne.
discourse subscriptions campaign banner shadow color	Sélectionnez 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 de la campagne. Si ce paramètre est vide, les supporters seront redirigés vers la page des produits principaux.
discourse subscriptions campaign grant	Accorde à l’utilisateur un mois gratuit d’abonnement
discourse subscriptions pricing table id	L’ID de la table de prix Stripe depuis le code d’intégration
discourse subscriptions pricing table enabled	Active l’utilisation de la table de prix Stripe et remplace la page d’abonnement existante
discourse_subscriptions_enable_automatic_tax	Active ou désactive la collecte de la taxe de vente. 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