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.com with 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.
Click on Create Client. If everything is successful you will receive 4 tokens:
Creator’s Access Token
Creator’s Refresh Token
Save this token because you will need those later.
https://forum.example.com/admin/site_settings/category/plugins?filter=patreon and enable and fill all the settings.
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
To do that first visit Patreon WebHooks Page and create a new webhook for each Trigger all pointing to https://forum.example.com/patreon/webhook.