Changeset 12899

Timestamp:

04/20/2021 04:03:08 PM (4 years ago)

Author:

dcavins

Message:

BP_Optouts: Add WP Admin management screen.

Add a management screen for opt-out requests at the
single-site or network level. This screen is appended
to the BuddyPress Tools screen. Using this screen,
site admins can view opt-out requests, search for
opt-outs by specific email address, and monitor
opt-out requests for signs of abuse by a particular
email type or potentially malicious user.

Fixes #8448.

Location:

trunk/src

Files:

• bp-core/admin/bp-core-admin-functions.php (modified) (2 diffs)
• bp-core/admin/bp-core-admin-optouts.php (added)
• bp-core/admin/bp-core-admin-tools.php (modified) (1 diff)
• bp-core/classes/class-bp-admin.php (modified) (3 diffs)
• bp-core/classes/class-bp-optouts-list-table.php (added)
• bp-members/classes/class-bp-members-admin.php (modified) (1 diff)
• class-buddypress.php (modified) (1 diff)

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

@@ -84 +84 @@
     if ( in_array( $plugin_page, array( 'bp-tools', 'available-tools' ) ) ) {
         $submenu_file = $plugin_page;
+    }
+
+    // Keep the BuddyPress tools menu highlighted.
+    if ( 'bp-optouts' === $plugin_page ) {
+        $submenu_file = 'bp-tools';
     }
 }
@@ -474 +479 @@
                 'name' => __( 'Repair', 'buddypress' ),
             ),
+            '1' => array(
+                'href' => bp_get_admin_url( add_query_arg( array( 'page' => 'bp-optouts' ), $tools_page ) ),
+                'name' => __( 'Manage Opt-outs', 'buddypress' ),
+            ),
         );
     }

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

@@ -556 +556 @@
                     esc_html_x( 'Use the %s to repair these relationships.', 'buddypress tools intro', 'buddypress' ),
                     '<a href="' . esc_url( $url ) . '">' . esc_html__( 'BuddyPress Repair Tools', 'buddypress' ) . '</a>'
+                );
+                ?>
+            </dd>
+            <dt><?php esc_html_e( 'Manage Opt-outs', 'buddypress' ) ?></dt>
+            <dd>
+                <?php esc_html_e( 'BuddyPress stores opt-out requests from people who are not members of this site, but have been contacted via communication from this site, and wish to opt-out from future communication.', 'buddypress' ); ?>
+                <?php
+                $url = add_query_arg( 'page', 'bp-optouts', bp_get_admin_url( $page ) );
+                printf(
+                    /* translators: %s: the link to the BuddyPress Nonmember Opt-outs */
+                    esc_html_x( 'Visit %s to manage your site&rsquo;s opt-out requests.', 'buddypress opt-outs intro', 'buddypress' ),
+                    '<a href="' . esc_url( $url ) . '">' . esc_html__( 'Nonmember Opt-outs', 'buddypress' ) . '</a>'
                 );
                 ?>

trunk/src/bp-core/classes/class-bp-admin.php

@@ -124 +124 @@
         require( $this->admin_dir . 'bp-core-admin-slugs.php'      );
         require( $this->admin_dir . 'bp-core-admin-tools.php'      );
+        require( $this->admin_dir . 'bp-core-admin-optouts.php'    );
     }
 
@@ -302 +303 @@
         );
 
+        $hooks[] = add_submenu_page(
+            $tools_parent,
+            __( 'Manage Opt-outs', 'buddypress' ),
+            __( 'Manage Opt-outs', 'buddypress' ),
+            $this->capability,
+            'bp-optouts',
+            'bp_core_optouts_admin'
+        );
+
         // For network-wide configs, add a link to (the root site's) Emails screen.
         if ( is_network_admin() && bp_is_network_activated() ) {
@@ -524 +534 @@
         remove_submenu_page( 'index.php', 'bp-about'   );
         remove_submenu_page( 'index.php', 'bp-credits' );
+
+        // Nonmembers Opt-outs page.
+        if ( is_network_admin() ) {
+            remove_submenu_page( 'network-tools', 'bp-optouts' );
+        } else {
+            remove_submenu_page( 'tools.php', 'bp-optouts' );
+        }
     }
 

trunk/src/bp-members/classes/class-bp-members-admin.php

@@ -510 +510 @@
             $this->users_page   .= '-network';
             $this->signups_page .= '-network';
+
+            $this->members_optouts_page .= '-network';
         }
 

trunk/src/class-buddypress.php

@@ -599 +599 @@
             'BP_Admin_Types'               => 'core',
             'BP_Optout'                    => 'core',
+            'BP_Optouts_List_Table'        => 'core',
 
             'BP_Core_Friends_Widget'   => 'friends',