SLNWP Role Extension for Paid Memberships Pro

开发者	jainanda
更新时间	2026年11月4日 11:49
PHP版本:	7.4 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

下载

2.1.10 2.1.11

详情介绍:

Members get a WordPress role for each Paid Memberships Pro level, kept up to date automatically. That makes it easier to show or hide content in page builders, using the role conditions most of them already provide. A bulk re-sync brings existing members into line. Requires Paid Memberships Pro, available from paidmembershipspro.com (it is not in the WordPress.org plugin directory). It replaces the official PMPro Roles add-on and fixes these issues with it:

Roles were not being updated when a user changed membership level
Roles were not being removed on cancellation or expiry
The administrator role was being removed when a membership was cancelled

What You Can Do With Roles

Show or hide content in your page builder using role conditions
Cover several levels with one role, so monthly and annual members see the same content
Add new levels without re-editing content: give them an existing role
Use roles in other tools, such as menu visibility and role-based plugin features

Key Features

WordPress Role dropdown on each membership level's settings page
Shared role slugs — multiple levels can map to one role (e.g. Gold Monthly, Gold Quarterly, and Gold Annual all → gold)
Protected roles — administrator, editor, author, contributor, customer, and subscriber are never removed under any circumstances
Admin-safe — users with admin roles get membership roles correctly assigned AND removed without losing their admin role
Conflict detection — warns if the official PMPro Roles add-on is still active
One-click bulk sync — a single "Run Sync Now" button under Memberships → Role Sync fixes all existing users immediately

How It Works Each PMPro membership level has a "WordPress Role" dropdown in its settings. Choose the role you want assigned to members of that level. Multiple levels can share the same role — ideal for sites that offer the same membership tier at different payment frequencies (monthly, quarterly, annually). Roles are automatically synced when:

A user signs up for a membership
A user upgrades or downgrades their level
A membership is cancelled
A membership expires

Protected Roles The following roles are never removed under any circumstances:

administrator
editor
author
contributor
customer (WooCommerce)
subscriber

Note: protecting a role only stops this plugin from removing it — a non-member is still assigned the site's default role (usually subscriber) as normal. Protection just means that role, once held, can never be stripped again afterwards. For the same reason, a protected role can't be chosen as a membership level's role: members would keep it after their membership ended. If a level already uses one, the plugin shows a warning naming that level. You can add additional protected roles via filter: add_filter('pmpro_protected_roles', function($roles) { $roles[] = 'shop_manager'; return $roles; }); Requirements

WordPress 6.5+
PHP 7.4+
Paid Memberships Pro, from paidmembershipspro.com (not in the WordPress.org plugin directory)
The Multiple Memberships Per User add-on is supported (a member's levels are each evaluated independently)
The official PMPro Roles add-on must be deactivated to avoid conflicts

安装:

Upload the slnwp-role-extension-pmpro folder to /wp-content/plugins/
Activate the plugin through the Plugins screen in WordPress
Make sure the official PMPro Roles add-on is deactivated
Go to Memberships → Membership Levels and edit each level to choose its WordPress Role
Go to Memberships → Role Sync and click Run Sync Now to fix all existing users

屏幕截图:

升级注意事项:

2.1.10 First WordPress.org release.

常见问题:

Do I need the official PMPro Roles add-on installed?

No — this plugin is a complete replacement. The official add-on must be deactivated to avoid conflicts. This plugin will show a warning in the admin if it detects the official add-on is still active.

Can multiple membership levels share the same role?

Yes — this is a core feature. If you offer Gold Monthly (Level 1), Gold Quarterly (Level 2), and Gold Annual (Level 3), simply choose the gold role for all three levels. Members will be assigned the gold role regardless of which payment plan they chose.

What happens when a membership is cancelled?

The membership role is removed. If the user has no other active memberships, they are reset to the default WordPress role (usually subscriber). Protected roles such as administrator are never touched.

What happens if a user has both an admin role and a membership?

Both roles are handled correctly. The membership role is assigned and removed as normal, while the admin role is always preserved. This was a key bug in the official add-on that this plugin fixes.

How do I fix existing users whose roles are out of sync?

Go to Memberships → Role Sync and click Run Sync Now. This is safe to run at any time.

How do I add a role to the protected list?

Add a filter to your theme's functions.php: add_filter('pmpro_protected_roles', function($roles) { $roles[] = 'shop_manager'; return $roles; });

What WordPress roles are protected by default?

administrator
editor
author
contributor
customer (WooCommerce)
subscriber

Is subscriber protected, given it's also the fallback role for non-members?

Yes. Protection only blocks removal — a member who loses their last active membership is still reset to the site's default role (usually subscriber) exactly as before. Protecting it just means that once assigned, it can never be stripped again afterwards, the same as every other protected role.

Does this work with WooCommerce?

Yes — the customer role is in the protected list by default so WooCommerce customers are never affected by membership role changes.

更新日志:

2.1.11

Change: Clearer description of what the plugin is for and what you can do with roles

2.1.10

First release on WordPress.org