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

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