bbPress Setup

Overview

This document provides instructions on how to use the bbPress extension on your site and how it integrates with Ultimate Member. 

This extension requires plugins bbPress and Ultimate Member. You can find bbPress documentation here.

bbPress profile

The default bbPress profile is removed with this extension, and the bbPress stats for each user are moved to the Ultimate Member profile under the profile tab called Forums. This tab can show four sub-tabs:

• Topics Started
• Replies Created
• Favorites
• Subscriptions

To remove the Favorites and Subscriptions sub-menu items, simply disable them in the bbPress settings found in wp-admin > Settings > Forums.

Forums tab visibility settings

Administrators can customize who can see the Forums tab in user profiles based on user roles. This can be configured in wp-admin > Ultimate Member > Settings > Appearance > Profile Menu.

Here’s how the settings work:

• Forums Tab: Controls if the "Forums" tab appears in profiles. If enabled, it will be visible based on role-specific settings. If disabled, the tab won’t show in any user profile.
• Who Can See Forums Tab?: Determines which roles can see the Forums tab. Available options include:
  • Anyone: The "Forums" tab is visible to all users, including guests (non-logged-in users).
  • Guests Only: Only non-logged-in users (guests) can see the "Forums" tab; logged-in members cannot.
  • Members Only: Only registered and logged-in members can access the "Forums" tab. Guests are excluded.
  • Only the Owner: Only the forum owner (administrator) can see the "Forums" tab, no other roles are allowed.
  • Only Specific Roles: Administrators can select specific user roles (such as moderators or editors) to view the "Forums" tab.
  • Owner and Specific Roles: The "Forums" tab is visible to the owner and any selected user roles chosen by the administrator.

User Roles settings

With the extensions, you can apply permissions on a user role basis. To apply permissions to a role edit the role and go to the bbPress permissions widget. In this widget you can set the following:

• Can have forums tab: This option allows you to disable the forums tab for certain user roles.
• Can create new topics:This option allows you to decide whether a user role can create new topics or not.
• Can create new replies: This option allows you to decide whether a user role can create new replies or not.
• Disable new topics during these weekdays: This option allows you to stop new topics from being created on specific days.
• Custom message to show to user if user cannot post in the above selected days: This option allows you to set a custom message to show to users when new topics can not be created. The notice will only show on days that are disabled.

These settings are located on wp-admin > Ultimate Member > User Roles > Edit Role

Forum writing permissions

The extension allows you to apply posting restrictions to individual forums. You can restrict which user roles can create new topics or replies on a per forum basis. To apply restrictions to a forum edit the desired forum and you will see a box called “UM Permissions”. In this box, you can choose which roles can create new topics in this forum and which roles can create new replies in this forum.

Note: User role settings are used if you select nothing in the box "UM Permissions".

These settings are located on  wp-admin > Forums > Edit Forum.

Blocking access to a forum

You can use the access control widget to stop certain people/roles from even viewing the forum. To do this just turn on access control and decide who can view the forum. You can then set a redirect URL to the main forums page or any other URL or you can leave the URL field blank.