]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/class-wp-plugin-install-list-table.php
WordPress 4.3
[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-plugin-install-list-table.php
index 07bfa0c7234178ef9ff085c22c0ce1f9a0578b48..45a525128573a080272744892d17d61a2c4a6d2a 100644 (file)
@@ -9,10 +9,16 @@
  */
 class WP_Plugin_Install_List_Table extends WP_List_Table {
 
-       var $order = 'ASC';
-       var $orderby = null;
-       var $groups = array();
+       public $order = 'ASC';
+       public $orderby = null;
+       public $groups = array();
 
+       private $error;
+
+       /**
+        *
+        * @return bool
+        */
        public function ajax_user_can() {
                return current_user_can('install_plugins');
        }
@@ -26,6 +32,8 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
         *
         * @since 4.0.0
         * @access protected
+        *
+        * @return array
         */
        protected function get_installed_plugin_slugs() {
                $slugs = array();
@@ -46,6 +54,15 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                return $slugs;
        }
 
+       /**
+        *
+        * @global array  $tabs
+        * @global string $tab
+        * @global int    $paged
+        * @global string $type
+        * @global string $term
+        * @global string $wp_version
+        */
        public function prepare_items() {
                include( ABSPATH . 'wp-admin/includes/plugin-install.php' );
 
@@ -82,8 +99,8 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                 *
                 * @since 2.7.0
                 *
-                * @param array $tabs The tabs shown on the Plugin Install screen. Defaults are 'dashboard', 'search',
-                *                    'upload', 'featured', 'popular', 'new', and 'favorites'.
+                * @param array $tabs The tabs shown on the Plugin Install screen. Defaults include 'featured', 'popular',
+                *                    'recommended', 'favorites', and 'upload'.
                 */
                $tabs = apply_filters( 'install_plugins_tabs', $tabs );
 
@@ -103,7 +120,11 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                $args = array(
                        'page' => $paged,
                        'per_page' => $per_page,
-                       'fields' => array( 'last_updated' => true, 'downloaded' => true, 'icons' => true ),
+                       'fields' => array(
+                               'last_updated' => true,
+                               'icons' => true,
+                               'active_installs' => true
+                       ),
                        // Send the locale and installed plugin slugs to the API so it can provide context-sensitive results.
                        'locale' => get_locale(),
                        'installed_plugins' => $this->get_installed_plugin_slugs(),
@@ -159,8 +180,7 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                 * Filter API request arguments for each Plugin Install screen tab.
                 *
                 * The dynamic portion of the hook name, `$tab`, refers to the plugin install tabs.
-                * Default tabs are 'dashboard', 'search', 'upload', 'featured', 'popular', 'new',
-                * and 'favorites'.
+                * Default tabs include 'featured', 'popular', 'recommended', 'favorites', and 'upload'.
                 *
                 * @since 3.7.0
                 *
@@ -194,6 +214,9 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                }
        }
 
+       /**
+        * @access public
+        */
        public function no_items() {
                if ( isset( $this->error ) ) {
                        $message = $this->error->get_error_message() . '<p class="hide-if-no-js"><a href="#" class="button" onclick="document.location.reload(); return false;">' . __( 'Try again' ) . '</a></p>';
@@ -203,6 +226,13 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                echo '<div class="no-plugin-results">' . $message . '</div>';
        }
 
+       /**
+        *
+        * @global array $tabs
+        * @global string $tab
+        *
+        * @return array
+        */
        protected function get_views() {
                global $tabs, $tab;
 
@@ -271,6 +301,8 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
        }
 
        /**
+        * @global string $tab
+        *
         * @param string $which
         */
        protected function display_tablenav( $which ) {
@@ -303,10 +335,16 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                }
        }
 
+       /**
+        * @return array
+        */
        protected function get_table_classes() {
                return array( 'widefat', $this->_args['plural'] );
        }
 
+       /**
+        * @return array
+        */
        public function get_columns() {
                return array();
        }
@@ -336,6 +374,9 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                }
        }
 
