Discourse-Abonnement-Plugin

[Discourse]

	Zusammenfassung	Mit dem Plugin Discourse Subscriptions können Betreiber von Websites wiederkehrende und einmalige Abonnements verkaufen, die den Zugang zu einer Gruppe auf einer Discourse-Instanz gewähren.
	Installationsanleitung	Dieses Plugin ist im Discourse-Kern enthalten. Eine separate Installation des Plugins ist nicht erforderlich.

Da dies ein #offizielles Plugin ist, das vom Discourse-Team gepflegt wird, können Support, Contribute > Bug, Contribute > UX und #contribute:feature-Anfragen in den entsprechenden Kategorien hier auf Meta gestellt und mit dem entsprechenden Plugin-Tag versehen werden. Klicken Sie auf einen der unten stehenden Links, um eine Anfrage zu starten.

Support Fehler UX Funktion

Das Plugin Discourse Subscriptions ermöglicht es Ihnen, einmalige sowie wiederkehrende Abonnements zu erstellen, für die Nutzer bezahlen können, um auf geschützte Inhalte zuzugreifen. Dies kann eine großartige Möglichkeit sein, die Hosting-Kosten Ihrer Community zu finanzieren.

Funktionen

Das Plugin Discourse Subscriptions unterstützt die folgenden Funktionen:

• Erstellen neuer Produkte und Pläne über das Admin-Panel
• Kündigen und Rückerstatten von Abonnements über das Admin-Panel
• Erstellen von einmaligen Kauf- oder wiederkehrenden Abonnement-Plänen
• Kostenlose Testphasen für wiederkehrende Abonnements hinzufügen
• Unterstützung von SCA/3D Secure
• Hinzufügen/Entfernen von Nutzern aus Plan-Gruppen beim Abonnieren/Kündigen
• Abonnement über das Benutzerprofil kündigen
• Kündigung des Abonnements am Ende des Abrechnungszeitraums
• Optionale Unterstützung für Stripe Checkout
• Automatische Berechnung und Erhebung von Umsatzsteuer
• Nutzer können ihre Karte für einzelne Abonnements aktualisieren

Die Schaltfläche „Abonnieren“ in der oberen Navigation führt Sie zur Seite /s, auf der die für Ihre Website konfigurierten Abonnements aufgelistet sind:

Sobald ein Nutzer auf die Schaltfläche „Abonnieren“ für einen bestimmten Plan klickt, wird die Zahlungsseite für diesen Plan geöffnet:

Nachdem ein Nutzer seine Zahlungsdaten und seine Adresse ausgefüllt und auf „Abonnieren“ geklickt hat, wird ihm eine „Vielen Dank!“-Nachricht angezeigt und er wird zu seiner Abrechnungsseite weitergeleitet:

Der Nutzer wird außerdem automatisch einer von Ihnen gewählten Gruppe hinzugefügt, sodass Sie leicht erkennen können, welche Nutzer abonniert haben, und geschützte Inhalte in Kategorien bereitstellen können, die nur diese Gruppe sehen darf.

Begriffe

• Abonnement - Abonnementpläne sind wiederkehrende Zahlungspläne, mit denen Sie den Zugang zu Inhalten in Ihrer Community steuern können. Wenn ein Abonnement erstellt oder gelöscht wird, wird ein Nutzer der Nutzergruppe hinzugefügt oder daraus entfernt, die Sie mit Ihrem Abonnementplan verknüpft haben. Ein Abonnement besteht aus einem Produkt und Plänen.
• Produkt - Ein Produkt ist in den Begriffen von Stripe das, was Sie verkaufen. Ein Produkt kann einen oder mehrere Pläne enthalten.
  • Um Ihrem Produkt eine Beschreibung hinzuzufügen, fügen Sie ein Metadatenfeld mit dem Namen „description“ hinzu und verwenden Sie dieses stattdessen. Sie können Markdown verwenden.
• Plan - Ein Plan enthält einen Preis, einen wiederkehrenden Zyklus und ist mit einer Gruppe verknüpft, auf die Ihre Abonnenten Zugriff erhalten.

Bewahren Sie Ihre Stripe-Private-Schlüssel jederzeit sorgfältig und sicher auf.

