An add-on to the bbPress forum plugin – creates private forum groups
This Plugin creates unlimited private forum groups.
Forums are then allocated to one or more groups, and users allocated to one or more groups.
What this achieves
unlimited private groups
Each user is set to a group or groups, and each forum can have any or all the groups associated with it
Any number of public forums combined with any number of group forums. The group forums can be individually set to public or private.
Forum title and description (but not topics or replies) can be set to be visible to non-group users, allowing people to see that a forum exists but not access it
Separate pages can be set to allow redirection of non group users for sign-up or information
Topic Permissions is designed for sites where users need to have different permissions to different forums.
For instance the ability for users to contribute to one forum whilst only being able to view another, or only start topics in one forum, or only reply to topics in another.
User a belongs to group 1
User b belongs to group 2
User c belongs to group 3
Forum x is set to allow group 2
Forum y is set to allow group 2 and group 3
Forum z is set to allow group 1 and group 3
User a can access only forum z
User b can access forum x and forum y
User c can access forum y and forum z
The widgets (bbpress) forums list, (bbpress) recent replies, and (bbpress) recent topics SHOULD NOT BE USED, as they will show topics headings and author names for all forums. Replacement widgets called (private groups) forums list, (private groups) recent replies, and (private groups) recent topics are available instead
Works with bbpress 2.5.3 or higher
To install this plugin :
- Go to Dashboard>plugins>add new
- Search for ‘private groups’
- Click install
- and then activate
- go into settings and set up as required.
Go to Dashboard>settings>Private Groups
There are 4 settings tabs and 2 management tags.
Forum Visibility tab.
This tab allows you to set forum visibility.
By default where the forum has groups set, then these are only visible to authorised users. However you may want users to see that forums exist (to attract new forum users), but not to see content.
For instance on a cookery site you might have a cake group, who exchange recipes and advice on cakes. You might want people to sign up before being able to contribute, but if they don’t know the forum exists, they won’t join.
So by listing the forums (and optionally the description – see tab below) users can see they exist, and if they click the forum or freshness links, they can be taken to any url or wordpress page you wish. Typically this might be a sign-up page, or a ‘you can’t access’ page. For instance you page might say
Sorry, you need to be a member to see this area. To join click here Login if need-be [bbp-login]
In this tab, you can set whether non-group members can see the forums in the indexes (but not access). If the forum is set to public, then both non-logged in and logged in users will see this. If the forum is set to private, then only logged in users will see the existence of these forums. this gives a highly granular approach to what forums are displayed for different groups.
If visibility is set, then there are options for redirecting, and what freshness messages are displayed.
In general settings, you have the ability to hide topic and reply counts, show sub-forum descriptions, and remove the ‘private’ prefix from the forum displays.
Group Name Settings
Here you set ‘friendly’ names for the groups, to help you remember. These names do not affect how the restrictions work, group 1 will remain group 1 whatever you name it.
To set forums
For each restricted forum
- Go in to Dashboard>forums and select the forum you wish to restrict.
- Under the text you’ll see a box called ‘Forum Groups’ – select the group or groups you wish to allow to access this forum
- If you wish to have a custom error message, you can set one here.
The bbPress topics and replies widgets will still at this stage show all topic and reply titles etc. If a topic/reply is selected this will give an error message, but titles and authors will be visible, which might be embarrassing !
So you will probably not want people to see these subjects, so there are 3 new widgets that the plugin has added that filter this to only show appropriate content.
Go in to Dashboard>appearance>widgets
- You will see three new widgets starting with (private groups) and covering topics, replies and Topics lists.
- If you are using the standard bbPress topic, reply or forum list widgets, you should remove these from your sidebar and replace them with the (private groups) ones
This tab lists the groups, what forums are allocated to them, and the number of users each group has
This tab allows for the bulk change of users between (and to and from) the groups, and via user edit allows multiple group allocation
Assign groups to roles
This tab allow those of you who use membership plugins etc. to assign a group against a wordpress or custom role.
To set forums
For each restricted forum
1.Go in to Dashboard>forums and select the forum you wish to restrict.
2.Under the text you’ll see a box called ‘Forum Groups’ – select the group or groups you wish to allow to access this forum
The bbPress topics and replies widgets will still at this stage show all topic and reply titles etc. If a topic/reply is selected this will give an error message (see below).
However you will probably not want people to see these subjects, so there are two widgets that the plugins have added that filter this to only show appropriate content.
Go in to Dashboard>appearance>widgets
1.You will see three new widgets starting with ‘(Private Groups)’ and covering topics, replies and forum list.
2.If you are using the standard bbPress topic, reply or forum list widgets, you should remove these from your sidebar and replace them with the ‘private group’ ones.
A shortcode to list users either across all groups or per group
[list-pg-users ] lists all groups and their users
[list-pg-users group=$group] lists users of a single group name eg [list-pg-users group=’developers’]
Contributors & Developers
“Private groups” is open source software. The following people have contributed to this plugin.Contributors
3.9.4 minor change to allow redirect to be filterable
3.9.3 fix for metabox undefined variable
3.9.2 amended tested up to value
3.9.1 amend enforce permissions test in functions.php to add !empty argument (line 184 & 194), and amend disable_groups to only search users where private groups are set (line 38)
3.9.0 allow for nil groups under php 8.0 to prevent fatal count error
3.8.9 Hide forums in menus if visibility switched off
3.8.8 revised filter for bsp-display-topic-index to deal with situation where forum= not used
3.8.6 amended user view forum check. If no group is set for a forum, then the private_groups_can_user_view_post function did set $can_view as true even if post was hidden or private. This function now checks if user is allowed to see the forum if no group set and sets $can_view correctly
3.8.5 amended filter for style pack pg_display_forum_query_filter to allow for forum visibility
3.8.4 wordpress 5.5 tested version
3.8.3 Correction to 3.8.2 to fix loading order
3.8.2 Revised forum descriptions to match bbpress 2.6.x, revised sub forum filter to cope with 2.5.x and 2.6.x versions, amended bbp_filter to take account of multipgaed and date filters
3.8.1 change to forum desciption and last activity to cater for sub forums
3.8.0 minor chnage to meta-box to prevent non critical error if non logged in empty
3.7.9 improved plugin information layout
3.7.8 Admin warning limited to display 10 times
3.7.8 Admin warning added for bbpress 2.6 users
3.7.7 filter added to private_groups_list_forums
3.7.6 bug fix to 3.7.5 to ensure save when topic permissions not set
3.7.5 prevent settings being lost on bulk forum update
3.7.4 User managament changed to display the no.users in the selection
3.7.3 minor change to private_groups_get_permitted_subforums to correctly pass $args
3.7.2 minor change to prevent php version 5 errors
3.7.1 minor change to ensure ‘no group set’ users show correctly in user management tab
3.7.0 Updated fr. pot and files
3.6.9 minor change to forum private groups metabox to correctly display if no groups set up
3.6.8 checkall for user management added
3.6.7 Action hooks added to user management to allow for custom columns. Add groups to roles improved to allow for multiple roles
3.6.6 Warning if using bbpress notify added. Fix for max(): Array must contain at least one element where own topics set by no topics yet
3.6.5 fix for post_id error in pg_check_profile where topic is supersticky, but no other topics in forum
3.6.4 added filter to ensure at the backend moderators only see their own forum topics and replies
3.6.3 Improvements to freshness display for ‘access own topic’ users.
3.6.2 amended functions and topic_filters to prevent topics being seen for ‘access own topic’ users.
3.6.1 unreleased version
3.6.0 amended forum metabox to better display non-logged in options, added filter for rss2 feed single item
3.5.9 added ability where anonymous posting allowed to set forum permissions for anon users as per group settings
3.5.8 added ability to show a forum to non-logged in users when topic permissions activated. Fixed forum dropdown list when topic permissions not set
3.5.7 remove space from start of pg_forum_widgets.php
3.5.6 Amendment to pg replies widget to correctly set args[‘after’]
3.5.5 amendments to $allowed_forums to set to -1 if null. amendment to pg forums list widget to correctly set args[‘before’]
3.5.4 correction to forum visibility if freshness message set
3.5.3 corrected to fix headers sent message
3.5.2 temporary revert to 3.5.1
3.5.1 Amended topic permissions to add Create/Edit/view OWN Topics to allow for say a help desk private forum
3.5.0 Amended meta-box.php to only fire on forum changes
3.4.9 assign groups on login filtered at add_action level to prevent errors
3.4.8 disable_groups added, forum ID added to forum lists in dashboard, groups added to forum lists in dashboard
3.4.7 addition to assign groups to roles to assign on every visit.
3.4.6 minor fix to pg latest activity widget to show latest reply if no author shown
3.4.5 added improved subscription filtering to remove subscriptions if as a result of group changes user can no longer see forum or topics from that forum
3.4.4 improved styling capability on pg activity widget
3.4.3 improved styling capability on pg activity widget
3.4.2 further corection to PF forums widget for forum lists
3.4.1 further corection to PF forums widget for forum lists
3.4.0 minor correction to role_assignment and Settings to correct undefined index
3.3.9 correction to PF forums widget for forum lists
3.3.8 correction to user-profile.php for current user when being amended by admin
3.3.7 Additional functioinality to PF forums widget to allow for forum visibility
3.3.6 Added ability for programmers to add and delete groups
3.3.5 Change to forum and activity widget to improve output order and consistency. Revised rpg_get_forum_last_active_id function
3.3.4 Improved code for 3.3.3 functionality
3.3.3 add parameters to add_filter(‘bbp_get_forum_freshness_link’) to allow for direct filtering
3.3.2 correction to fix user avatar where a category or forum has sub forums, some of which the user is not permitted to see
3.3.1 correction to fix topic/reply counts where a category or forum has sub forums, some of which the user is not permitted to see
3.3.0 correction to prevent freshness for a sub forum being incorrectly displayed on a category
3.2.10 correction to prevent reply form being shown on closed topics
3.2.9 minor correction to forum-filter
3.2.8 correction to ensure that user favorites displays filtered favorites
3.2.7 correction to text domain for meta-box.php and plugin-info.php
3.2.6 minor big fix valuecheck in functions.php
3.2.5 minor fix to user-profile.php to remove undefined index line 73 and minor correction to functions to ensure valuecheck = 0 if not set in topic permissions, re-order of tabs and additional help text
3.2.4 Role filter added to user management
3.2.3 Correction to Topic Permissions for certain themes
3.2.2 Topic Permissions tab added
3.2.0 Plugin information tab added
3.1.9 add filter to allow bbp-style-pack widgets to work with private groups
3.1.8 fix undefined error in meta-box.php, add shortcodes plugin to work with private groups, add filter to allow for which capability can access the settings page
3.1.7 add filter to allow bbp-style-pack shortcodes to work with private groups
3.1.6 Tidy-up of error in 3.1.5
3.1.5 Multilanguage version for change in 3.1.4 !
3.1.4 added function to functions.php for ‘Private:’ removal in widgets
3.1.3 correct registration and login to allow for varying table prefixes
3.1.2 addition of wp_link_query filter to prevent unallowed topic titles being displayed during link action in topic and reply forms
3.1.1 Correction to latest activity widget to prevent fatal error (parse settings)
3.1.0 Forums widget amended to allow multiple forums
3.0.9 latest activity widget amended to allow multiple forums
3.0.8 Additional shortcodes added to replace bbp single forum, topics and replies shortcodes
Line 21 added to replies.php to set null for $allowed_posts
3.0.7 fix issue with forum visibility forum-filters.php lines 28 & 119
corrected unitinitilased offset in forum-filters.php line 256 and functions.php line 235
3.0.6 minor undefined index errors fixed in settings pages
3.0.5 minor undefined index errors fixed in forum-filters.php
3.0.4 fix issue with widgets showing activity’ if post__in no allowed_posts array is blank
Internationalisation added for pg_forum_widgets.php
$user_id added to is_keymaster($user_id) line 48 in user-view-post.php to allow for compatibility with other plugins
3.0.3 fix issue with 404’s showing in functions file
3.0.2 fix foreach error in functions line 300
3.0.1 fix issue with assign groups to roles, and add login assignation to plugin role_assignment.php functions.php, change replies.php to set $limit in all cases
2.5.6 change to forum_filters.php and topics.php to correct minor syntax errors https://wordpress.org/support/topic/couple-of-warnings-in-latest-version?replies=6 and https://wordpress.org/support/topic/bbp_list_forums-filter-bug?replies=2
2.5.5 add latest activity widget, corrected sub-forum display and added column option
2.5.4 remove author link filter as not required
2.5.3 fix search pagnination
2.5.2 correction to moderator role to prevent moderators seeing other private forums
2.5.1 minor error fix for ‘remove private prefix’ casuing illegal offset
2.5 updated to allow internationalization
2.4 Correction to management information user count
2.3 Minor correction
2.2 Multiple groups for users added
2.1 Optional assign users to roles added to settings
2.0.1 list user shortcode added
User Management (bulk change of users) added
Management information – list of forums added
1.9.2 Fix for array error on forum visibility
improved filter for topic subscriptions
1.9.1 Fix for moderator role in group views
1.9 fix to forum subscription display in profile
1.8.1 bug fix for search function returning incorrect data when allowed posts was nil
1.8 bug fix where forum is top level forum
topic/reply/forum types implemented throughout
1.7 Moderators can now be set to moderate all forums or just their group ones (plus any open forums)
Improved topic filtering to speed performance
allow Super sticky topics to be seen by all forums
1.6 Shortcode [bbp-topic-form] now only shows allowed forums
1.5 Amended to have unlimited groups
1.4.1 compatibility with ‘mark as read’ plugin
1.3 topics and replies paging fixed
1.2 Author and replies issues fixed
1.1 Minor changes
1.0 Version 1