Skip to content

Everything below is added by this plugin on top of the member types that BuddyPress already supports.

Each member type can be tied to a single WordPress role from an Associated Roles dropdown on the Add and Edit member type screens. When a member is given the type, the plugin switches that user to the associated role automatically. Role mapping runs when:

  • A profile field of the plugin’s type is saved with a changed member type.
  • A member type is changed by an administrator, or from the Users bulk action.
  • A user activates their account after registration.

A profile save that leaves the member type unchanged never touches the role, so a role set by hand in Users sticks. When a member changes their own type, only member-level roles (Subscriber, Contributor, Author) are applied, and never to someone who already holds a higher role such as Editor. Forum roles are kept when the site role is replaced.

The Administrator role is removed from the dropdown by default, so you cannot map a type to Administrator through the UI. Administrator users are also protected: the plugin never strips the role of a user who already has the Administrator capability. With User Role Editor active, the mapped roles are added next to it.

Members can only pick, on registration or Edit Profile, types whose role grants no more than an Author. A type with no role mapped can always be picked. The owner sees a notice on the type screens listing any type blocked this way, and the bp_member_type_self_service_blocked_caps filter overrides the check. See Roles and who can pick what for the rule, the notice and the filter.

If a user ends up with more than one member type, the plugin decides which role to apply:

  • If the User Role Editor plugin is active, the user is given every associated role (User Role Editor supports multiple roles per user).
  • If User Role Editor is not active, the user is given the single role with the most capabilities among the mapped roles.

The plugin registers two BuddyPress xProfile field types so members can pick their own type from a profile field:

  • Member Types (category “Multi Fields”): renders as checkboxes, allowing more than one type.
  • Member Type (category “Single Fields”): renders as radio buttons, allowing one type.

Create a field of either type under Users > Profile Fields. The field’s options are populated automatically from your member types, so you do not enter options by hand. Saving the field two-way syncs with the member’s BuddyPress member type and applies the associated role.

On a member’s profile page the field shows the type labels (for example “Student”), not the stored keys. When the value is a profile search link, the link searches for members of that type. The stored value keeps the key.

On the profile field’s edit screen, the plugin adds a Field Display Control metabox with a Show Member Type field in user profile checkbox. Use it to show or hide the member type field on the front-end profile. When the field is hidden for members, administrators still see it in the admin so they can manage assignments.

Registration and profile visibility per type

Section titled “Registration and profile visibility per type”

Each member type carries its own visibility flags, set from checkboxes on the member type screen:

  • Display in Registration Form: the type is offered as an option in the member type field on the registration page. On BuddyPress the profile field must also have the Signups box ticked (Use this field in the site registration form), or the field is not on the form at all. On BuddyBoss Platform this checkbox does not apply; use BuddyBoss’s own Allow users to select this profile type from the “Profile Type” dropdown checkbox on the profile type instead (see Usage).
  • Pre-select on registration?: the type is checked by default for a visitor who is not logged in.
  • Display inside Edit Profile Settings: the type is offered in the member type field on the front-end edit-profile screen.

Types that are not flagged for a context are filtered out of the field options in that context.

For every member type that has a directory and at least one member, the plugin adds a filter tab to the members directory so visitors can browse members of that type. Both the Nouveau and Legacy BuddyPress templates are supported.

The number on each tab is counted the same way as the default directory list, so it matches the members the tab shows. A member type flagged Exclude from Members Directory is kept out of the default directory listing, out of the All Members count and out of the tabs, for everyone except administrators.

The exclusion applies to every members list on the site, not only the directory page. A list that asks for specific types (the member_type, member_type__in or member_type__not_in arguments, for example from a members shortcode of your theme or another plugin) keeps its own filter, and an excluded type stays hidden even when the list requests it by name. A member’s own profile page is not affected. The plugin adds no shortcode of its own.

From the WordPress Users table you can select several users and apply a member type to all of them in one action, using BuddyPress’s bulk change-type control. The plugin processes that bulk action, sets the type on each user, and applies the mapped role (on BuddyPress; BuddyBoss Platform uses its own handler). It also supports the Remove member type option to clear a type from the selected users. The action is guarded by a nonce and requires the promote_users capability.

  • User Role Editor: when active, multiple associated roles are applied instead of a single best-capability role.
  • Youzify: the plugin skips its own Legacy directory tabs when Youzify is active to avoid duplicate tabs.
  • BuddyBoss Platform 2.21 or later: limited support (tested with 2.21.1 and 3.6.2). Types are managed under BuddyBoss > Profile Types, so the per-type options above (Users > Member Types) and the Field Display Control box do not apply there. What does work:
    • The Member Type and Member Types fields on registration, Edit Profile (always shown there), the wp-admin profile and the Users bulk change. The fields stay in step with the member’s profile type.
    • A profile type chosen in a Member Type field applies the profile type’s WordPress role. A change made through BuddyBoss’s own Profile Type field or its Users bulk change keeps the role BuddyBoss sets.
    • Members can pick only profile types with Allow users to self-select ticked in BuddyBoss, and never one mapped to a role above Author.
    • A profile type hidden from the members directory in BuddyBoss gets no tab.
    • Use the single-choice Member Type field.

New versions are offered inside WordPress, under Dashboard > Updates, like any other plugin update. They come from updates.wbcomdesigns.com, with wbcomdesigns.com as a fallback when that host cannot be reached.

Nothing needs to be entered. On the first admin page load after activation the plugin fills in the free licence key and activates it in the background through WP-Cron. If that fails because the host cannot be reached, it retries hourly for about a day and then every 12 hours, for as long as it takes. Sites with WP-Cron disabled make the attempt during an admin page load instead, at most once every 12 hours.

What you see as an administrator, only on the Dashboard and Plugins screens:

  • Nothing while activation is still being tried in the first stretch.
  • A warning with a Retry now button when the host keeps blocking the connection, or when wbcomdesigns.com refused to turn updates on (the notice names the reason).
  • A confirmation, “BuddyPress Member Type can now download plugin updates”, after a successful Retry now.
  • A warning to reinstall when the plugin folder is missing its bundled update files.

All plugin features work in each case; only updates are affected. Each update package carries a release signature that is checked and logged; an update installs even when that check reports a problem. See Troubleshooting.