Changeset 13614 for trunk/src/bp-members/bp-members-adminbar.php

Timestamp:

10/19/2023 11:34:45 PM (3 years ago)

Author:

imath

Message:

Introduce Admin Notifications to warn Admin about important BP changes

• Add a new Administration screen to list Admin notifications.
• Put the logic in place to dismiss an Admin notification.
• Add a 11.4 update task to add unread Admin notifications.
• Create a 11.4 Admin Notification to inform Admin users about whether they need to install BP Classic to be ready for BuddyPress 12.0.0

Props dcavins

Closes ​https://github.com/buddypress/buddypress/pull/176
See #9007 (trunk)

File:

• trunk/src/bp-members/bp-members-adminbar.php (modified) (2 diffs)

trunk/src/bp-members/bp-members-adminbar.php

@@ -168 +168 @@
  * Build the "Notifications" dropdown.
  *
+ * @since 11.4.0
+ */
+function bp_members_admin_bar_notifications_dropdown( $notifications = array(), $menu_link = '', $type = 'members' ) {
+        if ( ! $menu_link || ( 'admin' === $type && empty( $notifications ) ) ) {
+                return false;
+        }
+
+        global $wp_admin_bar;
+
+        $count       = 0;
+        $alert_class = array( 'count', 'no-alert' );
+
+        if ( ! empty( $notifications ) ) {
+                $count       = number_format_i18n( count( $notifications ) );
+                $alert_class = array( 'pending-count', 'alert' );
+
+                if ( 'admin' === $type ) {
+                        $count = '!';
+                }
+        };
+
+        $alert_class[] = $type . '-type';
+        $menu_title    = sprintf(
+                '<span id="ab-pending-notifications" class="%1$s">%2$s</span>',
+                implode( ' ', array_map( 'sanitize_html_class', $alert_class ) ),
+                $count
+        );
+
+        // Add the top-level Notifications button.
+        $wp_admin_bar->add_node( array(
+                'parent' => 'top-secondary',
+                'id'     => 'bp-notifications',
+                'title'  => $menu_title,
+                'href'   => $menu_link,
+        ) );
+
+        if ( ! empty( $notifications ) ) {
+                foreach ( (array) $notifications as $notification ) {
+                        $wp_admin_bar->add_node( array(
+                                'parent' => 'bp-notifications',
+                                'id'     => 'notification-' . $notification->id,
+                                'title'  => $notification->content,
+                                'href'   => $notification->href,
+                        ) );
+                }
+        } else {
+                $wp_admin_bar->add_node( array(
+                        'parent' => 'bp-notifications',
+                        'id'     => 'no-notifications',
+                        'title'  => __( 'No new notifications', 'buddypress' ),
+                        'href'   => $menu_link,
+                ) );
+        }
+
+        return true;
+}
+
+/**
+ * Build the Admin or Members "Notifications" dropdown.
+ *
  * @since 1.5.0
  *
@@ -173 +233 @@
  */
 function bp_members_admin_bar_notifications_menu() {
-
-        // Bail if notifications is not active.
-        if ( ! bp_is_active( 'notifications' ) ) {
-                return false;
-        }
-
-        bp_notifications_toolbar_menu();
+        $admins_notifications = array();
+        $capability           = 'manage_options';
+
+        if ( bp_core_do_network_admin() ) {
+                $capability = 'manage_network_options';
+        }
+
+        if ( bp_current_user_can( $capability ) ) {
+                $notifications = bp_core_get_admin_notifications();
+
+                if ( $notifications ) {
+                        $menu_link = esc_url( bp_get_admin_url( add_query_arg( 'page', 'bp-admin-notifications', 'admin.php' ) ) );
+                        $count     = count( $notifications );
+
+                        $notifications = array(
+                                (object) array(
+                                        'id'      => 'bp-admin-notifications',
+                                        'href'    => $menu_link,
+                                        'content' => sprintf(
+                                                /* translators: %s: the number of admin notifications */
+                                                _n( 'You have %s new important admin notification.', 'You have %s new important admin notifications.', $count, 'buddypress' ),
+                                                number_format_i18n( $count )
+                                        ),
+                                ),
+                        );
+
+                        return bp_members_admin_bar_notifications_dropdown( $notifications, $menu_link, 'admin' );
+                }
+        }
+
+        // Use Members notifications if the component is active.
+        if ( bp_is_active( 'notifications' ) ) {
+                return bp_notifications_toolbar_menu();
+        }
 }
 add_action( 'admin_bar_menu', 'bp_members_admin_bar_notifications_menu', 90 );