X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/41578db67d72562346e4dbb2a14889b23d522813..refs/tags/wordpress-4.3.1:/wp-admin/includes/class-wp-plugins-list-table.php diff --git a/wp-admin/includes/class-wp-plugins-list-table.php b/wp-admin/includes/class-wp-plugins-list-table.php index 65358337..781330cb 100644 --- a/wp-admin/includes/class-wp-plugins-list-table.php +++ b/wp-admin/includes/class-wp-plugins-list-table.php @@ -9,7 +9,20 @@ */ class WP_Plugins_List_Table extends WP_List_Table { - function __construct( $args = array() ) { + /** + * Constructor. + * + * @since 3.1.0 + * @access public + * + * @see WP_List_Table::__construct() for more information on default arguments. + * + * @global string $status + * @global int $page + * + * @param array $args An associative array of arguments. + */ + public function __construct( $args = array() ) { global $status, $page; parent::__construct( array( @@ -27,15 +40,31 @@ class WP_Plugins_List_Table extends WP_List_Table { $page = $this->get_pagenum(); } - function get_table_classes() { + /** + * @return array + */ + protected function get_table_classes() { return array( 'widefat', $this->_args['plural'] ); } - function ajax_user_can() { + /** + * @return bool + */ + public function ajax_user_can() { return current_user_can('activate_plugins'); } - function prepare_items() { + /** + * + * @global string $status + * @global type $plugins + * @global array $totals + * @global int $page + * @global string $orderby + * @global string $order + * @global string $s + */ + public function prepare_items() { global $status, $plugins, $totals, $page, $orderby, $order, $s; wp_reset_vars( array( 'orderby', 'order', 's' ) ); @@ -109,7 +138,25 @@ class WP_Plugins_List_Table extends WP_List_Table { update_option( 'recently_activated', $recently_activated ); } + $plugin_info = get_site_transient( 'update_plugins' ); + foreach ( (array) $plugins['all'] as $plugin_file => $plugin_data ) { + // Extra info if known. array_merge() ensures $plugin_data has precedence if keys collide. + if ( isset( $plugin_info->response[ $plugin_file ] ) ) { + $plugins['all'][ $plugin_file ] = $plugin_data = array_merge( (array) $plugin_info->response[ $plugin_file ], $plugin_data ); + // Make sure that $plugins['upgrade'] also receives the extra info since it is used on ?plugin_status=upgrade + if ( isset( $plugins['upgrade'][ $plugin_file ] ) ) { + $plugins['upgrade'][ $plugin_file ] = $plugin_data = array_merge( (array) $plugin_info->response[ $plugin_file ], $plugin_data ); + } + + } elseif ( isset( $plugin_info->no_update[ $plugin_file ] ) ) { + $plugins['all'][ $plugin_file ] = $plugin_data = array_merge( (array) $plugin_info->no_update[ $plugin_file ], $plugin_data ); + // Make sure that $plugins['upgrade'] also receives the extra info since it is used on ?plugin_status=upgrade + if ( isset( $plugins['upgrade'][ $plugin_file ] ) ) { + $plugins['upgrade'][ $plugin_file ] = $plugin_data = array_merge( (array) $plugin_info->no_update[ $plugin_file ], $plugin_data ); + } + } + // Filter into individual sections if ( is_multisite() && ! $screen->in_admin( 'network' ) && is_network_only_plugin( $plugin_file ) && ! is_plugin_active( $plugin_file ) ) { // On the non-network screen, filter out network-only plugins as long as they're not individually activated @@ -152,13 +199,16 @@ class WP_Plugins_List_Table extends WP_List_Table { $total_this_page = $totals[ $status ]; - if ( $orderby ) { + if ( ! $orderby ) { + $orderby = 'Name'; + } else { $orderby = ucfirst( $orderby ); - $order = strtoupper( $order ); - - uasort( $this->items, array( $this, '_order_callback' ) ); } + $order = strtoupper( $order ); + + uasort( $this->items, array( $this, '_order_callback' ) ); + $plugins_per_page = $this->get_items_per_page( str_replace( '-', '_', $screen->id . '_per_page' ), 999 ); $start = ( $page - 1 ) * $plugins_per_page; @@ -172,8 +222,13 @@ class WP_Plugins_List_Table extends WP_List_Table { ) ); } - function _search_callback( $plugin ) { - static $term; + /** + * @staticvar string $term + * @param array $plugin + * @return bool + */ + public function _search_callback( $plugin ) { + static $term = null; if ( is_null( $term ) ) $term = wp_unslash( $_REQUEST['s'] ); @@ -186,7 +241,14 @@ class WP_Plugins_List_Table extends WP_List_Table { return false; } - function _order_callback( $plugin_a, $plugin_b ) { + /** + * @global string $orderby + * @global string $order + * @param array $plugin_a + * @param array $plugin_b + * @return int + */ + public function _order_callback( $plugin_a, $plugin_b ) { global $orderby, $order; $a = $plugin_a[$orderby]; @@ -195,13 +257,18 @@ class WP_Plugins_List_Table extends WP_List_Table { if ( $a == $b ) return 0; - if ( 'DESC' == $order ) - return ( $a < $b ) ? 1 : -1; - else - return ( $a < $b ) ? -1 : 1; + if ( 'DESC' == $order ) { + return strcasecmp( $b, $a ); + } else { + return strcasecmp( $a, $b ); + } } - function no_items() { + /** + * + * @global array $plugins + */ + public function no_items() { global $plugins; if ( !empty( $plugins['all'] ) ) @@ -210,7 +277,12 @@ class WP_Plugins_List_Table extends WP_List_Table { _e( 'You do not appear to have any plugins available at this time.' ); } - function get_columns() { + /** + * + * @global string $status + * @return array + */ + public function get_columns() { global $status; return array( @@ -220,11 +292,20 @@ class WP_Plugins_List_Table extends WP_List_Table { ); } - function get_sortable_columns() { + /** + * @return array + */ + protected function get_sortable_columns() { return array(); } - function get_views() { + /** + * + * @global array $totals + * @global string $status + * @return array + */ + protected function get_views() { global $totals, $status; $status_links = array(); @@ -268,7 +349,12 @@ class WP_Plugins_List_Table extends WP_List_Table { return $status_links; } - function get_bulk_actions() { + /** + * + * @global string $status + * @return array + */ + protected function get_bulk_actions() { global $status; $actions = array(); @@ -289,16 +375,24 @@ class WP_Plugins_List_Table extends WP_List_Table { return $actions; } - function bulk_actions() { + /** + * @global string $status + * @param string $which + */ + public function bulk_actions( $which = '' ) { global $status; if ( in_array( $status, array( 'mustuse', 'dropins' ) ) ) return; - parent::bulk_actions(); + parent::bulk_actions( $which ); } - function extra_tablenav( $which ) { + /** + * @global string $status + * @param string $which + */ + protected function extra_tablenav( $which ) { global $status; if ( ! in_array($status, array('recently_activated', 'mustuse', 'dropins') ) ) @@ -316,14 +410,21 @@ class WP_Plugins_List_Table extends WP_List_Table { echo ''; } - function current_action() { + /** + * @return string + */ + public function current_action() { if ( isset($_POST['clear-recent-list']) ) return 'clear-recent-list'; return parent::current_action(); } - function display_rows() { + /** + * + * @global string $status + */ + public function display_rows() { global $status; if ( is_multisite() && ! $this->screen->in_admin( 'network' ) && in_array( $status, array( 'mustuse', 'dropins' ) ) ) @@ -333,17 +434,26 @@ class WP_Plugins_List_Table extends WP_List_Table { $this->single_row( array( $plugin_file, $plugin_data ) ); } - function single_row( $item ) { + /** + * @global string $status + * @global int $page + * @global string $s + * @global array $totals + * + * @param array $item + */ + public function single_row( $item ) { global $status, $page, $s, $totals; list( $plugin_file, $plugin_data ) = $item; $context = $status; $screen = $this->screen; - // preorder + // Pre-order. $actions = array( 'deactivate' => '', 'activate' => '', + 'details' => '', 'edit' => '', 'delete' => '', ); @@ -363,7 +473,7 @@ class WP_Plugins_List_Table extends WP_List_Table { $description = '

' . $dropins[ $plugin_file ][0] . '

'; } else { $is_active = false; - $description = '

' . $dropins[ $plugin_file ][0] . ' ' . __('Inactive:') . ' ' . sprintf( __( 'Requires %s in wp-config.php.' ), "define('" . $dropins[ $plugin_file ][1] . "', true);" ) . '

'; + $description = '

' . $dropins[ $plugin_file ][0] . ' ' . __('Inactive:') . ' ' . sprintf( __( 'Requires %s in wp-config.php.' ), "define('" . $dropins[ $plugin_file ][1] . "', true);" ) . '

'; } if ( $plugin_data['Description'] ) $description .= '

' . $plugin_data['Description'] . '

'; @@ -375,27 +485,40 @@ class WP_Plugins_List_Table extends WP_List_Table { if ( $screen->in_admin( 'network' ) ) { if ( $is_active ) { - if ( current_user_can( 'manage_network_plugins' ) ) - $actions['deactivate'] = '' . __('Network Deactivate') . ''; + if ( current_user_can( 'manage_network_plugins' ) ) { + /* translators: %s: plugin name */ + $actions['deactivate'] = '' . __( 'Network Deactivate' ) . ''; + } } else { - if ( current_user_can( 'manage_network_plugins' ) ) - $actions['activate'] = '' . __('Network Activate') . ''; - if ( current_user_can( 'delete_plugins' ) && ! is_plugin_active( $plugin_file ) ) - $actions['delete'] = '' . __('Delete') . ''; + if ( current_user_can( 'manage_network_plugins' ) ) { + /* translators: %s: plugin name */ + $actions['activate'] = '' . __( 'Network Activate' ) . ''; + } + if ( current_user_can( 'delete_plugins' ) && ! is_plugin_active( $plugin_file ) ) { + /* translators: %s: plugin name */ + $actions['delete'] = '' . __( 'Delete' ) . ''; + } } } else { if ( $is_active ) { - $actions['deactivate'] = '' . __('Deactivate') . ''; + /* translators: %s: plugin name */ + $actions['deactivate'] = '' . __( 'Deactivate' ) . ''; } else { - $actions['activate'] = '' . __('Activate') . ''; + /* translators: %s: plugin name */ + $actions['activate'] = '' . __( 'Activate' ) . ''; - if ( ! is_multisite() && current_user_can('delete_plugins') ) - $actions['delete'] = '' . __('Delete') . ''; + if ( ! is_multisite() && current_user_can( 'delete_plugins' ) ) { + /* translators: %s: plugin name */ + $actions['delete'] = '' . __( 'Delete' ) . ''; + } } // end if $is_active + } // end if $screen->in_admin( 'network' ) - if ( ( ! is_multisite() || $screen->in_admin( 'network' ) ) && current_user_can('edit_plugins') && is_writable(WP_PLUGIN_DIR . '/' . $plugin_file) ) - $actions['edit'] = '' . __('Edit') . ''; + if ( ( ! is_multisite() || $screen->in_admin( 'network' ) ) && current_user_can( 'edit_plugins' ) && is_writable( WP_PLUGIN_DIR . '/' . $plugin_file ) ) { + /* translators: %s: plugin name */ + $actions['edit'] = '' . __( 'Edit' ) . ''; + } } // end if $context $prefix = $screen->in_admin( 'network' ) ? 'network_admin_' : ''; @@ -403,7 +526,7 @@ class WP_Plugins_List_Table extends WP_List_Table { /** * Filter the action links displayed for each plugin in the Plugins list table. * - * The dynamic portion of the hook name, $prefix, refers to the context the + * The dynamic portion of the hook name, `$prefix`, refers to the context the * action links are displayed in. The 'network_admin_' prefix is used if the * current screen is the Network plugins list table. The prefix is empty ('') * if the current screen is the site plugins list table. @@ -465,26 +588,34 @@ class WP_Plugins_List_Table extends WP_List_Table { if ( ! empty( $totals['upgrade'] ) && ! empty( $plugin_data['update'] ) ) $class .= ' update'; - echo ""; + $plugin_slug = ( isset( $plugin_data['slug'] ) ) ? $plugin_data['slug'] : ''; + printf( "", + $id, + $class, + $plugin_slug + ); - list( $columns, $hidden ) = $this->get_column_info(); + list( $columns, $hidden, $sortable, $primary ) = $this->get_column_info(); foreach ( $columns as $column_name => $column_display_name ) { - $style = ''; - if ( in_array( $column_name, $hidden ) ) - $style = ' style="display:none;"'; + $extra_classes = ''; + if ( in_array( $column_name, $hidden ) ) { + $extra_classes = ' hidden'; + } switch ( $column_name ) { case 'cb': echo "$checkbox"; break; case 'name': - echo "$plugin_name"; + echo "$plugin_name"; echo $this->row_actions( $actions, true ); echo ""; break; case 'description': - echo " + $classes = 'column-description desc'; + + echo "
$description
"; @@ -494,11 +625,25 @@ class WP_Plugins_List_Table extends WP_List_Table { if ( !empty( $plugin_data['Author'] ) ) { $author = $plugin_data['Author']; if ( !empty( $plugin_data['AuthorURI'] ) ) - $author = '' . $plugin_data['Author'] . ''; + $author = '' . $plugin_data['Author'] . ''; $plugin_meta[] = sprintf( __( 'By %s' ), $author ); } - if ( ! empty( $plugin_data['PluginURI'] ) ) - $plugin_meta[] = '' . __( 'Visit plugin site' ) . ''; + + // Details link using API info, if available + if ( isset( $plugin_data['slug'] ) && current_user_can( 'install_plugins' ) ) { + $plugin_meta[] = sprintf( '%s', + 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 ) ), + esc_attr( $plugin_name ), + __( 'View details' ) + ); + } elseif ( ! empty( $plugin_data['PluginURI'] ) ) { + $plugin_meta[] = sprintf( '%s', + esc_url( $plugin_data['PluginURI'] ), + __( 'Visit plugin site' ) + ); + } /** * Filter the array of row meta for each plugin in the Plugins list table. @@ -520,7 +665,9 @@ class WP_Plugins_List_Table extends WP_List_Table { echo "
"; break; default: - echo ""; + $classes = "$column_name column-$column_name$class"; + + echo ""; /** * Fires inside each custom column of the Plugins list table. @@ -532,6 +679,7 @@ class WP_Plugins_List_Table extends WP_List_Table { * @param array $plugin_data An array of plugin data. */ do_action( 'manage_plugins_custom_column', $column_name, $plugin_file, $plugin_data ); + echo ""; } } @@ -554,7 +702,7 @@ class WP_Plugins_List_Table extends WP_List_Table { /** * Fires after each specific row in the Plugins list table. * - * The dynamic portion of the hook name, $plugin_file, refers to the path + * 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 @@ -567,4 +715,16 @@ class WP_Plugins_List_Table extends WP_List_Table { */ do_action( "after_plugin_row_$plugin_file", $plugin_file, $plugin_data, $status ); } + + /** + * Gets the name of the primary column for this specific list table. + * + * @since 4.3.0 + * @access protected + * + * @return string Unalterable name for the primary column, in this case, 'name'. + */ + protected function get_primary_column_name() { + return 'name'; + } }