Discourse Patreon Installation
First of all you need a working Discourse install with our official Patreon plugin.
During all the guide, swap
https://forum.example.comwith your forum domain.
Getting your Patreon Credentials
You can visit the Patreon Client & API Keys page and fill all the required fields. Use
https://forum.example.com/auth/patreon/callback as the Redirect URIs.
If everything is successful you will receive a Client ID, a Client Secret and 2 tokens:
https://forum.example.com/admin/site_settings/category/plugins?filter=patreon and enable and fill all the settings.
- Note that you must fill
Patreon creator discourse usernameonly if you are using Patreon creator account to login in Discourse through “Login with Patreon” feature. In that case it is the value of local Discourse account username. Else you can skip it.
It is needed because
Patreon creator access tokenwill be changed whenever you login.
- Continuing this guide you will also find the
Patreon webhook secret
Running the first sync
Now that everything is set up, go to
https://forum.example.com/admin/plugins/patreon and you will get a screen like this:
Let’s click on the Update Patreon Data button so we get the first batch of data from Patreon. You will never need to do this again, because the plugin runs 4 times a day in the background for you.
Clicking on the button starts a process that takes a little while (usually 30 seconds) and if everything works out you will get a message like this:
After clicking OK you will refresh the page, but now all your Patreon data will be avaliable.
You can select the automatically created patrons group on the left and $0 - All Patrons on the right and after that click on the save button. Now click on the Sync Groups button again.
Now, every Patreon has a group membership on the patrons group of you forum. This includes a group flair and a badge too!
Edit the badge and the group description with links to your Patreon page so it’s easier for new members to discover how to achieve then.
If you want to react faster to new Patrons, changes in tier and stuff like that, you can trigger a new sync between Discourse and Patreon on every change
The result will be similar to this:
If necessary, switch to Off the triggers that do not interest you, then click on Send test to see this window
Click again on Send test
If the test fails you will see
Status code: 403 (you will have to double check the configuration)
If the test is passed you will see
Status code: 200.
Copy the webhook secret and paste it in