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
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.
The plugin will immediately create a new role for every existing or newly added membership level.
- New members will have their role set after completing checkout.
- Existing members will keep their previous role. You will need to perform a custom database query to bulk update the roles for existing members, if desired.
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.
- PMPro Plus members can install the add on via the Memberships > Add Ons admin page.
- Or, download the plugin file and upload the ‘pmpro-roles’ directory to the ‘/wp-content/plugins/’ directory of your site.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- That’s it. No settings.