<?php
/**
- * Plugin Installer List Table class.
+ * List Table API: WP_Plugin_Install_List_Table class
*
* @package WordPress
- * @subpackage List_Table
+ * @subpackage Administration
+ * @since 3.1.0
+ */
+
+/**
+ * Core class used to implement displaying plugins to install in a list table.
+ *
* @since 3.1.0
* @access private
+ *
+ * @see WP_List_Table
*/
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');
}
*
* @since 4.0.0
* @access protected
+ *
+ * @return array
*/
protected function get_installed_plugin_slugs() {
$slugs = array();
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' );
// These are the tabs which are shown on the page
$tabs = array();
- if ( 'search' == $tab )
+ if ( 'search' === $tab ) {
$tabs['search'] = __( 'Search Results' );
+ }
$tabs['featured'] = _x( 'Featured', 'Plugin Installer' );
$tabs['popular'] = _x( 'Popular', 'Plugin Installer' );
$tabs['recommended'] = _x( 'Recommended', 'Plugin Installer' );
*
* @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 );
$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(),
* 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
*
}
}
+ /**
+ * @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>';
echo '<div class="no-plugin-results">' . $message . '</div>';
}
+ /**
+ *
+ * @global array $tabs
+ * @global string $tab
+ *
+ * @return array
+ */
protected function get_views() {
global $tabs, $tab;
$display_tabs = array();
foreach ( (array) $tabs as $action => $text ) {
- $class = ( $action == $tab ) ? ' current' : '';
+ $class = ( $action === $tab ) ? ' current' : '';
$href = self_admin_url('plugin-install.php?tab=' . $action);
$display_tabs['plugin-install-'.$action] = "<a href='$href' class='$class'>$text</a>";
}
/** This filter is documented in wp-admin/inclues/class-wp-list-table.php */
$views = apply_filters( "views_{$this->screen->id}", $views );
+ $this->screen->render_screen_reader_content( 'heading_views' );
?>
<div class="wp-filter">
<ul class="filter-links">
?>
<div class="wp-list-table <?php echo implode( ' ', $this->get_table_classes() ); ?>">
-
+<?php
+ $this->screen->render_screen_reader_content( 'heading_list' );
+?>
<div id="the-list"<?php echo $data_attr; ?>>
<?php $this->display_rows_or_placeholder(); ?>
</div>
}
/**
+ * @global string $tab
+ *
* @param string $which
*/
protected function display_tablenav( $which ) {
return;
}
- if ( 'top' == $which ) {
+ if ( 'top' === $which ) {
wp_referer_field();
?>
<div class="tablenav top">
}
}
+ /**
+ * @return array
+ */
protected function get_table_classes() {
return array( 'widefat', $this->_args['plural'] );
}
+ /**
+ * @return array
+ */
public function get_columns() {
return array();
}
return 0;
}
- if ( 'DESC' == $this->order ) {
+ if ( 'DESC' === $this->order ) {
return ( $a < $b ) ? 1 : -1;
} else {
return ( $a < $b ) ? -1 : 1;
}
}
+ /**
+ * @global string $wp_version
+ */
public function display_rows() {
$plugins_allowedtags = array(
'a' => array( 'href' => array(),'title' => array(), 'target' => array() ),
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;
* @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">
- <h4><a href="<?php echo esc_url( $details_link ); ?>" class="thickbox"><?php echo $title; ?></a></h4>
+ <h3>
+ <a href="<?php echo esc_url( $details_link ); ?>" class="thickbox">
+ <?php echo $title; ?>
+ <img src="<?php echo esc_attr( $plugin_icon_url ) ?>" class="plugin-icon" alt="">
+ </a>
+ </h3>
</div>
<div class="action-links">
<?php
<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