Wenn Sie Ihre Discourse-Instanz herunterfahren, dieses Plugin deinstallieren oder Ihre Website offline geht, wird Stripe weiterhin Ihre Kunden für Ihren Service abrechnen, bis das Abonnement gekündigt wird.

Konfiguration

1. Installieren und aktivieren Sie das Plugin
2. Zahlungs-Gateway konfigurieren (Stripe)
3. Webhooks und Ereignisse in Stripe konfigurieren
4. Fügen Sie Ihre Stripe-Schlüssel (public, secret, webhook secret) unter Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions. hinzu
5. Erstellen Sie eine Gruppe für Ihre Abonnenten, der sie durch den Kauf beitreten können
6. Erstellen Sie ein Produkt und einen Plan unter Admin > Plugins > Subscriptions
7. Profitieren Sie davon!

Richten Sie Ihr Zahlungs-Gateway ein.

Zunächst benötigen Sie ein Konto bei dem Zahlungs-Gateway Stripe. Um loszulegen, können Sie ein Konto im Testmodus einrichten und sehen, wie alles funktioniert, ohne echte Transaktionen durchzuführen oder ein Bankkonto einrichten zu müssen. Es gibt keinen Schalter für den Testmodus im Plugin; stellen Sie stattdessen sicher, dass Sie Ihre Entwicklungsschlüssel verwenden (sie beginnen mit pk_test, sk_test).

Richten Sie Webhooks und Ereignisse in Ihrem Stripe-Konto ein

Webhooks sind erforderlich, damit die Kündigung von Abonnements vollständig funktioniert. Stellen Sie sicher, dass diese korrekt konfiguriert sind.

Sobald Sie ein Konto bei Stripe haben, müssen Sie Stripe die Adresse Ihrer Website mitteilen, damit es Sie über bestimmte Transaktionen benachrichtigen kann. Sie können dies in Ihrem Stripe-Dashboard unter Endpoints > URL eingeben.

Webhook-Adresse: [Ihre Serveradresse]/s/hooks – wobei [Ihre Serveradresse] die URL Ihrer Discourse-Installation ist.

Sie müssen Stripe auch mitteilen, über welche Ereignisse es Sie über die Webhook-URL benachrichtigen soll.

Derzeit reagiert Discourse Subscriptions auf die folgenden Ereignisse:

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

Fügen Sie die Stripe-API- und Webhook-Schlüssel zu Ihren Plugin-Einstellungen hinzu

Stripe muss autorisiert sein, mit Ihrer Website zu kommunizieren. Dazu veröffentlicht Stripe ein Paar aus privaten und öffentlichen API-Schlüsseln sowie ein Signing Secret für Ihre Webhooks.

Um Webhooks zu autorisieren, fügen Sie die API-Schlüssel und das Webhook-Secret von Stripe zu Ihren Einstellungen auf der Seite (unter Entwicklern) hinzu.

Das Hinzufügen von Produktionsschlüsseln führt zu echten Zahlungen. Wenn Sie testen möchten, stellen Sie sicher, dass Sie in den Modus View test data wechseln und die Schlüssel pk_test und sk_test unter Entwicklern abrufen.

In Ihren Stripe-Kontoeinstellungen finden Sie:

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

Fügen Sie diese Schlüssel unter den entsprechenden Einstellungen in Admin > Plugins > Installed > Subscriptions > Settings /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions. hinzu.

Richten Sie Ihre Nutzergruppen in Discourse ein

Wenn ein Nutzer erfolgreich ein Abonnement für Ihre Discourse-Anwendung abschließt, nachdem seine Kreditkartentransaktion verarbeitet wurde, wird er einer Nutzergruppe hinzugefügt. Durch die Zuweisung von Nutzern zu einer Nutzergruppe können Sie steuern, auf was Ihre Nutzer auf Ihrer Website zugreifen können. Nutzergruppen sind eine Kernfunktionalität von Discourse, und dieses Plugin führt keine Aktionen mit ihnen durch, außer das Hinzufügen und Entfernen von Nutzern aus der Gruppe, die Sie mit Ihrem Plan verknüpft haben.

