Patreon WordPress

Description

When a patron pledges, they can then head over to www.yourwordpresssite.com and click your “Unlock with Patreon” button to let the site know they are a patron. When you create content on WordPress you will be given the option to limit it to only paying patrons.

This plugin is maintained by Patreon. For advanced features, you can find additional premium WordPress plugins in this directory.

Read an in-depth review of this free plugin and how to combine Patreon and WordPress part of your membership business on Elegant Themes

FEATURES FOR CREATORS

  • Choose a minimum pledge amount necessary to see a particular post
  • Alternatively, set a minimum pledge amount to see all posts.
  • Set custom HTML that non-patrons see instead of the post, prompting them to become a patron

You can post entirely independently on your WordPress site from your Patreon page. There is no need for WordPress and Patreon posts to correspond to one another in content or in locked status. The choice is up to you as a creator.

Got ideas? Suggest them to the developer community on our Patreon WordPress Ideas Thread

FEATURES FOR PATRONS

  • This plugin adds a “Unlock with Patreon” button to every locked post.
  • “Unlock with Patreon” takes care of everything: whether they’re not yet a patron, need to upgrade their pledge, or already pledging enough, we’ll guide them through the process and back to your content

FEATURES FOR DEVELOPERS

  • Extend this free basic WordPress plugin with your own inter-operable plugins that install side by side.
  • Rapidly develop patron-only WordPress features without initial overhead
  • Immediately usable by existing Patreon creators running this plugin

Learn more in our developer portal.

PRICING

This plugin is provided by Patreon for free.

Install the Patreon WordPress Plugin

  1. Install & activate the plugin
  2. Click on ‘Patreon Settings’ to view the options page. It will look something like the below, copy the ‘Redirect URI‘ into the clip board and keep for the next step.
  3. This plugin requires that you enable “pretty permalinks.” (ie /page-name/ as opposed to ?pid=36). You can do this from the WordPress admin interface, visit Settings > Permalinks and choose any format aside from “Plain.”

Generate API Credentials on Patreon.com

  1. Ensure you are logged into Patreon, using your creator account. When it comes to testing this out you will want to have two Patreon accounts, one that acts as a patron and one being the content creator. The OAuth client needs to be created on your content creating account.
  2. Visit the oAuth client page here and click “Create Client”, fill out the form and add in an image URL for the icon that will appear to users when they are connecting to your website.
  3. Note the field for ‘Redirect URI‘, this should still be in your clipboard from the previous steps – if not copy/paste it exactly as it appears on the WordPress admin Patreon Settings page.
  4. Click the ‘Create Client’ button, and you should now see the new client in the list.
  5. Click the downward facing caret on the right side to expose additional information about the client
  6. You should see something like this

    (The keys in the image are fake, doctored for this screenshot.)

Paste Your Credentials into WordPress

  1. Copy and paste the Client ID and Client Secret from this page into the matching fields on the ‘Patreon Settings’ page.
  2. Copy the Client ID, Client Secret, Access Token, and Refresh Token from the top of this page into the WordPress admin Patreon Settings page.
  3. Hit ‘Update Settings’ at the bottom of the page.
  4. IMPORTANT FINAL STEP: In your WordPress admin ‘Settings’ -> ‘Permalinks’ section, click ‘Save’. This ensures your rewrite rules are flushed.

You should now be up and running with the Patreon WordPress plugin!

Protecting Posts

When editing a post (or a custom post type) you will see a meta box in the right column titled ‘Patreon Level’.

This box contains a text field that lets you specify a minimum contribution level in dollars. This could be $1 or $1.40 or even $10000. This is entirely up to you.

It defaults to $0 even if left empty.

Protecting Videos

It is difficult to protect videos due the intensive bandwidth requirements of hosting video and having to rely on third parties such as Youtube or Vimeo. Youtube allows you to set videos to ‘private’ but Vimeo offers extra controls by only allowing videos to be played on specific domains. Visit this guide to protecting your video content with Vimeo.

Reviews

Does the job as expected. I don’t have anything else to ask for.

The plugin is very functional, and does a great job at locking patreon content. It is kinda limited to work with patreon only so don’t expect to user another method of subscription to work along with this plugin. The instructions of how to install it and make it work are very easy to follow. As far as I’ve seen, the plugin is still on early stages of development so if something goes wrong, you can count with a great, responsive and trustful user support. I totally recommend it for your patreon site.

Doesn’t release on dates

The only reason I bought this is so I can have Patreon only posts until a certain date, and then release them to everyone.

I was trying to get a way from having to do this manually with the Free version. But I still have to do it with the Pro Version.

I hope this gets fixed one day.

Little support for Webcomics

If you’re running a webcomic with the Webcomic plug-in and are hoping to integrate Patreon into it, it’s not there yet. While you can Patreon-lock posts, it does not lock the associated image (as Webcomic images aren’t part of “content”), so you will have to manually lock and unlock that image. The developer is considering adding functionality to cover this, but right now it’s not there.

What’s more, when I do lock the webcomic image, the loading time on the site is EGREGIOUS. It takes so long on a high speed connection to load the comic behind the “Unlock for $1” overlay that I can’t imagine how bad it would be for someone on the other side of the world with poor connection. We’re talking like 10 seconds just to get the main page to load, and it’s about 1-2 seconds without that turned on. For a webcomic, speed is make-or-break and this is absolutely Break.

