Skip to main content
Memberful’s WordPress plugin allows you to restrict access to an entire post or page through its Restrict Access meta box. If you want to protect certain elements or sections of your theme, you can use our Wordpress functions inside your theme. We also offer WordPress functions for displaying profile information and links to Memberful benefits in your WordPress theme. In this help article, you’ll learn several functions that you can use in your WordPress themes or plugins to check member permissions, show profile information, or link to member benefits.

​
Find the necessary slug or ID

Most of these functions require you to provide the slug of a plan or download, or the ID of a podcast. To find the slug for a plan, go to Revenue → All plans and click the plan you want to find the slug for. The slug is shown in the summary section to the right.
Finding a plan's slug
The slug for a download can be found in the list of downloads under Content → Downloads.
Finding a download's slug in the downloads list
You can also find it at the bottom of the page when editing a download.
Finding a download's slug in the download editor
Renaming a plan or a download will modify its slug, but the old slug will continue to work in WordPress functions. Feel free to rename your plans and downloads anytime, knowing that your existing functions will not break.
The ID for a podcast can be found in the URL while editing the podcast. It’s the numeric segment of this URL: 
  ACCOUNT-URL.memberful.com/admin/feeds/63010/edit

​
Check member permissions

We’ve included three functions for checking if the current signed-in user is subscribed to plans, owns downloads, or has access to podcast feeds. Use them in your WordPress theme’s template files:
  • is_subscribed_to_memberful_plan( $slug )
  • has_memberful_download( $slug )
  • has_memberful_feed( $id )
If you pass either of the functions an array of slugs (or IDs in the case of feeds/podcasts), the function will return true if the member owns any of the downloads or podcast feeds, or is subscribed to at least one of the plans. You can also check if the given user has an active subscription to any plan by using the function is_subscribed_to_any_memberful_plan($user_id).

​
Basic example

Require a subscription to the Big Awesome plan: 
<?php if ( is_subscribed_to_memberful_plan( '154-big-awesome' ) ) : ?>

  Shown only to members with a subscription to the Big Awesome plan.

<?php endif; ?>

​
Multiple plans

Require a subscription to at least one of the listed plans: 
<?php if ( is_subscribed_to_memberful_plan( array( '27-super-rad', '59-rock-on', '99-chill-out' ) ) ) : ?>

  Shown to members with the Super Rad plan **OR** the Rock On plan **OR** the Chill Out plan.

<?php endif; ?>

​
Any plan

Require a subscription to any plan. This function accepts any valid user ID, but you’ll typically want to use the current signed-in user, so we’ll get their user ID first. 
<?php 
$user_id = wp_get_current_user()->ID;

if ( is_subscribed_to_any_memberful_plan( $user_id ) ) : ?>

  Shown to members subscribed to **any** plan.

<?php endif; ?>

​
Plan or download

Require a subscription to the Big Awesome plan or require the Super Rad download. 
<?php if ( is_subscribed_to_memberful_plan( '154-big-awesome' ) || has_memberful_download( '27-super-rad' ) ) : ?>

  Shown only to members with a subscription to the Big Awesome plan or the Super Rad download.

<?php endif; ?>

​
Check against a different member / WordPress user

These functions check against the current (signed in) member / WordPress user by default. To specify a different member / WordPress user, pass the function an optional WordPress user ID argument: 
<?php if ( is_subscribed_to_memberful_plan( array( '27-super-rad', '59-rock-on' ), $user_id ) ) : ?>

  Shown if $user_id is subscribed to the Super Rad or Rock On plans.

<?php endif; ?>

​
Check if a user has access to a post based on the Restrict Access tool

Configure access to your posts with the Restrict Access metabox and use memberful_can_user_access_post() to check if a user has access to a post or not: 
<?php 
$user_id = wp_get_current_user()->ID;

if ( memberful_can_user_access_post( $user_id, $post->ID) ) : ?>

  Shown to members that have access based on the Restrict Access Tool.

<?php else : ?>

  Shown to others.

<?php endif; ?>
You only need to do this if you want to show users some custom content (e.g. content from custom fields).If you just need to protect content in the default WordPress content area (the_content() in your theme), the Restrict Access tool will be sufficient and you won’t need to use this function.

​
Check which plans a user is subscribed to

The memberful_wp_user_plans_subscribed_to function returns the member’s subscriptions as an array. 
$subscriptions = memberful_wp_user_plans_subscribed_to( $user_id );
Each subscription in the array contains the following keys:
  • id (this refers to the plan’s ID)
  • autorenew
  • activated_at
  • expires_at
  • in_trial_period
  • trial_start_at
  • trial_end_at

​
Add a custom function that checks if a member is on a trial

We can leverage the memberful_wp_user_plans_subscribed_to function to create a custom function that checks if a member is currently on a trial for any of their subscriptions. Add the following custom function to your functions.php file: 
function is_on_trial() {
  if ( ! function_exists( "memberful_wp_user_plans_subscribed_to" ) ) {
    return false;
  }

  $user_id = wp_get_current_user()->ID;
  $subscriptions = memberful_wp_user_plans_subscribed_to($user_id);

  if( empty( $subscriptions ) ) {
    return false;
  }

  foreach( $subscriptions as $subscription ) {
    if ( $subscription["in_trial_period"] ) {
      return true;
    }
  }
  return false;
}
Now is_on_trial() will return true if the member is on a trial (for any subscription).

​
Show profile information in WordPress themes

We’ve included a few functions for adding profile information to your theme template files:
  • memberful_account_url
  • memberful_sign_in_url
  • memberful_sign_out_url
Here’s an example of using these functions to generate a profile box: 
<?php if ( is_user_logged_in() ) : ?>

  <div class="profile-box signed-in">

    <a class="profile" href="<?php echo memberful_account_url(); ?>">

      <?php echo get_avatar( wp_get_current_user()->user_email, 48 ); ?>

      <?php echo wp_get_current_user()->display_name; ?>

    </a>

    <a class="sign-out" href="<?php echo memberful_sign_out_url(); ?>">Sign out</a>

  </div>

<?php else : ?>

  <div class="profile-box signed-out">

    Already a customer? Please <a title="Sign in" href="<?php echo memberful_sign_in_url(); ?>">sign in</a>.

  </div>

<?php endif; ?>
You can use the memberful_account_get_download_url($slug) function to link to a download. The parameter to this function must be the slug of the download you’re linking to. 
<a href="<?php echo memberful_account_get_download_url( '24-my-download' ); ?>">Download my ebook!</a>
If you’re using the private podcasts feature inside Memberful, you can use the memberful_wp_feed_url($id) function to link to a member’s unique RSS feed. The parameter to this function must be the ID of the podcast you’re linking to. If the member doesn’t have access to the given podcast, it returns null, so we should check for that before rendering the link. 
  <?php
  $url = memberful_wp_feed_url('24');

  if ($url) {
    echo '<a href="' . esc_url($url) . '">Subscribe to the podcast!</a>';
  }
  ?>
If you’ve turned on private RSS feeds, you can share a link to the member’s private RSS feed using this function: 
<?php memberful_private_rss_feed_link( "Your RSS feed", "You don't have access." ); ?>