Erstellen Sie eines oder mehrere Produkte mit Plänen.

Klicken Sie unter Admin > Plugins > Subscriptions auf „Neues Produkt hinzufügen“. Sobald Sie ein Produkt gespeichert haben, können Sie Pläne hinzufügen. Beachten Sie, dass sich die Preisgestaltung und die Abrechnungsintervalle von Plänen nach ihrer Erstellung nicht ändern lassen. Dies dient der Vermeidung von Verwirrung im Zusammenhang mit dem Abonnement-Management.

Wenn Sie sich Ihr Stripe-Dashboard ansehen, werden Sie feststellen, dass alle diese Produkte und Pläne dort aufgeführt sind. Discourse Subscriptions erstellt sie nicht lokal. Sie werden in Stripe erstellt.

Testen

Testen Sie mit diesen Kreditkartennummern:

• 4242 4242 4242 4242
• 4111 1111 1111 1111 (keine Authentifizierung erforderlich)
• 4000 0027 6000 3184 (Authentifizierung erforderlich)

Weitere Testkartennummern: Test card numbers | Stripe Documentation

Besuchen Sie /s und führen Sie einige Testtransaktionen durch.

Live-Betrieb

Sobald Sie bereit sind, in den Live-Betrieb zu wechseln, ändern Sie Ihre API- und Webhook-Secret-Schlüssel in Produktionsschlüssel. Sie müssen neue Produkte und Pläne im Live-Modus erstellen.

Seien Sie sich bewusst, dass, wenn Sie Stripe-Webhooks nicht ordnungsgemäß konfigurieren und wiederkehrende Zahlungen aus irgendeinem Grund (z. B. abgelaufene Kreditkarte) nicht verarbeitet werden können, Nutzer weiterhin Zugang zur Gruppe haben. Damit Stripe Abonnements automatisch kündigt, stellen Sie sicher, dass Sie Ihre Einstellungen für Fehlgeschlagene Zahlungen verwalten ähnlich wie im unten stehenden Bild konfigurieren und Webhooks wie oben beschrieben einrichten.

Zahlungsdaten aktualisieren

Nutzer können die für einzelne Abonnements verwendete Karte aktualisieren, indem sie die Abrechnungsseite besuchen und auf die Schaltfläche „Bearbeiten“ neben dem Abonnement klicken, wodurch dieser Bildschirm geöffnet wird:

Stripe Checkout mit Stripe Pricing Tables

Sie können sich auch dafür entscheiden, die Produkt- und Checkout-Seiten des Subscription Plugins zu ersetzen und stattdessen Stripe Checkout mit Stripe Pricing Tables zu verwenden.

In Ihrem Stripe-Dashboard:

1. Gehen Sie nach dem Erstellen der Produkte auf Discourse zu Produkte > Produktkatalog
2. Klicken Sie auf das Produkt, das Sie in die Preistabelle aufnehmen möchten
3. Klicken Sie auf Produkt bearbeiten
4. Mehr Optionen und geben Sie Folgendes unter Metadaten ein:
   • Schlüssel: group_name
   • Wert: Der Gruppenname auf Discourse (z. B. trust_level_0)
5. Klicken Sie auf Produkt aktualisieren, um zu speichern

Stellen Sie sicher, dass der Gruppenname mit der Gruppe übereinstimmt, die unter User_Groups auf Discourse ausgewählt ist.

Erstellen Sie Ihre Stripe-Preistabelle

1. Gehen Sie zu Produkte > Preistabellen
2. Erstellen Sie eine neue Tabelle und fügen Sie die soeben erstellten Produkte hinzu
3. Kopieren Sie nach der Veröffentlichung der Tabelle die Preistabellen-ID, die im Einbettungscode enthalten ist (sie beginnt mit prctbl_...)
4. Fügen Sie die Preistabellen-ID in Ihr discourse_subscriptions_pricing_table_id ein und aktivieren Sie die Einstellung für die Abonnements-Preistabelle.
5. Klicken Sie auf die grünen Häkchen, um beide Einstellungen zu speichern.

Empfohlener Schritt:

