WordPress troubleshooting

In this help doc, we describe common problems you may encounter when using the Memberful WordPress Plugin and how to solve them.

In this help doc:

The Memberful plugin isn’t protecting my content

Make sure that your theme and page builder are compatible with Memberful.

My members can’t access my protected content

This is generally caused by a caching issue. Some of the symptoms of a caching issue could include:

A brief explanation on why this happens

As part of the sign-in process, we add the memberful_endpoint query string to the URL, and we'll need to make sure that ANY URL that contains that query string won't get cached.

So in practice, this means that all of these URLs would need to be exempt from caching:

All of these URLs can continue to be cached, though:

We also need to account for trailing slashes and for other query parameters that might be in the URL (such as UTM parameters for analytics or ad tracking), for example:

https://YOURSITE.com/?utm_campaign=ads&memberful_endpoint&utm_source=fb

Because of this, we can't just add a single URL to the cache exception, we need to add a pattern that will match all of the possible URLs containing memberful_endpoint.

How to solve caching issues

The only way to solve any caching issues is to set up a cache exception with this exact criteria:
"Any URL that contains memberful_endpoint anywhere in the URL"

This needs to be set up in all caching systems on your website, including caching plugins you might have installed and caching systems that your hosting provider might have set up for you.

The latter is the most common culprit as you might not even be aware that your hosting provider is caching your website, so you should reach out and ask them if they are.

Here are some instructions on how to set up the cache exception with common hosting providers that apply caching:

Siteground settings

$regex_path_patterns = array(
  '#memberful_endpoint#',
);

Hosting with Bluehost, Dreamhost, GoDaddy, or EasyWP by Namecheap?
We've found that these hosting providers aren't able to set up this type of cache exception. Please contact us.

My member was redirected to a WordPress form

After integrating with Memberful, we recommend that you delete your users from WordPress. (We will recreate the users.) If you don't delete the users, we will ask them to sign in with their existing WordPress credentials via the WordPress form so we can sync their WordPress / Memberful accounts.

We found an existing account

Memberful oauth error

We had a problem signing you in, please try again later or contact the site admin. memberful_oauth_error

If a member reports the error above, it means we couldn't communicate with your WordPress site. Disconnect / reconnect the plugin and then contact us if that doesn’t resolve the issue.

Could not create the Memberful mapping table

Could not create the Memberful mapping table

If you get the error above, it means when you cleaned up your WordPress database, you didn't remove Memberful's mapping table. To resolve this error, manually delete table wp_memberful_mapping from your database (assuming that your database table prefix is wp_) and reactivate the plugin. You can even use a plugin like Garbage Collector to help you track it down. Alternatively, you can ask your hosting provider for help.

Parse error: syntax error, unexpected

Parse error: syntax error, unexpected '?' in /home1/craftmba/public_html/tractionable/wp-content/plugins/memberful-wp/src/shortcodes.php on line 132

If you get the error above, your server is likely using an unsupported version of PHP (the language Wordpress runs on). Our latest plugin update uses a feature that was added to PHP in version 7 (over 4 years ago), and older versions no longer get security updates. For this reason, PHP creators, and Wordpress, consider them "end of life" and unsafe to use.

To resolve this error, ask your hosting provider to update you to a recent version of PHP. This will get the plugin working and secure your site. If this isn't possible, you can manually download an older version of the Memberful plugin. (Version 10.5.2 should work.)

Can't find what you're looking for? We'd love to help! 💪

Send us a message through the orange chat bubble in the lower right corner of the page. You'll hear back within a few hours Monday - Friday. 😀