Skip to content
Docs

Troubleshooting

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.

Settings are not saving

Section titled “Settings are not saving”

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.

Visitors can still see locked content

Section titled “Visitors can still see locked content”
  • 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”

If the per-role Members Directory restriction under BuddyPress Community Access does not appear to apply while other blocks (Activity, Groups, single group, profile) do, capture the exact role, the saved option, and the behavior and report it to support so it can be verified against your site.

Member-type or membership-plugin targeting is not available

Section titled “Member-type or membership-plugin targeting is not available”

The Membership Restrictions tab is organized by WordPress role. Detection of BuddyPress member types, GamiPress, and membership or LMS plugins exists in the plugin, but if you expect to target those specifically and do not see the option, confirm the behavior in your version before relying on it, and contact support with the details.

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.

Login or registration form does nothing

Section titled “Login or registration form does nothing”

The visitor login and registration run over AJAX and are 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.

Styles look wrong on the login form

Section titled “Styles look wrong on the login form”

The plugin loads Font Awesome 4.7 from a CDN for its icons. If your site blocks external requests, some icons may not render; this does not affect functionality.