Changeset 6563

Timestamp:

06/16/2017 04:56:02 PM (8 years ago)

Author:

johnjamesjacoby

Message:

Moderators: Introduce "Super Moderators" setting.

This change introduces the option (and default off value), admin setting and UI for toggling it on and off.

A "Super Moderator" is a moderator with the ability to also edit users, a commonly requested and popular feature in other forum software. The use-case is that user accounts may be spammers and need to be moderated beyond just their topics & replies, but the edit_users capability is reserved for Administrators (or Super Admins in multisite.) This setting will act as the global on/off to the deeper implementation of this feature.

Location:

trunk/src/includes

Files:

• admin/settings.php (modified) (2 diffs)
• core/options.php (modified) (3 diffs)

trunk/src/includes/admin/settings.php

@@ -208 +208 @@
                 'title'             => esc_html__( 'Forum Moderators', 'bbpress' ),
                 'callback'          => 'bbp_admin_setting_callback_forum_mods',
+                'sanitize_callback' => 'intval',
+                'args'              => array()
+            ),
+
+            // Allow moderators to edit users
+            '_bbp_allow_super_mods' => array(
+                'title'             => esc_html__( 'Super Moderators', 'bbpress' ),
+                'callback'          => 'bbp_admin_setting_callback_super_mods',
                 'sanitize_callback' => 'intval',
                 'args'              => array()
@@ -832 +840 @@
     <input name="_bbp_allow_forum_mods" id="_bbp_allow_forum_mods" type="checkbox" value="1" <?php checked( bbp_allow_forum_mods( true ) ); bbp_maybe_admin_setting_disabled( '_bbp_allow_forum_mods' ); ?> />
     <label for="_bbp_allow_forum_mods"><?php esc_html_e( 'Allow forums to have dedicated moderators', 'bbpress' ); ?></label>
+
+<?php
+}
+
+/**
+ * Allow super-mods setting field
+ *
+ * @since 2.6.0 bbPress (r6562)
+ *
+ * @uses checked() To display the checked attribute
+ */
+function bbp_admin_setting_callback_super_mods() {
+?>
+
+    <input name="_bbp_allow_super_mods" id="_bbp_allow_super_mods" type="checkbox" value="1" <?php checked( bbp_allow_super_mods( false ) ); bbp_maybe_admin_setting_disabled( '_bbp_allow_super_mods' ); ?> />
+    <label for="_bbp_allow_super_mods"><?php esc_html_e( 'Allow moderators to edit other users', 'bbpress' ); ?></label>
 
 <?php

trunk/src/includes/core/options.php

@@ -43 +43 @@
         '_bbp_allow_topic_tags'       => 1,                          // Allow topic tagging
         '_bbp_allow_forum_mods'       => 1,                          // Allow per-forum moderation
+        '_bbp_allow_super_mods'       => 0,                          // Allow mods to edit users
         '_bbp_allow_threaded_replies' => 0,                          // Allow threaded replies
         '_bbp_allow_search'           => 1,                          // Allow forum-wide search
@@ -409 +410 @@
  *
  * @param bool $default Optional. Default value true.
- * @uses get_option() To get the allow per-forum moderators
+ * @uses get_option() To get the allow per-forum moderators setting
  *
  * @return bool Are per-forum moderators allowed?
@@ -417 +418 @@
     // Filter & return
     return (bool) apply_filters( 'bbp_allow_forum_mods', (bool) get_option( '_bbp_allow_forum_mods', $default ) );
+}
+
+/**
+ * Are moderators allowed to edit users
+ *
+ * @since 2.6.0 bbPress (r6562)
+ *
+ * @param bool $default Optional. Default value true.
+ * @uses get_option() To get the allow super moderators setting
+ *
+ * @return bool Are moderators allowed to edit users?
+ */
+function bbp_allow_super_mods( $default = 0 ) {
+
+    // Filter & return
+    return (bool) apply_filters( 'bbp_allow_super_mods', (bool) get_option( '_bbp_allow_super_mods', $default ) );
 }