bbPress User Roles and Capabilities
Overview
bbPress comes built in with user Roles that give the website owner the ability to tailor user access to their website. This page details the bbPress capabilities that each role has.
You manage bbPress users roles in the same way you manage WordPress user roles. (/wp-admin/users.php)
Under the hood details of the roles and capabilities introduced with bbPress 2.2 can be read here.
(bbPress user Roles can be found in /includes/core/capabilities.php)
For more general information on WordPress Roles and Capabilities, refer to the guide in the WordPress Codex.
For advanced editing of bbPress User Roles checkout @JJJ‘s plugin by Advanced user capability editing for bbPress.
Summary of Roles
The default bbPress Roles are:
- Keymaster – Can create, edit and delete other users’ forums, topics and replies. Can manage Tags, and moderate a forum with the moderation tools. Has access to global forum settings, tools, and importer.
- Moderator – Can create and edit forums. Can create, edit and delete other users’ topics and replies. Can manage Tags, and moderate a forum with the moderation tools.
- Participant – Can create and edit their own topics and replies.
- Spectator – Can only read topics and replies.
- Blocked – All capabilities are explicitly blocked.
Detailed Breakdown of Roles
Keymaster
Forum Capabilities
keep_gate** See the notes below- publish_forums
- edit_forums
- edit_others_forums
- delete_forums
- delete_others_forums
- read_private_forums
- read_hidden_forums
Topic Capabilities
- publish_topics
- edit_topics
- edit_others_topics
- delete_topics
- delete_others_topics
- read_private_topics
Reply Capabilities
- publish_replies
- edit_replies
- edit_others_replies
- delete_replies
- delete_others_replies
- read_private_replies
Topic Tag Capabilities
- manage_topic_tags
- edit_topic_tags
- delete_topic_tags
- assign_topic_tags
Miscellaneous
Moderator
Forum Capabilities
- publish_forums
- edit_forums
- read_private_forums
- read_hidden_forums
Topic Capabilities
- publish_topics
- edit_topics
- edit_others_topics
- delete_topics
- delete_others_topics
- read_private_topics
Reply Capabilities
- publish_replies
- edit_replies
- edit_others_replies
- delete_replies
- delete_others_replies
- read_private_replies
Topic Tags Capabilities
- manage_topic_tags
- edit_topic_tags
- delete_topic_tags
- assign_topic_tags
Miscellaneous
Participant
Forum Capabilities
- read_private_forums
Topic Capabilities
- publish_topics
- edit_topics
Reply Capabilities
- publish_replies
- edit_replies
Topic Tag Capabilities
- assign_topic_tags
Miscellaneous
Spectator
Miscellaneous
- spectate
Notes:
** The keep_gate capability can be used to allow the granting of a specific “do all things in the forums” capability to any user, without actually granting them the Keymaster role directly.
