WordPress 4.4
[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-ms-users-list-table.php
index 962f34aaea4544296b67eaaf02a594526831c10c..9062d9f084959541ffe0dd1f5cd1c506185bc826 100644 (file)
@@ -1,11 +1,19 @@
 <?php
 /**
- * Multisite Users List Table class.
+ * List Table API: WP_MS_Users_List_Table class
  *
  * @package WordPress
- * @subpackage List_Table
+ * @subpackage Administration
+ * @since 3.1.0
+ */
+
+/**
+ * Core class used to implement displaying users in a list table for the network admin.
+ *
  * @since 3.1.0
  * @access private
+ *
+ * @see WP_List_Table
  */
 class WP_MS_Users_List_Table extends WP_List_Table {
        /**
@@ -42,10 +50,14 @@ class WP_MS_Users_List_Table extends WP_List_Table {
                        'fields' => 'all_with_meta'
                );
 
-               if ( wp_is_large_network( 'users' ) )
+               if ( wp_is_large_network( 'users' ) ) {
                        $args['search'] = ltrim( $args['search'], '*' );
+               } else if ( '' !== $args['search'] ) {
+                       $args['search'] = trim( $args['search'], '*' );
+                       $args['search'] = '*' . $args['search'] . '*';
+               }
 
-               if ( $role == 'super' ) {
+               if ( $role === 'super' ) {
                        $logins = implode( "', '", get_super_admins() );
                        $args['include'] = $wpdb->get_col( "SELECT ID FROM $wpdb->users WHERE user_login IN ('$logins')" );
                }
@@ -71,6 +83,9 @@ class WP_MS_Users_List_Table extends WP_List_Table {
 
                $mode = empty( $_REQUEST['mode'] ) ? 'list' : $_REQUEST['mode'];
 
+               /** This filter is documented in wp-admin/includes/class-wp-users-list-table.php */
+               $args = apply_filters( 'users_list_table_query_args', $args );
+
                // Query the user IDs for this page
                $wp_user_search = new WP_User_Query( $args );
 
@@ -118,7 +133,7 @@ class WP_MS_Users_List_Table extends WP_List_Table {
                $class = $role != 'super' ? ' class="current"' : '';
                $role_links = array();
                $role_links['all'] = "<a href='" . network_admin_url('users.php') . "'$class>" . sprintf( _nx( 'All <span class="count">(%s)</span>', 'All <span class="count">(%s)</span>', $total_users, 'users' ), number_format_i18n( $total_users ) ) . '</a>';
-               $class = $role == 'super' ? ' class="current"' : '';
+               $class = $role === 'super' ? ' class="current"' : '';
                $role_links['super'] = "<a href='" . network_admin_url('users.php?role=super') . "'$class>" . sprintf( _n( 'Super Admin <span class="count">(%s)</span>', 'Super Admins <span class="count">(%s)</span>', $total_admins ), number_format_i18n( $total_admins ) ) . '</a>';
 
                return $role_links;
@@ -133,8 +148,9 @@ class WP_MS_Users_List_Table extends WP_List_Table {
 
                parent::pagination ( $which );
 
-               if ( 'top' == $which )
+               if ( 'top' === $which ) {
                        $this->view_switcher( $mode );
+               }
        }
 
        /**
@@ -146,7 +162,7 @@ class WP_MS_Users_List_Table extends WP_List_Table {
                        'cb'         => '<input type="checkbox" />',
                        'username'   => __( 'Username' ),
                        'name'       => __( 'Name' ),
-                       'email'      => __( 'E-mail' ),
+                       'email'      => __( 'Email' ),
                        'registered' => _x( 'Registered', 'user' ),
                        'blogs'      => __( 'Sites' )
                );
@@ -183,12 +199,27 @@ class WP_MS_Users_List_Table extends WP_List_Table {
         * @param WP_User $user The current WP_User object.
         */
        public function column_cb( $user ) {
+               if ( is_super_admin( $user->ID ) ) {
+                       return;
+               }
                ?>
                <label class="screen-reader-text" for="blog_<?php echo $user->ID; ?>"><?php echo sprintf( __( 'Select %s' ), $user->user_login ); ?></label>
                <input type="checkbox" id="blog_<?php echo $user->ID ?>" name="allusers[]" value="<?php echo esc_attr( $user->ID ) ?>" />
                <?php
        }
 
+       /**
+        * Handles the ID column output.
+        *
+        * @since 4.4.0
+        * @access public
+        *
+        * @param WP_User $user The current WP_User object.
+        */
+       public function column_id( $user ) {
+               echo $user->ID;
+       }
+
        /**
         * Handles the username column output.
         *
@@ -248,7 +279,7 @@ class WP_MS_Users_List_Table extends WP_List_Table {
         */
        public function column_registered( $user ) {
                global $mode;
-               if ( 'list' == $mode ) {
+               if ( 'list' === $mode ) {
                        $date = __( 'Y/m/d' );
                } else {
                        $date = __( 'Y/m/d g:i:s a' );
@@ -291,7 +322,7 @@ class WP_MS_Users_List_Table extends WP_List_Table {
                                continue;
                        }
 
-                       $path   = ( $val->path == '/' ) ? '' : $val->path;
+                       $path   = ( $val->path === '/' ) ? '' : $val->path;
                        echo '<span class="site-' . $val->site_id . '" >';
                        echo '<a href="'. esc_url( network_admin_url( 'site-info.php?id=' . $val->userblog_id ) ) .'">' . str_replace( '.' . get_current_site()->domain, '', $val->domain . $path ) . '</a>';
                        echo ' <small class="row-actions">';