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