Discourse/discourse
Discourse/discourse
0
0
Fork 0
mirror of https://github.com/discourse/discourse.git synced 2026-08-05 22:42:07 +08:00
Code Packages Activity Actions
discourse/plugins/discourse-patreon
History
Exact
Kris 87bd7db261
 DEV: modernize admin nav, fix unconfigured state (#42182) 
Previously enabling the Patreon plugin and clicking its sidebar link
gave you an "Error loading route" whenever the Patreon connection was
not configured.

This change moves the plugin off the legacy admin route pattern and adds
an empty state linking to its settings so an unconfigured Patreon
explains why instead of failing.

Before:
<img width="700" alt="image"
src="https://github.com/user-attachments/assets/90cc16c5-e3be-4b4a-8e59-87ce8c27875d"
/>

After: 
<img width="900" alt="image"
src="https://github.com/user-attachments/assets/5865d330-1020-4b05-aff9-799a51e62c13"
/>
2026-07-30 14:41:04 -04:00
..
admin/assets/javascripts/discourse DEV: modernize admin nav, fix unconfigured state (#42182) 2026-07-30 14:41:04 -04:00
app DEV: modernize admin nav, fix unconfigured state (#42182) 2026-07-30 14:41:04 -04:00
assets DEV: modernize admin nav, fix unconfigured state (#42182) 2026-07-30 14:41:04 -04:00
config DEV: modernize admin nav, fix unconfigured state (#42182) 2026-07-30 14:41:04 -04:00
db/migrate
lib DEV: Enable Rails/FilePath rubocop rule (#40097) 2026-05-19 19:07:54 +02:00
public/images
spec DEV: modernize admin nav, fix unconfigured state (#42182) 2026-07-30 14:41:04 -04:00
svg-icons
package.json DEV: Add a script for generating external types in discourse-types (#37095) 2026-03-09 20:37:43 +01:00
plugin.rb DEV: modernize admin nav, fix unconfigured state (#42182) 2026-07-30 14:41:04 -04:00
README.md
tsconfig.json DEV: Add a script for generating external types in discourse-types (#37095) 2026-03-09 20:37:43 +01:00

README.md

Discourse Patreon

Enable syncronization between Discourse Groups and Patreon rewards, and enable Patreon Social Login,

Installation

Proceed with a normal installation of a plugin.

After Installation

You need to fill the following fields on Settings -> Plugins:

  • Client ID
  • Client Secret
  • Creator's Access Token
  • Creator's Refesh Token

To get those values you must have a Creator account first.

Then go to Clients & API Keys and fill the necessary info.

The Redirect URIs must be http://<DISCOURSE BASE URL>/auth/patreon/callback, like https://meta.discourse.org/auth/patreon/callback for example.

Then you use the generated tokens to configure the plugin.

Webhooks

You should create Patreon Webhooks so every new pledge get's synced to Discourse ASAP.

To get it working, create a new Webhook for each trigger type and point then to https://<DISCOURSE BASE URL>/patreon/webhook, like https://meta.discourse.org/patreon/webhook for example.

Group Sync

If you want to give your patrons a special treatment on your board, you can create rules between Discourse Groups and Patreon reward tiers.

This can pave the way to grant category access, titles and custom css to please your patrons!

Social Login

This plugin will also enable a Social Login with Patreon, making it easier for your patron to sign up on Discourse.

About

This is a work in progress! Feel free to use and ask questions here, or on Meta.

TODO

  • Button to invite patrons who aren't on Discourse yet.