]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/class-wp-plugins-list-table.php
WordPress 4.7
[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-plugins-list-table.php
index f87f3218bdec85d88c8f24f057294ae0b569ca7a..136fbd4c73068481e6db58f97b7cf52818c964b3 100644 (file)
@@ -65,7 +65,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
        /**
         *
         * @global string $status
-        * @global type   $plugins
+        * @global array  $plugins
         * @global array  $totals
         * @global int    $page
         * @global string $orderby
@@ -75,26 +75,28 @@ class WP_Plugins_List_Table extends WP_List_Table {
        public function prepare_items() {
                global $status, $plugins, $totals, $page, $orderby, $order, $s;
 
-               wp_reset_vars( array( 'orderby', 'order', 's' ) );
+               wp_reset_vars( array( 'orderby', 'order' ) );
 
                /**
-                * Filter the full array of plugins to list in the Plugins list table.
+                * Filters the full array of plugins to list in the Plugins list table.
                 *
                 * @since 3.0.0
                 *
                 * @see get_plugins()
                 *
-                * @param array $plugins An array of plugins to display in the list table.
+                * @param array $all_plugins An array of plugins to display in the list table.
                 */
+               $all_plugins = apply_filters( 'all_plugins', get_plugins() );
+
                $plugins = array(
-                       'all' => apply_filters( 'all_plugins', get_plugins() ),
-                       'search' => array(),
-                       'active' => array(),
-                       'inactive' => array(),
+                       'all'                => $all_plugins,
+                       'search'             => array(),
+                       'active'             => array(),
+                       'inactive'           => array(),
                        'recently_activated' => array(),
-                       'upgrade' => array(),
-                       'mustuse' => array(),
-                       'dropins' => array()
+                       'upgrade'            => array(),
+                       'mustuse'            => array(),
+                       'dropins'            => array(),
                );
 
                $screen = $this->screen;
@@ -102,7 +104,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
                if ( ! is_multisite() || ( $screen->in_admin( 'network' ) && current_user_can( 'manage_network_plugins' ) ) ) {
 
                        /**
-                        * Filter whether to display the advanced plugins list table.
+                        * Filters whether to display the advanced plugins list table.
                         *
                         * There are two types of advanced plugins - must-use and drop-ins -
                         * which can be used in a single site or Multisite network.
@@ -138,7 +140,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
                if ( ! $screen->in_admin( 'network' ) ) {
                        $show = current_user_can( 'manage_network_plugins' );
                        /**
-                        * Filter whether to display network-active plugins alongside plugins active for the current site.
+                        * Filters whether to display network-active plugins alongside plugins active for the current site.
                         *
                         * This also controls the display of inactive network-only plugins (plugins with
                         * "Network: true" in the plugin header).
@@ -224,7 +226,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
                        }
                }
 
-               if ( $s ) {
+               if ( strlen( $s ) ) {
                        $status = 'search';
                        $plugins['search'] = array_filter( $plugins['all'], array( $this, '_search_callback' ) );
                }
@@ -244,6 +246,16 @@ class WP_Plugins_List_Table extends WP_List_Table {
 
                $total_this_page = $totals[ $status ];
 
+               $js_plugins = array();
+               foreach ( $plugins as $key => $list ) {
+                       $js_plugins[ $key ] = array_keys( (array) $list );
+               }
+
+               wp_localize_script( 'updates', '_wpUpdatesItemCounts', array(
+                       'plugins' => $js_plugins,
+                       'totals'  => wp_get_update_data(),
+               ) );
+
                if ( ! $orderby ) {
                        $orderby = 'Name';
                } else {
@@ -268,17 +280,16 @@ class WP_Plugins_List_Table extends WP_List_Table {
        }
 
        /**
-        * @staticvar string $term
+        * @global string $s URL encoded search term.
+        *
         * @param array $plugin
         * @return bool
         */
        public function _search_callback( $plugin ) {
-               static $term = null;
-               if ( is_null( $term ) )
-                       $term = wp_unslash( $_REQUEST['s'] );
+               global $s;
 
                foreach ( $plugin as $value ) {
-                       if ( false !== stripos( strip_tags( $value ), $term ) ) {
+                       if ( is_string( $value ) && false !== stripos( strip_tags( $value ), urldecode( $s ) ) ) {
                                return true;
                        }
                }
@@ -316,12 +327,52 @@ class WP_Plugins_List_Table extends WP_List_Table {
        public function no_items() {
                global $plugins;
 
-               if ( !empty( $plugins['all'] ) )
+               if ( ! empty( $_REQUEST['s'] ) ) {
+                       $s = esc_html( wp_unslash( $_REQUEST['s'] ) );
+
+                       printf( __( 'No plugins found for “%s”.' ), $s );
+
+                       // We assume that somebody who can install plugins in multisite is experienced enough to not need this helper link.
+                       if ( ! is_multisite() && current_user_can( 'install_plugins' ) ) {
+                               echo ' <a href="' . esc_url( admin_url( 'plugin-install.php?tab=search&s=' . urlencode( $s ) ) ) . '">' . __( 'Search for plugins in the WordPress Plugin Directory.' ) . '</a>';
+                       }
+               } elseif ( ! empty( $plugins['all'] ) )
                        _e( 'No plugins found.' );
                else
                        _e( 'You do not appear to have any plugins available at this time.' );
        }
 
+       /**
+        * Displays the search box.
+        *
+        * @since 4.6.0
+        * @access public
+        *
+        * @param string $text     The 'submit' button label.
+        * @param string $input_id ID attribute value for the search input field.
+        */
+       public function search_box( $text, $input_id ) {
+               if ( empty( $_REQUEST['s'] ) && ! $this->has_items() ) {
+                       return;
+               }
+
+               $input_id = $input_id . '-search-input';
+
+               if ( ! empty( $_REQUEST['orderby'] ) ) {
+                       echo '<input type="hidden" name="orderby" value="' . esc_attr( $_REQUEST['orderby'] ) . '" />';
+               }
+               if ( ! empty( $_REQUEST['order'] ) ) {
+                       echo '<input type="hidden" name="order" value="' . esc_attr( $_REQUEST['order'] ) . '" />';
+               }
+               ?>
+               <p class="search-box">
+                       <label class="screen-reader-text" for="<?php echo esc_attr( $input_id ); ?>"><?php echo $text; ?>:</label>
+                       <input type="search" id="<?php echo esc_attr( $input_id ); ?>" class="wp-filter-search" name="s" value="<?php _admin_search_query(); ?>" placeholder="<?php esc_attr_e( 'Search installed plugins...' ); ?>"/>
+                       <?php submit_button( $text, 'hide-if-js', '', false, array( 'id' => 'search-submit' ) ); ?>
+               </p>
+               <?php
+       }
+
        /**
         *
         * @global string $status
@@ -446,7 +497,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
                echo '<div class="alignleft actions">';
 
                if ( 'recently_activated' == $status ) {
-                       submit_button( __( 'Clear List' ), 'button', 'clear-recent-list', false );
+                       submit_button( __( 'Clear List' ), '', 'clear-recent-list', false );
                } elseif ( 'top' === $which && 'mustuse' === $status ) {
                        /* translators: %s: mu-plugins directory name */
                        echo '<p>' . sprintf( __( 'Files in the %s directory are executed automatically.' ),
@@ -550,16 +601,16 @@ class WP_Plugins_List_Table extends WP_List_Table {
                                if ( $is_active ) {
                                        if ( current_user_can( 'manage_network_plugins' ) ) {
                                                /* translators: %s: plugin name */
-                                               $actions['deactivate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=deactivate&amp;plugin=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'deactivate-plugin_' . $plugin_file ) . '" aria-label="' . esc_attr( sprintf( __( 'Network deactivate %s' ), $plugin_data['Name'] ) ) . '">' . __( 'Network Deactivate' ) . '</a>';
+                                               $actions['deactivate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=deactivate&amp;plugin=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'deactivate-plugin_' . $plugin_file ) . '" aria-label="' . esc_attr( sprintf( _x( 'Network Deactivate %s', 'plugin' ), $plugin_data['Name'] ) ) . '">' . __( 'Network Deactivate' ) . '</a>';
                                                }
                                } else {
                                        if ( current_user_can( 'manage_network_plugins' ) ) {
                                                /* translators: %s: plugin name */
-                                               $actions['activate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=activate&amp;plugin=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'activate-plugin_' . $plugin_file ) . '" class="edit" aria-label="' . esc_attr( sprintf( __( 'Network Activate %s' ), $plugin_data['Name'] ) ) . '">' . __( 'Network Activate' ) . '</a>';
+                                               $actions['activate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=activate&amp;plugin=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'activate-plugin_' . $plugin_file ) . '" class="edit" aria-label="' . esc_attr( sprintf( _x( 'Network Activate %s', 'plugin' ), $plugin_data['Name'] ) ) . '">' . __( 'Network Activate' ) . '</a>';
                                        }
                                        if ( current_user_can( 'delete_plugins' ) && ! is_plugin_active( $plugin_file ) ) {
                                                /* translators: %s: plugin name */
-                                               $actions['delete'] = '<a href="' . wp_nonce_url( 'plugins.php?action=delete-selected&amp;checked[]=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'bulk-plugins' ) . '" class="delete" aria-label="' . esc_attr( sprintf( __( 'Delete %s' ), $plugin_data['Name'] ) ) . '">' . __( 'Delete' ) . '</a>';
+                                               $actions['delete'] = '<a href="' . wp_nonce_url( 'plugins.php?action=delete-selected&amp;checked[]=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'bulk-plugins' ) . '" class="delete" aria-label="' . esc_attr( sprintf( _x( 'Delete %s', 'plugin' ), $plugin_data['Name'] ) ) . '">' . __( 'Delete' ) . '</a>';
                                        }
                                }
                        } else {
@@ -573,14 +624,14 @@ class WP_Plugins_List_Table extends WP_List_Table {
                                        );
                                } elseif ( $is_active ) {
                                        /* translators: %s: plugin name */
-                                       $actions['deactivate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=deactivate&amp;plugin=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'deactivate-plugin_' . $plugin_file ) . '" aria-label="' . esc_attr( sprintf( __( 'Deactivate %s' ), $plugin_data['Name'] ) ) . '">' . __( 'Deactivate' ) . '</a>';
+                                       $actions['deactivate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=deactivate&amp;plugin=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'deactivate-plugin_' . $plugin_file ) . '" aria-label="' . esc_attr( sprintf( _x( 'Deactivate %s', 'plugin' ), $plugin_data['Name'] ) ) . '">' . __( 'Deactivate' ) . '</a>';
                                } else {
                                        /* translators: %s: plugin name */
-                                       $actions['activate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=activate&amp;plugin=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'activate-plugin_' . $plugin_file ) . '" class="edit" aria-label="' . esc_attr( sprintf( __( 'Activate %s' ), $plugin_data['Name'] ) ) . '">' . __( 'Activate' ) . '</a>';
+                                       $actions['activate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=activate&amp;plugin=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'activate-plugin_' . $plugin_file ) . '" class="edit" aria-label="' . esc_attr( sprintf( _x( 'Activate %s', 'plugin' ), $plugin_data['Name'] ) ) . '">' . __( 'Activate' ) . '</a>';
 
                                        if ( ! is_multisite() && current_user_can( 'delete_plugins' ) ) {
                                                /* translators: %s: plugin name */
-                                               $actions['delete'] = '<a href="' . wp_nonce_url( 'plugins.php?action=delete-selected&amp;checked[]=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'bulk-plugins' ) . '" class="delete" aria-label="' . esc_attr( sprintf( __( 'Delete %s' ), $plugin_data['Name'] ) ) . '">' . __( 'Delete' ) . '</a>';
+                                               $actions['delete'] = '<a href="' . wp_nonce_url( 'plugins.php?action=delete-selected&amp;checked[]=' . $plugin_file . '&amp;plugin_status=' . $context . '&amp;paged=' . $page . '&amp;s=' . $s, 'bulk-plugins' ) . '" class="delete" aria-label="' . esc_attr( sprintf( _x( 'Delete %s', 'plugin' ), $plugin_data['Name'] ) ) . '">' . __( 'Delete' ) . '</a>';
                                        }
                                } // end if $is_active
 
@@ -597,13 +648,12 @@ class WP_Plugins_List_Table extends WP_List_Table {
                if ( $screen->in_admin( 'network' ) ) {
 
                        /**
-                        * Filter the action links displayed for each plugin in the Network Admin Plugins list table.
+                        * Filters the action links displayed for each plugin in the Network Admin Plugins list table.
                         *
                         * The default action links for the Network plugins list table include
                         * 'Network Activate', 'Network Deactivate', 'Edit', and 'Delete'.
                         *
-                        * @since 3.1.0 As `{$prefix}_plugin_action_links`
-                        * @since 4.4.0
+                        * @since 3.1.0
                         *
                         * @param array  $actions     An array of plugin action links.
                         * @param string $plugin_file Path to the plugin file relative to the plugins directory.
@@ -615,13 +665,12 @@ class WP_Plugins_List_Table extends WP_List_Table {
                        $actions = apply_filters( 'network_admin_plugin_action_links', $actions, $plugin_file, $plugin_data, $context );
 
                        /**
-                        * Filter the list of action links displayed for a specific plugin in the Network Admin Plugins list table.
+                        * Filters the list of action links displayed for a specific plugin in the Network Admin Plugins list table.
                         *
                         * The dynamic portion of the hook name, $plugin_file, refers to the path
                         * to the plugin file, relative to the plugins directory.
                         *
-                        * @since 3.1.0 As `{$prefix}_plugin_action_links_{$plugin_file}`
-                        * @since 4.4.0
+                        * @since 3.1.0
                         *
                         * @param array  $actions     An array of plugin action links.
                         * @param string $plugin_file Path to the plugin file relative to the plugins directory.
@@ -635,14 +684,14 @@ class WP_Plugins_List_Table extends WP_List_Table {
                } else {
 
                        /**
-                        * Filter the action links displayed for each plugin in the Plugins list table.
+                        * Filters the action links displayed for each plugin in the Plugins list table.
                         *
                         * The default action links for the site plugins list table include
                         * 'Activate', 'Deactivate', and 'Edit', for a network site, and
                         * 'Activate', 'Deactivate', 'Edit', and 'Delete' for a single site.
                         *
-                        * @since 2.5.0 As `{$prefix}_plugin_action_links`
-                        * @since 4.4.0
+                        * @since 2.5.0
+                        * @since 2.6.0 The `$context` parameter was added.
                         *
                         * @param array  $actions     An array of plugin action links.
                         * @param string $plugin_file Path to the plugin file relative to the plugins directory.
@@ -654,13 +703,12 @@ class WP_Plugins_List_Table extends WP_List_Table {
                        $actions = apply_filters( 'plugin_action_links', $actions, $plugin_file, $plugin_data, $context );
 
                        /**
-                        * Filter the list of action links displayed for a specific plugin in the Plugins list table.
+                        * Filters the list of action links displayed for a specific plugin in the Plugins list table.
                         *
                         * The dynamic portion of the hook name, $plugin_file, refers to the path
                         * to the plugin file, relative to the plugins directory.
                         *
-                        * @since 2.7.0 As `{$prefix}_plugin_action_links_{$plugin_file}`
-                        * @since 4.4.0
+                        * @since 2.7.0
                         *
                         * @param array  $actions     An array of plugin action links.
                         * @param string $plugin_file Path to the plugin file relative to the plugins directory.
@@ -686,15 +734,14 @@ class WP_Plugins_List_Table extends WP_List_Table {
                        $plugin_name = $plugin_data['Name'];
                }
 
-               $id = sanitize_title( $plugin_name );
                if ( ! empty( $totals['upgrade'] ) && ! empty( $plugin_data['update'] ) )
                        $class .= ' update';
 
-               $plugin_slug = ( isset( $plugin_data['slug'] ) ) ? $plugin_data['slug'] : '';
-               printf( "<tr id='%s' class='%s' data-slug='%s'>",
-                       $id,
-                       $class,
-                       $plugin_slug
+               $plugin_slug = isset( $plugin_data['slug'] ) ? $plugin_data['slug'] : sanitize_title( $plugin_name );
+               printf( '<tr class="%s" data-slug="%s" data-plugin="%s">',
+                       esc_attr( $class ),
+                       esc_attr( $plugin_slug ),
+                       esc_attr( $plugin_file )
                );
 
                list( $columns, $hidden, $sortable, $primary ) = $this->get_column_info();
@@ -733,7 +780,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
 
                                        // Details link using API info, if available
                                        if ( isset( $plugin_data['slug'] ) && current_user_can( 'install_plugins' ) ) {
-                                               $plugin_meta[] = sprintf( '<a href="%s" class="thickbox" aria-label="%s" data-title="%s">%s</a>',
+                                               $plugin_meta[] = sprintf( '<a href="%s" class="thickbox open-plugin-details-modal" aria-label="%s" data-title="%s">%s</a>',
                                                        esc_url( network_admin_url( 'plugin-install.php?tab=plugin-information&plugin=' . $plugin_data['slug'] .
                                                                '&TB_iframe=true&width=600&height=550' ) ),
                                                        esc_attr( sprintf( __( 'More information about %s' ), $plugin_name ) ),
@@ -748,7 +795,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
                                        }
 
                                        /**
-                                        * Filter the array of row meta for each plugin in the Plugins list table.
+                                        * Filters the array of row meta for each plugin in the Plugins list table.
                                         *
                                         * @since 2.8.0
                                         *
@@ -767,7 +814,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
                                        echo "</div></td>";
                                        break;
                                default:
-                                       $classes = "$column_name column-$column_name$class";
+                                       $classes = "$column_name column-$column_name $class";
 
                                        echo "<td class='$classes{$extra_classes}'>";
 
@@ -815,7 +862,7 @@ class WP_Plugins_List_Table extends WP_List_Table {
                 *                            'Inactive', 'Recently Activated', 'Upgrade', 'Must-Use',
                 *                            'Drop-ins', 'Search'.
                 */
-               do_action( "after_plugin_row_$plugin_file", $plugin_file, $plugin_data, $status );
+               do_action( "after_plugin_row_{$plugin_file}", $plugin_file, $plugin_data, $status );
        }
 
        /**