Beim Einrichten der Preistabelle innerhalb von Stripe wird empfohlen, den Nutzer nach Abschluss des Checkouts auf Ihre Website weiterzuleiten, da er sonst auf einer Stripe-Bestätigungsseite ohne Link zurück zu Ihrer Website verbleibt.

Die Weiterleitung zu https://<your-site>/my/billing/subscriptions ist eine gute Wahl für Abonnements. Für einmalige Zahlungen könnten Sie direkt zu https://<your-site>/my/billing/payments verlinken.

Automatische Steuereintreibung

Um die automatische Steuereintreibung zu aktivieren, aktivieren Sie das Kontrollkästchen für die Site-Einstellung discourse_subscriptions_enable_automatic_tax.

Wenn Sie es aktivieren, aber Ihre Stripe-Instanz nicht ordnungsgemäß für die Steuereintreibung konfiguriert ist, können Nutzer nach Abschluss des Checkout-Prozesses dieses Popup sehen:

Es gibt dieses Handbuch für weitere Informationen, aber es sollte nicht viel zu tun geben, da das Plugin nun den entsprechenden Parameter automatic_tax[enabled]=true übergibt (Schritt 5).

Stellen Sie sicher, dass Sie auch Ihre Registrierungen konfigurieren (Schritt 4):

Hier ist ein Beispiel für eine Discourse Subscription Plugin-Transaktion in Stripe, die zeigt, dass die Steuer automatisch eingezogen wurde:

Einstellungen

Name	Beschreibung
discourse subscriptions enabled	Aktiviert das Discourse Subscriptions Plugin.
discourse subscriptions extra nav subscribe	Zeigt die Abonnement-Schaltfläche in der Hauptnavigation an
discourse subscriptions public key	Stripe Publishable Key
discourse subscriptions secret key	Stripe Secret Key
discourse subscriptions webhook secret	Stripe Webhook Secret
discourse subscriptions currency	Standard-Währungscode. Dies kann bei der Erstellung eines Abonnementplans überschrieben werden.
discourse subscriptions campaign enabled	Aktiviert ein Kampagnenbanner, um die finanzielle Unterstützung dieser Community zu bewerben.
discourse subscriptions campaign goal	Das numerische Ziel Ihrer Unterstützungskampagne (Anzahl der Abonnenten oder gesammelter Betrag).
discourse subscriptions campaign type	Wählt den Typ der durchzuführenden Kampagne aus (Abonnenten oder monatlich gesammelter Betrag).
discourse subscriptions campaign banner location	Wählt die Position des Kampagnenbanners aus (oben oder Seitenleiste).
discourse subscriptions campaign banner bg image	Laden Sie ein benutzerdefiniertes Bild hoch, das als Hintergrund für das Kampagnenbanner verwendet werden soll.
discourse subscriptions campaign banner shadow color	Wählt die Farbe des Schattenwurfs des Kampagnenbanners aus.
discourse subscriptions campaign show contributors	Zeigt die Avatare der neuesten Käufe von Abonnementprodukten an.
discourse subscriptions campaign product	Die Stripe-Produkt-ID, die an Unterstützer gesendet wird, wenn sie auf die Schaltfläche in der Kampagne klicken. Wenn diese Einstellung leer ist, werden Unterstützer zur Hauptseite der Produkte weitergeleitet.
discourse subscriptions campaign grant	Gewährt dem Nutzer einen kostenlosen Monat Abonnements
discourse subscriptions pricing table id	Die Stripe-Preistabellen-ID aus dem Einbettungscode
discourse subscriptions pricing table enabled	Aktiviert die Verwendung der Stripe-Preistabelle und ersetzt die vorhandene Abonnementseite
discourse_subscriptions_enable_automatic_tax	Schaltet um, ob Umsatzsteuer eingezogen wird. Erfordert einige Einstellungen in Stripe.
discourse_subscriptions_enable_verbose_logging	Aktiviert eine ausführlichere Protokollierung zur Fehlerbehebung. Bitte nicht dauerhaft in der Produktion aktiviert lassen.

Von uns gehostet? Dieses Plugin ist in unseren Pro-, Business- und Enterprise-Hosting-Plänen verfügbar Subscriptions | Discourse - Civilized Discussion