How it Works

After activating the plugin, a new custom role will be added for each membership level on your site. The custom roles will be set to have a display_name as the membership level’s name and the role as pmpro_role_x, where x is the membership level’s ID.

Custom role capabilities are equivalent to WordPress subscriber role capabilities. You can adjust the role’s capabilities using the pmpro_roles_default_caps filter in a custom function. For more information on WordPress Roles and Capabilities, see this article from WordPress.org.

You can also use a plugin like User Role Editor to add or remove custom capabilities via a settings page in the WordPress dashboard. Below is a screenshot of editing a custom role created with this Add On within the User Role Editor settings page.

Editing a Role in the User Role Editor Plugin

The plugin will immediately create a new role for every existing or newly added membership level.

If you no longer want to use this plugin, click the “Delete and Deactivate” link in the plugin’s action links on the Plugins page in the WordPress dashboard. This will update all users with a custom membership role and set their “role” back to the WordPress “subscriber” default.

This plugin currently requires Paid Memberships Pro.

Based on the original PMPro Roles plugin by Josh Levinson in 2013.


Video Demo


Installation

  1. PMPro Plus members can install the add on via the Memberships > Add Ons admin page.
  2. Or, download the plugin file and upload the ‘pmpro-roles’ directory to the ‘/wp-content/plugins/’ directory of your site.
  3. Activate the plugin through the ‘Plugins’ menu in WordPress.
  4. That’s it. No settings.