Patreon-Integration mit Discourse konfigurieren

[Discourse]

Diese Anleitung erklärt, wie Sie die Patreon-Integration mit Ihrem Discourse-Forum einrichten und konfigurieren, einschließlich Benutzersynchronisierung, Gruppenverwaltung und Zugriffskontrolle.

Erforderliches Benutzerniveau: Administrator

Erfordert die Installation des Discourse Patreon-Plugins

Zusammenfassung

Diese Anleitung behandelt:

• Einrichten der Patreon API-Anmeldeinformationen
• Konfigurieren des Discourse Patreon-Plugins
• Synchronisieren von Patreon-Benutzern mit Discourse-Gruppen
• Verwalten der Patronen-Gruppeneinstellungen
• Einrichten von Webhooks für Echtzeit-Updates
• Beschränken des Site-Zugriffs auf Patreon-Unterstützer

Nur Mitglieder, die ein Abonnement auf einer Stufe abgeschlossen haben, werden mit Discourse-Gruppen synchronisiert. Kostenlose Benutzer und Benutzer mit der 7-tägigen kostenlosen Testversion werden nicht synchronisiert.

Erstellen von Patreon-Anmeldeinformationen

1. Gehen Sie zur Patreon Clients & API Keys Seite
2. Klicken Sie auf „Client erstellen“

3. Füllen Sie das Formular mit diesen Details aus:

• App Name
• Beschreibung
• App-Kategorie
• Autor
• Company Domain: discourse.example.com
• Privacy Policy URL: https://discourse.example.com/privacy
• Terms of Service URL: https://discourse.example.com/tos
• Redirect URIs: https://discourse.example.com/auth/patreon/callback
• Client API Version: Auf 1 setzen

Das Plugin verwendet intern derzeit Patreon API v1 Endpunkte, daher muss die Client API Version auf 1 gesetzt werden. Wenn Sie sie auf 2 setzen, kommt es zu Authentifizierungsfehlern, da v2-only Clients nicht auf v1 Endpunkte zugreifen können. Beachten Sie, dass Patreon angekündigt hat, dass API v1 in Zukunft eingestellt wird.

4. Klicken Sie auf „Client erstellen“
5. Speichern Sie Ihre Anmeldeinformationen für den nächsten Schritt

Konfigurieren des Discourse Plugins

1. Navigieren Sie zu Ihrem Admin → Site Settings Panel
2. Geben Sie Patreon in die Suchleiste ein.
3. Kopieren und fügen Sie Folgendes von Ihrem Patreon Client in Discourse ein:

• patreon client id
• patreon client secret
• patreon creator access token
• patreon creator refresh token

Optionale Einstellungen:

• Aktivieren Sie Spenden-Aufforderungen, indem Sie patreon donation prompt enabled aktivieren und Ihre Kampagnen-URL festlegen
• Aktivieren Sie die Patreon-Anmeldung, indem Sie Ihren patreon creator discourse username festlegen und patreon login enabled aktivieren
• Aktivieren Sie patreon enabled, um das Plugin zu aktivieren

Synchronisieren von Patreon-Daten

1. Besuchen Sie https://discourse.example.com/admin/plugins/patreon
2. Klicken Sie auf „Patreon-Daten aktualisieren & Gruppen synchronisieren“

Eine erfolgreiche Synchronisierung zeigt eine Bestätigungsnachricht an:

Verknüpfen von Patreon-Stufen mit Discourse-Gruppen

1. Wählen Sie eine Discourse-Gruppe aus dem Gruppen-Dropdown-Menü aus
2. Wählen Sie eine Patreon-Belohnungsstufe aus dem Rewards-Dropdown-Menü aus
3. Klicken Sie auf das Speichern-Symbol

Klicken Sie nach dem Verknüpfen der Gruppen erneut auf „Patreon-Daten aktualisieren & Gruppen synchronisieren“, um vorhandene Benutzer zu synchronisieren.

Patronen-Gruppenanpassung

Die Standard-Patronen-Gruppe enthält:

• Avatar-Flair
• Patronen-Abzeichen

Um diese anzupassen:

1. Besuchen Sie die Patronen-Gruppenseite
2. Klicken Sie auf die Registerkarte „Verwalten“
3. Passen Sie Flair- und Gruppenbeschreibungseinstellungen an

Einrichten von Webhooks (optional)

Um eine Echtzeitsynchronisierung zu aktivieren:

1. Besuchen Sie Plattform | Anwendungen | Patreon
2. Erstellen Sie einen Webhook, der auf https://discourse.example.com/patreon/webhook verweist

3. Aktivieren Sie diese Auslöser:

• Pledge erstellen (pledges:create oder members:pledge:create)
• Pledge aktualisieren (pledges:update oder members:pledge:update)
• Pledge löschen (pledges:delete oder members:pledge:delete)

4. Kopieren Sie das Webhook-Geheimnis in Ihre Website-Einstellung patreon webhook secret

Einschränken des Site-Zugriffs auf Patreon-Unterstützer

Um den Site-Zugriff auf Patreon-Benutzer zu beschränken:

1. Stellen Sie sicher, dass die Patreon-Anmeldung funktioniert
2. Deaktivieren Sie diese Einstellungen:

• enable local logins
• enable local logins via email

Um den Zugriff nur auf Ihre Patreon-Unterstützer zu beschränken:

1. Konfigurieren Sie die Sicherheitseinstellungen für Kategorien
2. Verknüpfen Sie Kategorien mit Patreon-verknüpften Gruppen

Fehlerbehebung

Aktivieren Sie die ausführliche Protokollierung, indem Sie die Einstellung patreon verbose log aktivieren. Greifen Sie auf Protokolle unter https://discourse.example.com/logs zu.

Zusätzliche Ressourcen

• Discourse Patreon
• Verständnis von Gruppen und Kategorieberechtigungen
• Patreon Clients & API Keys