Skip to content

The plugin deactivated itself or shows a “requires BuddyPress” notice

Section titled “The plugin deactivated itself or shows a “requires BuddyPress” notice”

BuddyPress is a hard dependency. Install and activate BuddyPress, then activate this plugin again. On multisite, activate the plugin on the same site or with the same network configuration as BuddyPress, otherwise you will see a network-configuration notice.

The settings save requires the manage_options capability and a valid nonce. Make sure you are logged in as an administrator, that the page has not been open long enough for the nonce to expire, and that a security plugin is not stripping the posted fields. Reload the settings page and save again.

  • Confirm the visitor is actually logged out. All visitor restrictions apply only to logged-out users.
  • Confirm you saved the Visitor Restrictions tab with the component, page, or post type ticked.
  • Clear any page or full-page caching. A cached copy of a page can be served before the lock runs.
  • Some page builders and custom templates bypass the standard template hooks; test with a default configuration if a locked page still renders.

A group, friendship, or messaging limit is not being enforced

Section titled “A group, friendship, or messaging limit is not being enforced”
  • Administrators are exempt from these limits by design. Test with a non-admin account.
  • Confirm the relevant BuddyPress component (Groups, Friends, Messages) is active.
  • Confirm you configured the limit under the correct role and saved.
  • Group limits are counted per group status (public, private, hidden). Check that you set the limit for the status you are testing.

The “Members directory” per-role block does not take effect

Section titled “The “Members directory” per-role block does not take effect”

The rule sends a member away only when they open the BuddyPress members directory page while logged in with a role that has Members directory ticked under Pages this role cannot open. Check these in order:

  • Log in as a member with that role. Administrators are never restricted.
  • Confirm you picked the right role in Configure access for role and saved.
  • Confirm the page you open is the BuddyPress members directory, not a page that only shows a members shortcode or block.
  • If the member also holds another role, the rule still applies when any one of their roles blocks the page.

I cannot target a member type or a membership plan

Section titled “I cannot target a member type or a membership plan”

Membership Restrictions are set per WordPress role only. There is no setting that targets a BuddyPress member type, a GamiPress rank or a membership plan. To apply different rules, give those members a WordPress role that matches their group and configure that role. See Membership and LMS integrations.

Profile completion keeps redirecting a member

Section titled “Profile completion keeps redirecting a member”

Force profile completion redirects members who have not met a required item to the matching profile edit screen. This is expected until the member completes the requirement. Super admins are never forced. If you need to bypass the check programmatically, use the bp_force_profile_completion_skip_check filter.

The visitor login runs over AJAX and is protected by a nonce. Clear caches so a fresh nonce is served, and check the browser console for a JavaScript error from a conflicting plugin or theme. The form also works without JavaScript.

Icons or styles look wrong after an update

Section titled “Icons or styles look wrong after an update”

The plugin uses the WordPress Dashicons set and loads no icon font from an outside server. After an update the plugin styles and scripts reload automatically. If a page still looks wrong, clear your caching plugin and CDN, then reload.

A member sees no pop-up when a limit is reached

Section titled “A member sees no pop-up when a limit is reached”

Restriction notices appear as a dismissible notice in your theme’s notice style, not as a full-screen pop-up. On a normal page load it is a BuddyPress notice; on a button that works without reloading (join, add friend, send message) it appears on the page and has a close button. Screen readers announce it.