Changeset 12897 for trunk/src/bp-core/admin/bp-core-admin-functions.php

Timestamp:

04/20/2021 04:02:22 PM (5 months ago)

Author:

dcavins

Message:

BP Admin Tools: Add tab interface to support additional screens.

Expand the BP Tools screen to use a tabbed interface
so that multiple tools screens can be grouped in a
single Tools > BuddyPress menu item.

Props imath.

See #8448.

File:

• trunk/src/bp-core/admin/bp-core-admin-functions.php (modified) (5 diffs)

trunk/src/bp-core/admin/bp-core-admin-functions.php

@@ -390 +390 @@
  *
  * @since 1.5.0
+ * @since 8.0.0 Adds the `$context` parameter.
  *
  * @param string $active_tab Name of the tab that is active. Optional.
- */
-function bp_core_admin_tabs( $active_tab = '' ) {
+ * @param string $context    The context of use for the tabs. Defaults to 'settings'.
+ *                           Possible values are 'settings' & 'tools'.
+ */
+function bp_core_admin_tabs( $active_tab = '', $context = 'settings' ) {
     $tabs_html    = '';
     $idle_class   = 'nav-tab';
@@ -405 +408 @@
      * @param array $value Array of tabs to output to the admin area.
      */
-    $tabs = apply_filters( 'bp_core_admin_tabs', bp_core_get_admin_tabs( $active_tab ) );
+    $tabs = apply_filters( 'bp_core_admin_tabs', bp_core_get_admin_tabs( $active_tab, $context ) );
 
     // Loop through tabs and build navigation.
@@ -420 +423 @@
      *
      * @since 1.5.0
+     * @since 8.0.0 Adds the `$context` parameter.
+     *
+     * @param string $context The context of use for the tabs.
      */
-    do_action( 'bp_admin_tabs' );
+    do_action( 'bp_admin_tabs', $context );
 }
 
@@ -428 +434 @@
  *
  * @since 2.2.0
+ * @since 8.0.0 Adds the `$context` parameter.
  *
  * @param string $active_tab Name of the tab that is active. Optional.
+ * @param string $context    The context of use for the tabs. Defaults to 'settings'.
+ *                           Possible values are 'settings' & 'tools'.
  * @return string
  */
-function bp_core_get_admin_tabs( $active_tab = '' ) {
-    $tabs = array(
-        '0' => array(
-            'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-components' ), 'admin.php' ) ),
-            'name' => __( 'Components', 'buddypress' ),
-        ),
-        '2' => array(
-            'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-settings' ), 'admin.php' ) ),
-            'name' => __( 'Options', 'buddypress' ),
-        ),
-        '1' => array(
-            'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-page-settings' ), 'admin.php' ) ),
-            'name' => __( 'Pages', 'buddypress' ),
-        ),
-        '3' => array(
-            'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-credits' ), 'admin.php' ) ),
-            'name' => __( 'Credits', 'buddypress' ),
-        ),
-    );
+function bp_core_get_admin_tabs( $active_tab = '', $context = 'settings' ) {
+    $tabs = array();
+
+    if ( 'settings' === $context ) {
+        $tabs = array(
+            '0' => array(
+                'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-components' ), 'admin.php' ) ),
+                'name' => __( 'Components', 'buddypress' ),
+            ),
+            '2' => array(
+                'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-settings' ), 'admin.php' ) ),
+                'name' => __( 'Options', 'buddypress' ),
+            ),
+            '1' => array(
+                'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-page-settings' ), 'admin.php' ) ),
+                'name' => __( 'Pages', 'buddypress' ),
+            ),
+            '3' => array(
+                'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-credits' ), 'admin.php' ) ),
+                'name' => __( 'Credits', 'buddypress' ),
+            ),
+        );
+    } elseif ( 'tools' === $context ) {
+        $tools_page = 'tools.php';
+        if ( bp_core_do_network_admin() ) {
+            $tools_page = 'admin.php';
+        }
+
+        $tabs = array(
+            '0' => array(
+                'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-tools' ), $tools_page ) ),
+                'name' => __( 'Repair', 'buddypress' ),
+            ),
+        );
+    }
 
     /**
@@ -456 +481 @@
      *
      * @since 2.2.0
+     * @since 8.0.0 Adds the `$context` parameter.
      *
-     * @param array $tabs Tab data.
+     * @param array  $tabs    Tab data.
+     * @param string $context The context of use for the tabs.
      */
-    return apply_filters( 'bp_core_get_admin_tabs', $tabs );
+    return apply_filters( 'bp_core_get_admin_tabs', $tabs, $context );
 }