Discourse-Abonnement-Plugin

[Discourse]

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

Da dies ein #offizielles Plugin ist, das vom Discourse-Team gepflegt wird, können #Support-, #Bug-, #UX- und #Feature-Anfragen in den entsprechenden Kategorien hier im Meta-Forum gestellt und mit dem passenden Plugin-Tag versehen werden. Klicke auf einen der unten stehenden Links, um eine Anfrage zu starten.

Support Bug UX Feature

Das Plugin Discourse Subscriptions ermöglicht es Ihnen, einmalige sowie wiederkehrende Abonnements zu erstellen, für die Benutzer 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 Discourse Subscriptions Plugin unterstützt die folgenden Funktionen:

• Erstellen Sie neue Produkte und Pläne über das Admin-Panel
• Abonnements über das Admin-Panel kündigen und erstatten
• Einmalige Kauf- oder wiederkehrende Abonnementpläne erstellen
• Kostenlose Testphasen für wiederkehrende Abonnements hinzufügen
• Unterstützung für SCA/3D Secure
• Benutzer je nach Abonnement/Kündigung zu Plan-Gruppen hinzufügen/entfernen
• Abonnement im Benutzerprofil kündigen
• Abonnement am Ende der Abonnementperiode kündigen
• Optionale Unterstützung für Stripe Checkout
• Automatische Berechnung und Erhebung von Umsatzsteuer
• Benutzer können ihre Karte für einzelne Abonnements aktualisieren

Der Button „Abonnieren“ in der oberen Navigation führt Sie zur Abonnement-Seite /s, auf der die für Ihre Website konfigurierten Abonnements aufgelistet sind:

Sobald ein Benutzer auf einen der „Abonnieren“-Buttons für einen bestimmten Plan klickt, wird die Zahlungsseite für diesen Plan geöffnet:

Nachdem ein Benutzer 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 Benutzer wird außerdem automatisch einer von Ihnen gewählten Gruppe hinzugefügt, sodass Sie leicht erkennen können, welche Benutzer abonniert haben, und geschützte Inhalte in Kategorien bereitstellen können, die nur diese Gruppe sehen darf.

Begriffe

• Abonnement – Abonnements sind ein wiederkehrender Zahlungsplan, mit dem Sie den Zugang zu Inhalten in Ihrer Community steuern können. Wenn ein Abonnement erstellt oder gelöscht wird, wird ein Benutzer der Benutzergruppe hinzugefügt oder entfernt, die Sie mit Ihrem Abonnementplan verknüpft haben. Ein Abonnement besteht aus einem Produkt und Plänen.
• Produkt – Ein Produkt ist im Sinne 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 Metadaten-Feld mit dem Namen „description“ hinzu und verwenden Sie dieses. 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.

Seien Sie sehr vorsichtig und bewahren Sie Ihre Stripe-Private-Keys jederzeit sicher auf.

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

Konfiguration

1. Installieren & aktivieren Sie das Plugin
2. Zahlungs-Gateway konfigurieren (Stripe)
3. Webhooks & 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
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 beim Stripe Zahlungs-Gateway. 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 Testmodus-Toggle im Plugin; stellen Sie stattdessen sicher, dass Sie Ihre Entwickler-Schlü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 sie 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. Dies können Sie 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 hinzu (unter Entwicklern).

Das Hinzufügen von Produktions-Schlüsseln macht Live-Zahlungen möglich. Wenn Sie testen möchten, stellen Sie sicher, dass Sie in den Modus View test data wechseln und die pk_test- und sk_test-Schlüssel 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 Benutzergruppen in Discourse ein

Wenn ein Benutzer erfolgreich ein Abonnement für Ihre Discourse-Anwendung abschließt, nachdem seine Kreditkartentransaktion verarbeitet wurde, wird er einer Benutzergruppe hinzugefügt. Durch die Zuweisung von Benutzern zu einer Benutzergruppe können Sie steuern, auf welche Inhalte Ihre Benutzer auf Ihrer Website zugreifen können. Benutzergruppen sind eine Kernfunktionalität von Discourse, und dieses Plugin tut nichts damit, außer Benutzer der Gruppe hinzuzufügen oder zu entfernen, 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 soll Verwirrung rund um das Abonnement-Management vermeiden.

Wenn Sie in Ihr Stripe Dashboard schauen, werden Sie sehen, dass all diese Produkte und Pläne dort aufgelistet sind. Discourse Subscriptions erstellt diese nicht lokal. Sie werden in Stripe erstellt.

Testen

Testen Sie mit diesen Kreditkartenummern:

• 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 gehen, ändern Sie Ihre API- und Webhook-Secret-Schlüssel auf Produktions-Schlü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, Benutzer weiterhin Zugang zur Gruppe haben. Um Abonnements von Stripe automatisch kündigen zu lassen, stellen Sie sicher, dass Sie Ihre Einstellungen für Failed Payments verwalten ähnlich wie im unten stehenden Bild konfigurieren und Webhooks wie oben beschrieben konfigurieren.

Zahlungsinfo aktualisieren

Benutzer 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 in 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 in 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 in 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 gefunden wird (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 Subscriptions-Preistabelle.
5. Klicken Sie auf die grünen Häkchen, um beide Einstellungen zu speichern.

Empfohlener Schritt:

Bei der Einrichtung der Preistabelle innerhalb von Stripe wird empfohlen, den Benutzer nach Abschluss des Checkouts auf Ihre Website weiterzuleiten, andernfalls bleibt er auf einer Stripe-Bestätigungsseite ohne Link zurück zu Ihrer Website.

Die Weiterleitung zu https://<ihre-seite>/my/billing/subscriptions ist eine gute Wahl für Abonnements. Für einmalige Zahlungen könnten Sie direkt zu https://<ihre-seite>/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, Ihre Stripe-Instanz jedoch nicht ordnungsgemäß für die Steuereintreibung konfiguriert ist, können Benutzer nach Abschluss des Checkout-Prozesses dieses Popup sehen:

Es gibt diese Anleitung 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 den Abonnement-Button 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ützerkampagne (Abonnenten oder gesammelter Betrag).
discourse subscriptions campaign type	Wählt die Art 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 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 Hauptprodukteite weitergeleitet.
discourse subscriptions campaign grant	Gewährt dem Benutzer 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 werden soll. Erfordert einige Einrichtungsschritte in Stripe.
discourse_subscriptions_enable_verbose_logging	Aktiviert detailliertere 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