wp-admin/includes/class-wp-plugins-list-table.php

   1 <?php
   2 /**
   3  * Plugins List Table class.
   4  *
   5  * @package WordPress
   6  * @subpackage List_Table
   7  * @since 3.1.0
   8  * @access private
   9  */
  10 class WP_Plugins_List_Table extends WP_List_Table {
  11
  12         /**
  13          * Constructor.
  14          *
  15          * @since 3.1.0
  16          * @access public
  17          *
  18          * @see WP_List_Table::__construct() for more information on default arguments.
  19          *
  20          * @global string $status
  21          * @global int    $page
  22          *
  23          * @param array $args An associative array of arguments.
  24          */
  25         public function __construct( $args = array() ) {
  26                 global $status, $page;
  27
  28                 parent::__construct( array(
  29                         'plural' => 'plugins',
  30                         'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
  31                 ) );
  32
  33                 $status = 'all';
  34                 if ( isset( $_REQUEST['plugin_status'] ) && in_array( $_REQUEST['plugin_status'], array( 'active', 'inactive', 'recently_activated', 'upgrade', 'mustuse', 'dropins', 'search' ) ) )
  35                         $status = $_REQUEST['plugin_status'];
  36
  37                 if ( isset($_REQUEST['s']) )
  38                         $_SERVER['REQUEST_URI'] = add_query_arg('s', wp_unslash($_REQUEST['s']) );
  39
  40                 $page = $this->get_pagenum();
  41         }
  42
  43         /**
  44          * @return array
  45          */
  46         protected function get_table_classes() {
  47                 return array( 'widefat', $this->_args['plural'] );
  48         }
  49
  50         /**
  51          * @return bool
  52          */
  53         public function ajax_user_can() {
  54                 return current_user_can('activate_plugins');
  55         }
  56
  57         /**
  58          *
  59          * @global string $status
  60          * @global type   $plugins
  61          * @global array  $totals
  62          * @global int    $page
  63          * @global string $orderby
  64          * @global string $order
  65          * @global string $s
  66          */
  67         public function prepare_items() {
  68                 global $status, $plugins, $totals, $page, $orderby, $order, $s;
  69
  70                 wp_reset_vars( array( 'orderby', 'order', 's' ) );
  71
  72                 /**
  73                  * Filter the full array of plugins to list in the Plugins list table.
  74                  *
  75                  * @since 3.0.0
  76                  *
  77                  * @see get_plugins()
  78                  *
  79                  * @param array $plugins An array of plugins to display in the list table.
  80                  */
  81                 $plugins = array(
  82                         'all' => apply_filters( 'all_plugins', get_plugins() ),
  83                         'search' => array(),
  84                         'active' => array(),
  85                         'inactive' => array(),
  86                         'recently_activated' => array(),
  87                         'upgrade' => array(),
  88                         'mustuse' => array(),
  89                         'dropins' => array()
  90                 );
  91
  92                 $screen = $this->screen;
  93
  94                 if ( ! is_multisite() || ( $screen->in_admin( 'network' ) && current_user_can( 'manage_network_plugins' ) ) ) {
  95
  96                         /**
  97                          * Filter whether to display the advanced plugins list table.
  98                          *
  99                          * There are two types of advanced plugins - must-use and drop-ins -
 100                          * which can be used in a single site or Multisite network.
 101                          *
 102                          * The $type parameter allows you to differentiate between the type of advanced
 103                          * plugins to filter the display of. Contexts include 'mustuse' and 'dropins'.
 104                          *
 105                          * @since 3.0.0
 106                          *
 107                          * @param bool   $show Whether to show the advanced plugins for the specified
 108                          *                     plugin type. Default true.
 109                          * @param string $type The plugin type. Accepts 'mustuse', 'dropins'.
 110                          */
 111                         if ( apply_filters( 'show_advanced_plugins', true, 'mustuse' ) ) {
 112                                 $plugins['mustuse'] = get_mu_plugins();
 113                         }
 114
 115                         /** This action is documented in wp-admin/includes/class-wp-plugins-list-table.php */
 116                         if ( apply_filters( 'show_advanced_plugins', true, 'dropins' ) )
 117                                 $plugins['dropins'] = get_dropins();
 118
 119                         if ( current_user_can( 'update_plugins' ) ) {
 120                                 $current = get_site_transient( 'update_plugins' );
 121                                 foreach ( (array) $plugins['all'] as $plugin_file => $plugin_data ) {
 122                                         if ( isset( $current->response[ $plugin_file ] ) ) {
 123                                                 $plugins['all'][ $plugin_file ]['update'] = true;
 124                                                 $plugins['upgrade'][ $plugin_file ] = $plugins['all'][ $plugin_file ];
 125                                         }
 126                                 }
 127                         }
 128                 }
 129
 130                 set_transient( 'plugin_slugs', array_keys( $plugins['all'] ), DAY_IN_SECONDS );
 131
 132                 if ( ! $screen->in_admin( 'network' ) ) {
 133                         $recently_activated = get_option( 'recently_activated', array() );
 134
 135                         foreach ( $recently_activated as $key => $time )
 136                                 if ( $time + WEEK_IN_SECONDS < time() )
 137                                         unset( $recently_activated[$key] );
 138                         update_option( 'recently_activated', $recently_activated );
 139                 }
 140
 141                 $plugin_info = get_site_transient( 'update_plugins' );
 142
 143                 foreach ( (array) $plugins['all'] as $plugin_file => $plugin_data ) {
 144                         // Extra info if known. array_merge() ensures $plugin_data has precedence if keys collide.
 145                         if ( isset( $plugin_info->response[ $plugin_file ] ) ) {
 146                                 $plugins['all'][ $plugin_file ] = $plugin_data = array_merge( (array) $plugin_info->response[ $plugin_file ], $plugin_data );
 147                                 // Make sure that $plugins['upgrade'] also receives the extra info since it is used on ?plugin_status=upgrade
 148                                 if ( isset( $plugins['upgrade'][ $plugin_file ] ) ) {
 149                                         $plugins['upgrade'][ $plugin_file ] = $plugin_data = array_merge( (array) $plugin_info->response[ $plugin_file ], $plugin_data );
 150                                 }
 151
 152                         } elseif ( isset( $plugin_info->no_update[ $plugin_file ] ) ) {
 153                                 $plugins['all'][ $plugin_file ] = $plugin_data = array_merge( (array) $plugin_info->no_update[ $plugin_file ], $plugin_data );
 154                                 // Make sure that $plugins['upgrade'] also receives the extra info since it is used on ?plugin_status=upgrade
 155                                 if ( isset( $plugins['upgrade'][ $plugin_file ] ) ) {
 156                                         $plugins['upgrade'][ $plugin_file ] = $plugin_data = array_merge( (array) $plugin_info->no_update[ $plugin_file ], $plugin_data );
 157                                 }
 158                         }
 159
 160                         // Filter into individual sections
 161                         if ( is_multisite() && ! $screen->in_admin( 'network' ) && is_network_only_plugin( $plugin_file ) && ! is_plugin_active( $plugin_file ) ) {
 162                                 // On the non-network screen, filter out network-only plugins as long as they're not individually activated
 163                                 unset( $plugins['all'][ $plugin_file ] );
 164                         } elseif ( ! $screen->in_admin( 'network' ) && is_plugin_active_for_network( $plugin_file ) ) {
 165                                 // On the non-network screen, filter out network activated plugins
 166                                 unset( $plugins['all'][ $plugin_file ] );
 167                         } elseif ( ( ! $screen->in_admin( 'network' ) && is_plugin_active( $plugin_file ) )
 168                                 || ( $screen->in_admin( 'network' ) && is_plugin_active_for_network( $plugin_file ) ) ) {
 169                                 // On the non-network screen, populate the active list with plugins that are individually activated
 170                                 // On the network-admin screen, populate the active list with plugins that are network activated
 171                                 $plugins['active'][ $plugin_file ] = $plugin_data;
 172                         } else {
 173                                 if ( ! $screen->in_admin( 'network' ) && isset( $recently_activated[ $plugin_file ] ) ) {
 174                                         // On the non-network screen, populate the recently activated list with plugins that have been recently activated
 175                                         $plugins['recently_activated'][ $plugin_file ] = $plugin_data;
 176                                 }
 177                                 // Populate the inactive list with plugins that aren't activated
 178                                 $plugins['inactive'][ $plugin_file ] = $plugin_data;
 179                         }
 180                 }
 181
 182                 if ( $s ) {
 183                         $status = 'search';
 184                         $plugins['search'] = array_filter( $plugins['all'], array( $this, '_search_callback' ) );
 185                 }
 186
 187                 $totals = array();
 188                 foreach ( $plugins as $type => $list )
 189                         $totals[ $type ] = count( $list );
 190
 191                 if ( empty( $plugins[ $status ] ) && !in_array( $status, array( 'all', 'search' ) ) )
 192                         $status = 'all';
 193
 194                 $this->items = array();
 195                 foreach ( $plugins[ $status ] as $plugin_file => $plugin_data ) {
 196                         // Translate, Don't Apply Markup, Sanitize HTML
 197                         $this->items[$plugin_file] = _get_plugin_data_markup_translate( $plugin_file, $plugin_data, false, true );
 198                 }
 199
 200                 $total_this_page = $totals[ $status ];
 201
 202                 if ( ! $orderby ) {
 203                         $orderby = 'Name';
 204                 } else {
 205                         $orderby = ucfirst( $orderby );
 206                 }
 207
 208                 $order = strtoupper( $order );
 209
 210                 uasort( $this->items, array( $this, '_order_callback' ) );
 211
 212                 $plugins_per_page = $this->get_items_per_page( str_replace( '-', '_', $screen->id . '_per_page' ), 999 );
 213
 214                 $start = ( $page - 1 ) * $plugins_per_page;
 215
 216                 if ( $total_this_page > $plugins_per_page )
 217                         $this->items = array_slice( $this->items, $start, $plugins_per_page );
 218
 219                 $this->set_pagination_args( array(
 220                         'total_items' => $total_this_page,
 221                         'per_page' => $plugins_per_page,
 222                 ) );
 223         }
 224
 225         /**
 226          * @staticvar string $term
 227          * @param array $plugin
 228          * @return bool
 229          */
 230         public function _search_callback( $plugin ) {
 231                 static $term = null;
 232                 if ( is_null( $term ) )
 233                         $term = wp_unslash( $_REQUEST['s'] );
 234
 235                 foreach ( $plugin as $value ) {
 236                         if ( false !== stripos( strip_tags( $value ), $term ) ) {
 237                                 return true;
 238                         }
 239                 }
 240
 241                 return false;
 242         }
 243
 244         /**
 245          * @global string $orderby
 246          * @global string $order
 247          * @param array $plugin_a
 248          * @param array $plugin_b
 249          * @return int
 250          */
 251         public function _order_callback( $plugin_a, $plugin_b ) {
 252                 global $orderby, $order;
 253
 254                 $a = $plugin_a[$orderby];
 255                 $b = $plugin_b[$orderby];
 256
 257                 if ( $a == $b )
 258                         return 0;
 259
 260                 if ( 'DESC' == $order ) {
 261                         return strcasecmp( $b, $a );
 262                 } else {
 263                         return strcasecmp( $a, $b );
 264                 }
 265         }
 266
 267         /**
 268          *
 269          * @global array $plugins
 270          */
 271         public function no_items() {
 272                 global $plugins;
 273
 274                 if ( !empty( $plugins['all'] ) )
 275                         _e( 'No plugins found.' );
 276                 else
 277                         _e( 'You do not appear to have any plugins available at this time.' );
 278         }
 279
 280         /**
 281          *
 282          * @global string $status
 283          * @return array
 284          */
 285         public function get_columns() {
 286                 global $status;
 287
 288                 return array(
 289                         'cb'          => !in_array( $status, array( 'mustuse', 'dropins' ) ) ? '<input type="checkbox" />' : '',
 290                         'name'        => __( 'Plugin' ),
 291                         'description' => __( 'Description' ),
 292                 );
 293         }
 294
 295         /**
 296          * @return array
 297          */
 298         protected function get_sortable_columns() {
 299                 return array();
 300         }
 301
 302         /**
 303          *
 304          * @global array $totals
 305          * @global string $status
 306          * @return array
 307          */
 308         protected function get_views() {
 309                 global $totals, $status;
 310
 311                 $status_links = array();
 312                 foreach ( $totals as $type => $count ) {
 313                         if ( !$count )
 314                                 continue;
 315
 316                         switch ( $type ) {
 317                                 case 'all':
 318                                         $text = _nx( 'All <span class="count">(%s)</span>', 'All <span class="count">(%s)</span>', $count, 'plugins' );
 319                                         break;
 320                                 case 'active':
 321                                         $text = _n( 'Active <span class="count">(%s)</span>', 'Active <span class="count">(%s)</span>', $count );
 322                                         break;
 323                                 case 'recently_activated':
 324                                         $text = _n( 'Recently Active <span class="count">(%s)</span>', 'Recently Active <span class="count">(%s)</span>', $count );
 325                                         break;
 326                                 case 'inactive':
 327                                         $text = _n( 'Inactive <span class="count">(%s)</span>', 'Inactive <span class="count">(%s)</span>', $count );
 328                                         break;
 329                                 case 'mustuse':
 330                                         $text = _n( 'Must-Use <span class="count">(%s)</span>', 'Must-Use <span class="count">(%s)</span>', $count );
 331                                         break;
 332                                 case 'dropins':
 333                                         $text = _n( 'Drop-ins <span class="count">(%s)</span>', 'Drop-ins <span class="count">(%s)</span>', $count );
 334                                         break;
 335                                 case 'upgrade':
 336                                         $text = _n( 'Update Available <span class="count">(%s)</span>', 'Update Available <span class="count">(%s)</span>', $count );
 337                                         break;
 338                         }
 339
 340                         if ( 'search' != $type ) {
 341                                 $status_links[$type] = sprintf( "<a href='%s' %s>%s</a>",
 342                                         add_query_arg('plugin_status', $type, 'plugins.php'),
 343                                         ( $type == $status ) ? ' class="current"' : '',
 344                                         sprintf( $text, number_format_i18n( $count ) )
 345                                         );
 346                         }
 347                 }
 348
 349                 return $status_links;
 350         }
 351
 352         /**
 353          *
 354          * @global string $status
 355          * @return array
 356          */
 357         protected function get_bulk_actions() {
 358                 global $status;
 359
 360                 $actions = array();
 361
 362                 if ( 'active' != $status )
 363                         $actions['activate-selected'] = $this->screen->in_admin( 'network' ) ? __( 'Network Activate' ) : __( 'Activate' );
 364
 365                 if ( 'inactive' != $status && 'recent' != $status )
 366                         $actions['deactivate-selected'] = $this->screen->in_admin( 'network' ) ? __( 'Network Deactivate' ) : __( 'Deactivate' );
 367
 368                 if ( !is_multisite() || $this->screen->in_admin( 'network' ) ) {
 369                         if ( current_user_can( 'update_plugins' ) )
 370                                 $actions['update-selected'] = __( 'Update' );
 371                         if ( current_user_can( 'delete_plugins' ) && ( 'active' != $status ) )
 372                                 $actions['delete-selected'] = __( 'Delete' );
 373                 }
 374
 375                 return $actions;
 376         }
 377
 378         /**
 379          * @global string $status
 380          * @param string $which
 381          */
 382         public function bulk_actions( $which = '' ) {
 383                 global $status;
 384
 385                 if ( in_array( $status, array( 'mustuse', 'dropins' ) ) )
 386                         return;
 387
 388                 parent::bulk_actions( $which );
 389         }
 390
 391         /**
 392          * @global string $status
 393          * @param string $which
 394          */
 395         protected function extra_tablenav( $which ) {
 396                 global $status;
 397
 398                 if ( ! in_array($status, array('recently_activated', 'mustuse', 'dropins') ) )
 399                         return;
 400
 401                 echo '<div class="alignleft actions">';
 402
 403                 if ( ! $this->screen->in_admin( 'network' ) && 'recently_activated' == $status )
 404                         submit_button( __( 'Clear List' ), 'button', 'clear-recent-list', false );
 405                 elseif ( 'top' == $which && 'mustuse' == $status )
 406                         echo '<p>' . sprintf( __( 'Files in the <code>%s</code> directory are executed automatically.' ), str_replace( ABSPATH, '/', WPMU_PLUGIN_DIR ) ) . '</p>';
 407                 elseif ( 'top' == $which && 'dropins' == $status )
 408                         echo '<p>' . sprintf( __( 'Drop-ins are advanced plugins in the <code>%s</code> directory that replace WordPress functionality when present.' ), str_replace( ABSPATH, '', WP_CONTENT_DIR ) ) . '</p>';
 409
 410                 echo '</div>';
 411         }
 412
 413         /**
 414          * @return string
 415          */
 416         public function current_action() {
 417                 if ( isset($_POST['clear-recent-list']) )
 418                         return 'clear-recent-list';
 419
 420                 return parent::current_action();
 421         }
 422
 423         /**
 424          *
 425          * @global string $status
 426          */
 427         public function display_rows() {
 428                 global $status;
 429
 430                 if ( is_multisite() && ! $this->screen->in_admin( 'network' ) && in_array( $status, array( 'mustuse', 'dropins' ) ) )
 431                         return;
 432
 433                 foreach ( $this->items as $plugin_file => $plugin_data )
 434                         $this->single_row( array( $plugin_file, $plugin_data ) );
 435         }
 436
 437         /**
 438          * @global string $status
 439          * @global int $page
 440          * @global string $s
 441          * @global array $totals
 442          *
 443          * @param array $item
 444          */
 445         public function single_row( $item ) {
 446                 global $status, $page, $s, $totals;
 447
 448                 list( $plugin_file, $plugin_data ) = $item;
 449                 $context = $status;
 450                 $screen = $this->screen;
 451
 452                 // Pre-order.
 453                 $actions = array(
 454                         'deactivate' => '',
 455                         'activate' => '',
 456                         'details' => '',
 457                         'edit' => '',
 458                         'delete' => '',
 459                 );
 460
 461                 if ( 'mustuse' == $context ) {
 462                         $is_active = true;
 463                 } elseif ( 'dropins' == $context ) {
 464                         $dropins = _get_dropins();
 465                         $plugin_name = $plugin_file;
 466                         if ( $plugin_file != $plugin_data['Name'] )
 467                                 $plugin_name .= '<br/>' . $plugin_data['Name'];
 468                         if ( true === ( $dropins[ $plugin_file ][1] ) ) { // Doesn't require a constant
 469                                 $is_active = true;
 470                                 $description = '<p><strong>' . $dropins[ $plugin_file ][0] . '</strong></p>';
 471                         } elseif ( defined( $dropins[ $plugin_file ][1] ) && constant( $dropins[ $plugin_file ][1] ) ) { // Constant is true
 472                                 $is_active = true;
 473                                 $description = '<p><strong>' . $dropins[ $plugin_file ][0] . '</strong></p>';
 474                         } else {
 475                                 $is_active = false;
 476                                 $description = '<p><strong>' . $dropins[ $plugin_file ][0] . ' <span class="error-message">' . __('Inactive:') . '</span></strong> ' . sprintf( __( 'Requires <code>%s</code> in <code>wp-config.php</code>.' ), "define('" . $dropins[ $plugin_file ][1] . "', true);" ) . '</p>';
 477                         }
 478                         if ( $plugin_data['Description'] )
 479                                 $description .= '<p>' . $plugin_data['Description'] . '</p>';
 480                 } else {
 481                         if ( $screen->in_admin( 'network' ) )
 482                                 $is_active = is_plugin_active_for_network( $plugin_file );
 483                         else
 484                                 $is_active = is_plugin_active( $plugin_file );
 485
 486                         if ( $screen->in_admin( 'network' ) ) {
 487                                 if ( $is_active ) {
 488                                         if ( current_user_can( 'manage_network_plugins' ) ) {
 489                                                 /* translators: %s: plugin name */
 490                                                 $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>';
 491                                                 }
 492                                 } else {
 493                                         if ( current_user_can( 'manage_network_plugins' ) ) {
 494                                                 /* translators: %s: plugin name */
 495                                                 $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>';
 496                                         }
 497                                         if ( current_user_can( 'delete_plugins' ) && ! is_plugin_active( $plugin_file ) ) {
 498                                                 /* translators: %s: plugin name */
 499                                                 $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>';
 500                                         }
 501                                 }
 502                         } else {
 503                                 if ( $is_active ) {
 504                                         /* translators: %s: plugin name */
 505                                         $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>';
 506                                 } else {
 507                                         /* translators: %s: plugin name */
 508                                         $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>';
 509
 510                                         if ( ! is_multisite() && current_user_can( 'delete_plugins' ) ) {
 511                                                 /* translators: %s: plugin name */
 512                                                 $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>';
 513                                         }
 514                                 } // end if $is_active
 515
 516                          } // end if $screen->in_admin( 'network' )
 517
 518                         if ( ( ! is_multisite() || $screen->in_admin( 'network' ) ) && current_user_can( 'edit_plugins' ) && is_writable( WP_PLUGIN_DIR . '/' . $plugin_file ) ) {
 519                                 /* translators: %s: plugin name */
 520                                 $actions['edit'] = '<a href="plugin-editor.php?file=' . $plugin_file . '" class="edit" aria-label="' . esc_attr( sprintf( __( 'Edit %s' ), $plugin_data['Name'] ) ) . '">' . __( 'Edit' ) . '</a>';
 521                         }
 522                 } // end if $context
 523
 524                 $prefix = $screen->in_admin( 'network' ) ? 'network_admin_' : '';
 525
 526                 /**
 527                  * Filter the action links displayed for each plugin in the Plugins list table.
 528                  *
 529                  * The dynamic portion of the hook name, `$prefix`, refers to the context the
 530                  * action links are displayed in. The 'network_admin_' prefix is used if the
 531                  * current screen is the Network plugins list table. The prefix is empty ('')
 532                  * if the current screen is the site plugins list table.
 533                  *
 534                  * The default action links for the Network plugins list table include
 535                  * 'Network Activate', 'Network Deactivate', 'Edit', and 'Delete'.
 536                  *
 537                  * The default action links for the site plugins list table include
 538                  * 'Activate', 'Deactivate', and 'Edit', for a network site, and
 539                  * 'Activate', 'Deactivate', 'Edit', and 'Delete' for a single site.
 540                  *
 541                  * @since 2.5.0
 542                  *
 543                  * @param array  $actions     An array of plugin action links.
 544                  * @param string $plugin_file Path to the plugin file.
 545                  * @param array  $plugin_data An array of plugin data.
 546                  * @param string $context     The plugin context. Defaults are 'All', 'Active',
 547                  *                            'Inactive', 'Recently Activated', 'Upgrade',
 548                  *                            'Must-Use', 'Drop-ins', 'Search'.
 549                  */
 550                 $actions = apply_filters( $prefix . 'plugin_action_links', array_filter( $actions ), $plugin_file, $plugin_data, $context );
 551
 552                 /**
 553                  * Filter the list of action links displayed for a specific plugin.
 554                  *
 555                  * The first dynamic portion of the hook name, $prefix, refers to the context
 556                  * the action links are displayed in. The 'network_admin_' prefix is used if the
 557                  * current screen is the Network plugins list table. The prefix is empty ('')
 558                  * if the current screen is the site plugins list table.
 559                  *
 560                  * The second dynamic portion of the hook name, $plugin_file, refers to the path
 561                  * to the plugin file, relative to the plugins directory.
 562                  *
 563                  * @since 2.7.0
 564                  *
 565                  * @param array  $actions     An array of plugin action links.
 566                  * @param string $plugin_file Path to the plugin file.
 567                  * @param array  $plugin_data An array of plugin data.
 568                  * @param string $context     The plugin context. Defaults are 'All', 'Active',
 569                  *                            'Inactive', 'Recently Activated', 'Upgrade',
 570                  *                            'Must-Use', 'Drop-ins', 'Search'.
 571                  */
 572                 $actions = apply_filters( $prefix . "plugin_action_links_$plugin_file", $actions, $plugin_file, $plugin_data, $context );
 573
 574                 $class = $is_active ? 'active' : 'inactive';
 575                 $checkbox_id =  "checkbox_" . md5($plugin_data['Name']);
 576                 if ( in_array( $status, array( 'mustuse', 'dropins' ) ) ) {
 577                         $checkbox = '';
 578                 } else {
 579                         $checkbox = "<label class='screen-reader-text' for='" . $checkbox_id . "' >" . sprintf( __( 'Select %s' ), $plugin_data['Name'] ) . "</label>"
 580                                 . "<input type='checkbox' name='checked[]' value='" . esc_attr( $plugin_file ) . "' id='" . $checkbox_id . "' />";
 581                 }
 582                 if ( 'dropins' != $context ) {
 583                         $description = '<p>' . ( $plugin_data['Description'] ? $plugin_data['Description'] : '&nbsp;' ) . '</p>';
 584                         $plugin_name = $plugin_data['Name'];
 585                 }
 586
 587                 $id = sanitize_title( $plugin_name );
 588                 if ( ! empty( $totals['upgrade'] ) && ! empty( $plugin_data['update'] ) )
 589                         $class .= ' update';
 590
 591                 $plugin_slug = ( isset( $plugin_data['slug'] ) ) ? $plugin_data['slug'] : '';
 592                 printf( "<tr id='%s' class='%s' data-slug='%s'>",
 593                         $id,
 594                         $class,
 595                         $plugin_slug
 596                 );
 597
 598                 list( $columns, $hidden, $sortable, $primary ) = $this->get_column_info();
 599
 600                 foreach ( $columns as $column_name => $column_display_name ) {
 601                         $extra_classes = '';
 602                         if ( in_array( $column_name, $hidden ) ) {
 603                                 $extra_classes = ' hidden';
 604                         }
 605
 606                         switch ( $column_name ) {
 607                                 case 'cb':
 608                                         echo "<th scope='row' class='check-column'>$checkbox</th>";
 609                                         break;
 610                                 case 'name':
 611                                         echo "<td class='plugin-title column-primary'><strong>$plugin_name</strong>";
 612                                         echo $this->row_actions( $actions, true );
 613                                         echo "</td>";
 614                                         break;
 615                                 case 'description':
 616                                         $classes = 'column-description desc';
 617
 618                                         echo "<td class='$classes{$extra_classes}'>
 619                                                 <div class='plugin-description'>$description</div>
 620                                                 <div class='$class second plugin-version-author-uri'>";
 621
 622                                         $plugin_meta = array();
 623                                         if ( !empty( $plugin_data['Version'] ) )
 624                                                 $plugin_meta[] = sprintf( __( 'Version %s' ), $plugin_data['Version'] );
 625                                         if ( !empty( $plugin_data['Author'] ) ) {
 626                                                 $author = $plugin_data['Author'];
 627                                                 if ( !empty( $plugin_data['AuthorURI'] ) )
 628                                                         $author = '<a href="' . $plugin_data['AuthorURI'] . '">' . $plugin_data['Author'] . '</a>';
 629                                                 $plugin_meta[] = sprintf( __( 'By %s' ), $author );
 630                                         }
 631
 632                                         // Details link using API info, if available
 633                                         if ( isset( $plugin_data['slug'] ) && current_user_can( 'install_plugins' ) ) {
 634                                                 $plugin_meta[] = sprintf( '<a href="%s" class="thickbox" aria-label="%s" data-title="%s">%s</a>',
 635                                                         esc_url( network_admin_url( 'plugin-install.php?tab=plugin-information&plugin=' . $plugin_data['slug'] .
 636                                                                 '&TB_iframe=true&width=600&height=550' ) ),
 637                                                         esc_attr( sprintf( __( 'More information about %s' ), $plugin_name ) ),
 638                                                         esc_attr( $plugin_name ),
 639                                                         __( 'View details' )
 640                                                 );
 641                                         } elseif ( ! empty( $plugin_data['PluginURI'] ) ) {
 642                                                 $plugin_meta[] = sprintf( '<a href="%s">%s</a>',
 643                                                         esc_url( $plugin_data['PluginURI'] ),
 644                                                         __( 'Visit plugin site' )
 645                                                 );
 646                                         }
 647
 648                                         /**
 649                                          * Filter the array of row meta for each plugin in the Plugins list table.
 650                                          *
 651                                          * @since 2.8.0
 652                                          *
 653                                          * @param array  $plugin_meta An array of the plugin's metadata,
 654                                          *                            including the version, author,
 655                                          *                            author URI, and plugin URI.
 656                                          * @param string $plugin_file Path to the plugin file, relative to the plugins directory.
 657                                          * @param array  $plugin_data An array of plugin data.
 658                                          * @param string $status      Status of the plugin. Defaults are 'All', 'Active',
 659                                          *                            'Inactive', 'Recently Activated', 'Upgrade', 'Must-Use',
 660                                          *                            'Drop-ins', 'Search'.
 661                                          */
 662                                         $plugin_meta = apply_filters( 'plugin_row_meta', $plugin_meta, $plugin_file, $plugin_data, $status );
 663                                         echo implode( ' | ', $plugin_meta );
 664
 665                                         echo "</div></td>";
 666                                         break;
 667                                 default:
 668                                         $classes = "$column_name column-$column_name$class";
 669
 670                                         echo "<td class='$classes{$extra_classes}'>";
 671
 672                                         /**
 673                                          * Fires inside each custom column of the Plugins list table.
 674                                          *
 675                                          * @since 3.1.0
 676                                          *
 677                                          * @param string $column_name Name of the column.
 678                                          * @param string $plugin_file Path to the plugin file.
 679                                          * @param array  $plugin_data An array of plugin data.
 680                                          */
 681                                         do_action( 'manage_plugins_custom_column', $column_name, $plugin_file, $plugin_data );
 682
 683                                         echo "</td>";
 684                         }
 685                 }
 686
 687                 echo "</tr>";
 688
 689                 /**
 690                  * Fires after each row in the Plugins list table.
 691                  *
 692                  * @since 2.3.0
 693                  *
 694                  * @param string $plugin_file Path to the plugin file, relative to the plugins directory.
 695                  * @param array  $plugin_data An array of plugin data.
 696                  * @param string $status      Status of the plugin. Defaults are 'All', 'Active',
 697                  *                            'Inactive', 'Recently Activated', 'Upgrade', 'Must-Use',
 698                  *                            'Drop-ins', 'Search'.
 699                  */
 700                 do_action( 'after_plugin_row', $plugin_file, $plugin_data, $status );
 701
 702                 /**
 703                  * Fires after each specific row in the Plugins list table.
 704                  *
 705                  * The dynamic portion of the hook name, `$plugin_file`, refers to the path
 706                  * to the plugin file, relative to the plugins directory.
 707                  *
 708                  * @since 2.7.0
 709                  *
 710                  * @param string $plugin_file Path to the plugin file, relative to the plugins directory.
 711                  * @param array  $plugin_data An array of plugin data.
 712                  * @param string $status      Status of the plugin. Defaults are 'All', 'Active',
 713                  *                            'Inactive', 'Recently Activated', 'Upgrade', 'Must-Use',
 714                  *                            'Drop-ins', 'Search'.
 715                  */
 716                 do_action( "after_plugin_row_$plugin_file", $plugin_file, $plugin_data, $status );
 717         }
 718
 719         /**
 720          * Gets the name of the primary column for this specific list table.
 721          *
 722          * @since 4.3.0
 723          * @access protected
 724          *
 725          * @return string Unalterable name for the primary column, in this case, 'name'.
 726          */
 727         protected function get_primary_column_name() {
 728                 return 'name';
 729         }
 730 }