+       /**
+        * @global string $wp_version
+        */
        public function display_rows() {
                $plugins_allowedtags = array(
                        'a' => array( 'href' => array(),'title' => array(), 'target' => array() ),
@@ -401,14 +442,14 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                                        case 'install':
                                                if ( $status['url'] ) {
                                                        /* translators: 1: Plugin name and version. */
-                                                       $action_links[] = '<a class="install-now button" href="' . $status['url'] . '" aria-label="' . esc_attr( sprintf( __( 'Install %s now' ), $name ) ) . '">' . __( 'Install Now' ) . '</a>';
+                                                       $action_links[] = '<a class="install-now button" data-slug="' . esc_attr( $plugin['slug'] ) . '" href="' . esc_url( $status['url'] ) . '" aria-label="' . esc_attr( sprintf( __( 'Install %s now' ), $name ) ) . '" data-name="' . esc_attr( $name ) . '">' . __( 'Install Now' ) . '</a>';
                                                }
 
                                                break;
                                        case 'update_available':
                                                if ( $status['url'] ) {
                                                        /* translators: 1: Plugin name and version */
-                                                       $action_links[] = '<a class="button" href="' . $status['url'] . '" aria-label="' . esc_attr( sprintf( __( 'Update %s now' ), $name ) ) . '">' . __( 'Update Now' ) . '</a>';
+                                                       $action_links[] = '<a class="update-now button" data-plugin="' . esc_attr( $status['file'] ) . '" data-slug="' . esc_attr( $plugin['slug'] ) . '" href="' . esc_url( $status['url'] ) . '" aria-label="' . esc_attr( sprintf( __( 'Update %s now' ), $name ) ) . '" data-name="' . esc_attr( $name ) . '">' . __( 'Update Now' ) . '</a>';
                                                }
 
                                                break;
@@ -444,8 +485,11 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                         * @param array $plugin       The plugin currently being listed.
                         */
                        $action_links = apply_filters( 'plugin_install_action_links', $action_links, $plugin );
+
+                       $date_format = __( 'M j, Y @ H:i' );
+                       $last_updated_timestamp = strtotime( $plugin['last_updated'] );
                ?>
-               <div class="plugin-card">
+               <div class="plugin-card plugin-card-<?php echo sanitize_html_class( $plugin['slug'] ); ?>">
                        <div class="plugin-card-top">
                                <a href="<?php echo esc_url( $details_link ); ?>" class="thickbox plugin-icon"><img src="<?php echo esc_attr( $plugin_icon_url ) ?>" /></a>
                                <div class="name column-name">
@@ -469,12 +513,19 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
                                        <span class="num-ratings">(<?php echo number_format_i18n( $plugin['num_ratings'] ); ?>)</span>
                                </div>
                                <div class="column-updated">
-                                       <strong><?php _e( 'Last Updated:' ); ?></strong> <span title="<?php echo esc_attr( $plugin['last_updated'] ); ?>">
-                                               <?php printf( __( '%s ago' ), human_time_diff( strtotime( $plugin['last_updated'] ) ) ); ?>
+                                       <strong><?php _e( 'Last Updated:' ); ?></strong> <span title="<?php echo esc_attr( date_i18n( $date_format, $last_updated_timestamp ) ); ?>">
+                                               <?php printf( __( '%s ago' ), human_time_diff( $last_updated_timestamp ) ); ?>
                                        </span>
                                </div>
                                <div class="column-downloaded">
-                                       <?php echo sprintf( _n( '%s download', '%s downloads', $plugin['downloaded'] ), number_format_i18n( $plugin['downloaded'] ) ); ?>
+                                       <?php
+                                       if ( $plugin['active_installs'] >= 1000000 ) {
+                                               $active_installs_text = _x( '1+ Million', 'Active plugin installs' );
+                                       } else {
+                                               $active_installs_text = number_format_i18n( $plugin['active_installs'] ) . '+';
+                                       }
+                                       printf( __( '%s Active Installs' ), $active_installs_text );
+                                       ?>
                                </div>
                                <div class="column-compatibility">
                                        <?php