Changeset 5834 for trunk/src/bbpress.php

Timestamp:

07/15/2015 03:59:23 PM (10 years ago)

Author:

johnjamesjacoby

Message:

Moderators: First pass at per-forum moderators.

This commit introduces a powerful feature commonly found in other popular forum software that has been on our wishlist for nearly 9 years. It includes the following changes:

• Custom forum-mod taxonomy for assigning user nicenames to forum IDs
• Associated functions for defining capabilities, labels, etc...
• New capability filters for ensuring forum moderators have the ability to moderate forums even without the moderator role assignment
• New option for toggling the entire feature on/off (on by default)

Props jmdodd, netweb. See #459.

File:

• trunk/src/bbpress.php (modified) (3 diffs)

trunk/src/bbpress.php

@@ -224 +224 @@
         // Post type identifiers
         $this->forum_post_type   = apply_filters( 'bbp_forum_post_type',  'forum'     );
+        $this->forum_mod_tax_id  = apply_filters( 'bbp_forum_mod_tax_id', 'forum-mod' );
         $this->topic_post_type   = apply_filters( 'bbp_topic_post_type',  'topic'     );
+        $this->topic_tag_tax_id  = apply_filters( 'bbp_topic_tag_tax_id', 'topic-tag' );
         $this->reply_post_type   = apply_filters( 'bbp_reply_post_type',  'reply'     );
-        $this->topic_tag_tax_id  = apply_filters( 'bbp_topic_tag_tax_id', 'topic-tag' );
 
         // Status identifiers
@@ -652 +653 @@
 
     /**
-     * Register the topic tag taxonomy
-     *
-     * @since bbPress (r2464)
+     * Register the topic tag and forum moderator taxonomies
+     *
+     * @since bbPress (r2464) Added bbp_get_topic_tag_tax_id() taxonomy
+     * @since bbPress (r5834) Added bbp_get_forum_mod_tax_id() taxonomy
+     *
      * @uses register_taxonomy() To register the taxonomy
+     * @uses bbp_get_topic_post_type() To get the topic post type
+     * @uses bbp_get_topic_tag_tax_labels() To get the topic tag taxonomy labels
+     * @uses bbp_get_topic_tag_tax_rewrite() To get the topic tag taxonomy slug
+     * @uses bbp_get_topic_tag_caps() To get topic tag capabilities
+     * @uses bbp_allow_topic_tags() To check if topic tags are allowed
+     * @uses current_user_can() To check if the current user can edit/delete tags
+     * @uses bbp_get_forum_post_type() To get the forum post type
+     * @uses bbp_get_forum_mod_tax_labels() To get the forum moderator taxonomy label
+     * @uses bbp_get_forum_mod_caps() To check the forum moderator capabilities
+     * @uses bbp_allow_forum_mods() To check if forum moderators are allowed
+     * @uses current_user_can() To check if the current user can edit/delete forums
      */
     public static function register_taxonomies() {
 
-        // Register the topic-tag taxonomy
+        // Register the topic-tag taxonomy.
         register_taxonomy(
             bbp_get_topic_tag_tax_id(),
@@ -673 +687 @@
                 'show_in_nav_menus'     => false,
                 'public'                => true,
-                'show_ui'               => bbp_allow_topic_tags() && current_user_can( 'bbp_topic_tags_admin' )
+                'show_ui'               => bbp_allow_topic_tags() && current_user_can( 'bbp_topic_tags_admin' ),
+            )
+        ) );
+
+        // Register the forum-mod taxonomy.
+        register_taxonomy(
+            bbp_get_forum_mod_tax_id(),
+            bbp_get_forum_post_type(),
+            apply_filters( 'bbp_register_forum_moderator_taxonomy', array(
+                'labels'                => bbp_get_forum_mod_tax_labels(),
+                'capabilities'          => bbp_get_forum_mod_caps(),
+                'update_count_callback' => '_update_post_term_count',
+                'query_var'             => false,
+                'show_tagcloud'         => true,
+                'hierarchical'          => false,
+                'show_in_menu'          => true,
+                'show_in_nav_menus'     => false,
+                'public'                => false,
+                'show_ui'               => bbp_allow_forum_mods() && current_user_can( 'bbp_forum_mods_admin' ),
             )
         ) );