Documentation is extremely sparse and almost unusable. It’s just an overview of the features with no explanation of how to use them. Are there shortcodes? Functions? Hooks? I have no idea.

Portions of the plugin are poorly labeled (What’s a Patreon Site Sidebar Widget vs a Patreon Author Sidebar Widget? I can’t tell.) and there are missing functionalities that I would expect, such as a shortcode for a Patreon button and support for Custom Post Types in the “append patreon button to posts” setting.

As others have noted, the review nag is frustrating and never goes away. You want my brutally honest opinions? Here you go. This plugin falls completely short of its goals and I am incredibly disappointed that I spent money on it.

Overall, I paid a bunch of money for a pro plugin that does nothing of what I need for the site I’m building. I can only hope it will get better in time. For now, I’m sorely disappointed.

Lose the Nag Bar!

I’m posting this review in the no doubt futile hope that it will somehow get rid of the “please review us” nag bar that — no matter how many times I manually close it — continues to reappear at the top of my admin screen. C’mon.

Works well and simply

All working well, though I feel I’ve given myself even more work to do by implementing this on my website!

Would be great if you could get rid of the annoying message asking you to make this rating!

Practically Malware!!!

I love Patreon and was excited to see a plugin that would add its functionality to my website. But this thing broke my website hard. Right after installation I got a fatal error message and my site was completely nonfunctional. Fatal error: Call to undefined function openssl_random_pseudo_bytes() in /usr/home/www/wp-content/plugins/patreon-connect/classes/patreon_routing.php on line 67.

So I had to call my sysadmin. And once he got the fatal error fixed, we discovered that none of my site images worked anymore. After hours of troubleshooting, we figured out that this terrible plugin added an entry to the web site’s root-level .htaccess that broke all images on the site. It didn’t remove that entry when I uninstalled the plugin, and it did NOT provide a warning that I’d need to remove that entry myself.

This plugin does for WordPress sites what methanol does for whiskey.

Read all 16 reviews

Contributors & Developers

“Patreon WordPress” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Patreon WordPress” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.2

  • Functionality for using Patreon API v2 added
  • API class uses v2 if v2 credentials are saved in settings-overview
  • Content drip locking options added to post interface when API v2 is being used
  • Content drip locking logic added to protectContentFromUsers function for when API v2 is being used
  • Now can easily switch in between API v1 and API v2 by just changing API credentials in settings-overview
  • Code to handle any connection errors added to API class
  • Connection errors are now shown in frontend so users wont get confused
  • GDPR privacy policy addendum via using WP 4.9.6’s new privacy policy helper page
  • GDPR admin notice and plugin settings page infobox added
  • Links to GDPR tutorial at Patreon Zendesk added
  • readfile in image protection functions replaced with echo file_get_contents to make protected images load faster
  • Undefined var notice fixes for API v2 functions

1.1.1

  • Option to turn image locking function on/off
  • Image locking function defaults to off
  • Nginx compatibility for image locking function
  • Protocol fix for locked images – no longer http/https confusion
  • Filterable utm parameters for login and flow links
  • More reliable way to update htaccess with image locking rules
  • Refresh htaccess rules when image feature turned on/offers
  • Locked posts are protected in RSS feeds
  • Transitional option to disable image feature on update
  • Notice about new image locking option and info for image locking feature
  • Additional messages after login/unlock flow redirection landing

1.1.0

  • Image locking functionality added
  • Users are now able to designate a different pledge level for any image and lock them
  • Locked images wont be visible when their direct link is used – which also prevents hotlinking of these images
  • Clicking on a locked image sends user to the pledge flow at Patreon with appropriate pledge level
  • Easy to notice and use image lock icon which appears when an image is clicked in post editor while in visual mode
  • Easy to use jQuery modal pledge level interface to lock image while editing a post
  • Images can also be locked from media library by setting a pledge level
  • Plugin now blurs the original image, and adds an unlock interface to make a locked image placeholder and caches them for performance
  • Cached placeholder images are refreshed every time pledge level for an image is updated
  • Image unlock links are made cacheable to allow sites using cache to work with locked images without problems
  • Front-end jQuery code to only catch clicks on images locked for the current user and send them to pledge flow
  • Plugin now imports emails of Patreon users who has their email verified at Patreon
  • Login button added to register form
  • User agent string added to API contacting function to identify the plugin
  • Various information like user’s logged in state at Patreon, pledge level and various pledge parameters of user are now cached for any given page load. This will prevent contacting API more than once during a page load and help speed up operations – especially post listings

1.0.2

  • Page protection added
  • New logic to make cacheable unlock links
  • New logic to make cacheable login links
  • Login button shortcode added
  • State var urlencoded when going to Patreon and urlencoded when back
  • Button width fix
  • Login button now appears in login form
  • User creation logic now uses Patreon-supplied names for WP display name/
  • Support link updated in plugin admin

1.0.1

  • API endpoint protocol fix – http to https
  • Added !important to button width and height to prevent themes from overriding them

1.0

  • Plugin launched.