SportsPress – Sports Club & League Manager - Version 2.7.13

Version Description

  • Fix - Theme notice escaping.
  • Fix - Timezone dropdown selection now shown in general settings.
  • Fix - Double header when multiple player lists are displayed in team.
  • Fix - Dropdown options not saving in settings.
  • Fix - Setup page conflict with WooCommerce.
Download this release

Release Info

Developer ThemeBoy
Plugin Icon 128x128 SportsPress – Sports Club & League Manager
Version 2.7.13
Comparing to
See all releases

Code changes from version 2.7.12 to 2.7.13

Files changed (26) hide show
  1. changelog.txt +7 -0
  2. includes/admin/class-sp-admin-dashboard.php +2 -2
  3. includes/admin/class-sp-admin-importers.php +6 -6
  4. includes/admin/class-sp-admin-permalink-settings.php +2 -2
  5. includes/admin/class-sp-admin-settings.php +5 -20
  6. includes/admin/class-sp-admin-setup-wizard.php +3 -4
  7. includes/admin/class-sp-admin-welcome.php +3 -3
  8. includes/admin/importers/class-sp-event-importer.php +4 -4
  9. includes/admin/importers/class-sp-event-performance-importer.php +3 -3
  10. includes/admin/importers/class-sp-fixture-importer.php +4 -4
  11. includes/admin/importers/class-sp-official-importer.php +3 -3
  12. includes/admin/importers/class-sp-player-importer.php +3 -3
  13. includes/admin/importers/class-sp-staff-importer.php +3 -3
  14. includes/admin/importers/class-sp-team-importer.php +3 -3
  15. includes/admin/settings/class-sp-settings-general.php +2 -2
  16. includes/admin/settings/class-sp-settings-status.php +4 -4
  17. includes/admin/views/html-admin-page-status.php +2 -2
  18. includes/admin/views/html-notice-template-check.php +1 -1
  19. includes/admin/views/html-notice-theme-support.php +1 -1
  20. includes/libraries/class-tgm-plugin-activation.php +3786 -3810
  21. modules/sportspress-birthdays.php +2 -2
  22. modules/sportspress-comments-scheduled-events.php +5 -5
  23. modules/sportspress-officials.php +2 -2
  24. readme.txt +8 -1
  25. sportspress.php +3 -3
  26. templates/team-lists.php +2 -2
changelog.txt CHANGED
@@ -1,5 +1,12 @@
1
  == SportsPress Changelog ==
2
 
 
 
 
 
 
 
 
3
  = 2.7.12 =
4
  * Fix - OpenStreetMap not displaying map after update.
5
 
1
  == SportsPress Changelog ==
2
 
3
+ = 2.7.13 =
4
+ * Fix - Theme notice escaping.
5
+ * Fix - Timezone dropdown selection now shown in general settings.
6
+ * Fix - Double header when multiple player lists are displayed in team.
7
+ * Fix - Dropdown options not saving in settings.
8
+ * Fix - Setup page conflict with WooCommerce.
9
+
10
  = 2.7.12 =
11
  * Fix - OpenStreetMap not displaying map after update.
12
 
includes/admin/class-sp-admin-dashboard.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
- * @version 2.7.9
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -82,7 +82,7 @@ if ( ! class_exists( 'SP_Admin_Dashboard' ) ) :
82
  ?>
83
  <li class="countdown" data-countdown="<?php echo esc_attr( str_replace( '-', '/', get_gmt_from_date( $next_event->post_date ) ) ); ?>">
84
  <a href="<?php echo esc_url( get_edit_post_link( $next_event->ID ) ); ?>">
85
- <?php printf( esc_html__( '<strong>%s</strong> until next event', 'sportspress' ), esc_html( $interval->days ) . ' ' . esc_html__( 'days', 'sportspress' ) . ' ' . sprintf( '%02s:%02s:%02s', esc_html( $interval->h ), esc_html( $interval->i ), esc_html( $interval->s ) ) ); ?>
86
  (<?php echo esc_html( $next_event->post_title ); ?>)
87
  </a>
88
  </li>
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
82
  ?>
83
  <li class="countdown" data-countdown="<?php echo esc_attr( str_replace( '-', '/', get_gmt_from_date( $next_event->post_date ) ) ); ?>">
84
  <a href="<?php echo esc_url( get_edit_post_link( $next_event->ID ) ); ?>">
85
+ <?php printf( wp_kses_post( __( '<strong>%s</strong> until next event', 'sportspress' ) ), esc_html( $interval->days ) . ' ' . esc_html__( 'days', 'sportspress' ) . ' ' . sprintf( '%02s:%02s:%02s', esc_html( $interval->h ), esc_html( $interval->i ), esc_html( $interval->s ) ) ); ?>
86
  (<?php echo esc_html( $next_event->post_title ); ?>)
87
  </a>
88
  </li>
includes/admin/class-sp-admin-importers.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
- * @version 2.5.1
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -36,27 +36,27 @@ if ( ! class_exists( 'SP_Admin_Importers' ) ) :
36
  array(
37
  'sp_event_csv' => array(
38
  'name' => esc_attr__( 'SportsPress Events (CSV)', 'sportspress' ),
39
- 'description' => esc_attr__( 'Import <strong>events</strong> from a csv file.', 'sportspress' ),
40
  'callback' => array( $this, 'events_importer' ),
41
  ),
42
  'sp_fixture_csv' => array(
43
  'name' => esc_attr__( 'SportsPress Fixtures (CSV)', 'sportspress' ),
44
- 'description' => esc_attr__( 'Import <strong>upcoming events</strong> from a csv file.', 'sportspress' ),
45
  'callback' => array( $this, 'fixtures_importer' ),
46
  ),
47
  'sp_team_csv' => array(
48
  'name' => esc_attr__( 'SportsPress Teams (CSV)', 'sportspress' ),
49
- 'description' => esc_attr__( 'Import <strong>teams</strong> from a csv file.', 'sportspress' ),
50
  'callback' => array( $this, 'teams_importer' ),
51
  ),
52
  'sp_player_csv' => array(
53
  'name' => esc_attr__( 'SportsPress Players (CSV)', 'sportspress' ),
54
- 'description' => esc_attr__( 'Import <strong>players</strong> from a csv file.', 'sportspress' ),
55
  'callback' => array( $this, 'players_importer' ),
56
  ),
57
  'sp_staff_csv' => array(
58
  'name' => esc_attr__( 'SportsPress Staff (CSV)', 'sportspress' ),
59
- 'description' => esc_attr__( 'Import <strong>staff</strong> from a csv file.', 'sportspress' ),
60
  'callback' => array( $this, 'staff_importer' ),
61
  ),
62
  )
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
36
  array(
37
  'sp_event_csv' => array(
38
  'name' => esc_attr__( 'SportsPress Events (CSV)', 'sportspress' ),
39
+ 'description' => wp_kses_post( __( 'Import <strong>events</strong> from a csv file.', 'sportspress' ) ),
40
  'callback' => array( $this, 'events_importer' ),
41
  ),
42
  'sp_fixture_csv' => array(
43
  'name' => esc_attr__( 'SportsPress Fixtures (CSV)', 'sportspress' ),
44
+ 'description' => wp_kses_post( __( 'Import <strong>upcoming events</strong> from a csv file.', 'sportspress' ) ),
45
  'callback' => array( $this, 'fixtures_importer' ),
46
  ),
47
  'sp_team_csv' => array(
48
  'name' => esc_attr__( 'SportsPress Teams (CSV)', 'sportspress' ),
49
+ 'description' => wp_kses_post( __( 'Import <strong>teams</strong> from a csv file.', 'sportspress' ) ),
50
  'callback' => array( $this, 'teams_importer' ),
51
  ),
52
  'sp_player_csv' => array(
53
  'name' => esc_attr__( 'SportsPress Players (CSV)', 'sportspress' ),
54
+ 'description' => wp_kses_post( __( 'Import <strong>players</strong> from a csv file.', 'sportspress' ) ),
55
  'callback' => array( $this, 'players_importer' ),
56
  ),
57
  'sp_staff_csv' => array(
58
  'name' => esc_attr__( 'SportsPress Staff (CSV)', 'sportspress' ),
59
+ 'description' => wp_kses_post( __( 'Import <strong>staff</strong> from a csv file.', 'sportspress' ) ),
60
  'callback' => array( $this, 'staff_importer' ),
61
  ),
62
  )
includes/admin/class-sp-admin-permalink-settings.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
- * @version 2.7.9
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -78,7 +78,7 @@ if ( ! class_exists( 'SP_Admin_Permalink_Settings' ) ) :
78
  * Show the settings
79
  */
80
  public function settings() {
81
- echo wp_kses_post( wpautop( esc_attr__( 'These settings control the permalinks used for SportsPress. These settings only apply when <strong>not using "default" permalinks above</strong>.', 'sportspress' ) ) );
82
  }
83
 
84
  /**
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
78
  * Show the settings
79
  */
80
  public function settings() {
81
+ echo wp_kses_post( wpautop( __( 'These settings control the permalinks used for SportsPress. These settings only apply when <strong>not using "default" permalinks above</strong>.', 'sportspress' ) ) );
82
  }
83
 
84
  /**
includes/admin/class-sp-admin-settings.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
- * @version 2.7.9
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -404,12 +404,7 @@ if ( ! class_exists( 'SP_Admin_Settings' ) ) :
404
  </th>
405
  <td class="forminp forminp-<?php echo esc_attr( $value['type'] ); ?>">
406
  <select
407
- name="<?php echo esc_attr( $value['id'] ); ?>
408
- <?php
409
- if ( $value['type'] == 'multiselect' ) {
410
- echo '[]';}
411
- ?>
412
- "
413
  id="<?php echo esc_attr( $value['id'] ); ?>"
414
  style="<?php echo esc_attr( $value['css'] ); ?>"
415
  class="chosen-select
@@ -458,12 +453,7 @@ if ( ! class_exists( 'SP_Admin_Settings' ) ) :
458
  </th>
459
  <td class="forminp forminp-<?php echo esc_attr( $value['type'] ); ?>">
460
  <select
461
- name="<?php echo esc_attr( $value['id'] ); ?>
462
- <?php
463
- if ( $value['type'] == 'multiselect' ) {
464
- echo '[]';}
465
- ?>
466
- "
467
  id="<?php echo esc_attr( $value['id'] ); ?>"
468
  style="<?php echo esc_attr( $value['css'] ); ?>"
469
  class="chosen-select
@@ -526,12 +516,7 @@ if ( ! class_exists( 'SP_Admin_Settings' ) ) :
526
  </th>
527
  <td class="forminp forminp-<?php echo esc_attr( $value['type'] ); ?>">
528
  <select
529
- name="<?php echo esc_attr( $value['id'] ); ?>
530
- <?php
531
- if ( $value['type'] == 'multiselect' ) {
532
- echo '[]';}
533
- ?>
534
- "
535
  id="<?php echo esc_attr( $value['id'] ); ?>"
536
  style="<?php echo esc_attr( $value['css'] ); ?>"
537
  class="sp-select-sport chosen-select
@@ -718,7 +703,7 @@ if ( ! class_exists( 'SP_Admin_Settings' ) ) :
718
  continue;
719
  }
720
 
721
- $type = isset( $value['type'] ) ? esc_attr( $value['type'] ) : '';
722
 
723
  // Get the option name
724
  $option_value = null;
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
404
  </th>
405
  <td class="forminp forminp-<?php echo esc_attr( $value['type'] ); ?>">
406
  <select
407
+ name="<?php echo esc_attr( $value['id'] ); ?><?php if ( $value['type'] == 'multiselect' ) { echo '[]';} ?>"
 
 
 
 
 
408
  id="<?php echo esc_attr( $value['id'] ); ?>"
409
  style="<?php echo esc_attr( $value['css'] ); ?>"
410
  class="chosen-select
453
  </th>
454
  <td class="forminp forminp-<?php echo esc_attr( $value['type'] ); ?>">
455
  <select
456
+ name="<?php echo esc_attr( $value['id'] ); ?><?php if ( $value['type'] == 'multiselect' ) { echo '[]';} ?>"
 
 
 
 
 
457
  id="<?php echo esc_attr( $value['id'] ); ?>"
458
  style="<?php echo esc_attr( $value['css'] ); ?>"
459
  class="chosen-select
516
  </th>
517
  <td class="forminp forminp-<?php echo esc_attr( $value['type'] ); ?>">
518
  <select
519
+ name="<?php echo esc_attr( $value['id'] ); ?><?php if ( $value['type'] == 'multiselect' ) { echo '[]';} ?>"
 
 
 
 
 
520
  id="<?php echo esc_attr( $value['id'] ); ?>"
521
  style="<?php echo esc_attr( $value['css'] ); ?>"
522
  class="sp-select-sport chosen-select
703
  continue;
704
  }
705
 
706
+ $type = isset( $value['type'] ) ? sanitize_key( $value['type'] ) : '';
707
 
708
  // Get the option name
709
  $option_value = null;
includes/admin/class-sp-admin-setup-wizard.php CHANGED
@@ -9,7 +9,7 @@
9
  * @author WooThemes
10
  * @category Admin
11
  * @package SportsPress/Admin
12
- * @version 2.7.9
13
  */
14
  if ( ! defined( 'ABSPATH' ) ) {
15
  exit;
@@ -145,7 +145,6 @@ class SP_Admin_Setup_Wizard {
145
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
146
  <title><?php esc_html_e( 'SportsPress', 'sportspress' ); ?> &rsaquo; <?php echo esc_html( $this->steps[ $this->step ]['name'] ); ?></title>
147
  <?php do_action( 'admin_print_styles' ); ?>
148
- <?php do_action( 'admin_head' ); ?>
149
  </head>
150
  <body class="sp-setup wp-core-ui">
151
  <h1 id="sp-logo"><?php echo wp_kses_post( apply_filters( 'sportspress_logo', '<img src="' . plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/modules/sportspress' . ( class_exists( 'SportsPress_Pro' ) ? '-pro' : '' ) . '.png" alt="' . esc_attr__( 'SportsPress', 'sportspress' ) . '">' ) ); ?></h1>
@@ -204,7 +203,7 @@ class SP_Admin_Setup_Wizard {
204
  public function sp_setup_introduction() {
205
  ?>
206
  <h1><?php esc_html_e( 'Welcome to SportsPress', 'sportspress' ); ?></h1>
207
- <p><?php esc_html_e( 'Thank you for choosing SportsPress to power your sports website! This quick setup wizard will help you configure the basic settings. <strong>It’s completely optional and shouldn’t take longer than five minutes.</strong>', 'sportspress' ); ?></p>
208
  <p><?php esc_html_e( 'No time right now? If you don’t want to go through the wizard, you can skip and return to the WordPress dashboard. Come back anytime if you change your mind!', 'sportspress' ); ?></p>
209
  <p class="sp-setup-actions step">
210
  <a href="<?php echo esc_url( $this->get_next_step_link() ); ?>" class="button-primary button button-large button-next"><?php esc_html_e( 'Let\'s Go!', 'sportspress' ); ?></a>
@@ -248,7 +247,7 @@ class SP_Admin_Setup_Wizard {
248
  $tzstring = 'UTC+' . $current_offset;
249
  }
250
  }
251
- echo esc_attr( wp_timezone_choice( $tzstring ) );
252
  ?>
253
  </select>
254
  </td>
9
  * @author WooThemes
10
  * @category Admin
11
  * @package SportsPress/Admin
12
+ * @version 2.7.13
13
  */
14
  if ( ! defined( 'ABSPATH' ) ) {
15
  exit;
145
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
146
  <title><?php esc_html_e( 'SportsPress', 'sportspress' ); ?> &rsaquo; <?php echo esc_html( $this->steps[ $this->step ]['name'] ); ?></title>
147
  <?php do_action( 'admin_print_styles' ); ?>
 
148
  </head>
149
  <body class="sp-setup wp-core-ui">
150
  <h1 id="sp-logo"><?php echo wp_kses_post( apply_filters( 'sportspress_logo', '<img src="' . plugin_dir_url( SP_PLUGIN_FILE ) . 'assets/images/modules/sportspress' . ( class_exists( 'SportsPress_Pro' ) ? '-pro' : '' ) . '.png" alt="' . esc_attr__( 'SportsPress', 'sportspress' ) . '">' ) ); ?></h1>
203
  public function sp_setup_introduction() {
204
  ?>
205
  <h1><?php esc_html_e( 'Welcome to SportsPress', 'sportspress' ); ?></h1>
206
+ <p><?php echo wp_kses_post( __( 'Thank you for choosing SportsPress to power your sports website! This quick setup wizard will help you configure the basic settings. <strong>It’s completely optional and shouldn’t take longer than five minutes.</strong>', 'sportspress' ) ); ?></p>
207
  <p><?php esc_html_e( 'No time right now? If you don’t want to go through the wizard, you can skip and return to the WordPress dashboard. Come back anytime if you change your mind!', 'sportspress' ); ?></p>
208
  <p class="sp-setup-actions step">
209
  <a href="<?php echo esc_url( $this->get_next_step_link() ); ?>" class="button-primary button button-large button-next"><?php esc_html_e( 'Let\'s Go!', 'sportspress' ); ?></a>
247
  $tzstring = 'UTC+' . $current_offset;
248
  }
249
  }
250
+ echo wp_kses( wp_timezone_choice( $tzstring ), array( 'option' => array( 'value' => array(), 'selected' => array() ) ) );
251
  ?>
252
  </select>
253
  </td>
includes/admin/class-sp-admin-welcome.php CHANGED
@@ -9,7 +9,7 @@
9
  * @author ThemeBoy
10
  * @category Admin
11
  * @package SportsPress/Admin
12
- * @version 2.7.9
13
  */
14
 
15
  if ( ! defined( 'ABSPATH' ) ) {
@@ -329,7 +329,7 @@ class SP_Admin_Welcome {
329
  <div class="wrap about-wrap about-sportspress-wrap">
330
  <?php $this->intro(); ?>
331
 
332
- <p class="about-description"><?php printf( wp_kses_post( esc_attr__( 'SportsPress is developed and maintained by a worldwide team of passionate individuals and backed by an awesome developer community. Want to see your name? <a href="%s">Contribute to SportsPress</a>.', 'sportspress' ) ), 'https://github.com/ThemeBoy/SportsPress/blob/master/CONTRIBUTING.md' ); ?></p>
333
 
334
  <div class="sp-feature feature-section col one-col">
335
  <?php echo wp_kses_post( $this->contributors() ); ?>
@@ -347,7 +347,7 @@ class SP_Admin_Welcome {
347
 
348
  <?php $this->intro(); ?>
349
 
350
- <p class="about-description"><?php printf( wp_kses_post( esc_attr__( 'SportsPress has been kindly translated into several other languages thanks to our translation team. Want to see your name? <a href="%s">Translate SportsPress</a>.', 'sportspress' ) ), 'https://translate.wordpress.org/projects/wp-plugins/sportspress' ); ?></p>
351
  </div>
352
  <?php
353
  }
9
  * @author ThemeBoy
10
  * @category Admin
11
  * @package SportsPress/Admin
12
+ * @version 2.7.13
13
  */
14
 
15
  if ( ! defined( 'ABSPATH' ) ) {
329
  <div class="wrap about-wrap about-sportspress-wrap">
330
  <?php $this->intro(); ?>
331
 
332
+ <p class="about-description"><?php printf( wp_kses_post( __( 'SportsPress is developed and maintained by a worldwide team of passionate individuals and backed by an awesome developer community. Want to see your name? <a href="%s">Contribute to SportsPress</a>.', 'sportspress' ) ), 'https://github.com/ThemeBoy/SportsPress/blob/master/CONTRIBUTING.md' ); ?></p>
333
 
334
  <div class="sp-feature feature-section col one-col">
335
  <?php echo wp_kses_post( $this->contributors() ); ?>
347
 
348
  <?php $this->intro(); ?>
349
 
350
+ <p class="about-description"><?php printf( wp_kses_post( __( 'SportsPress has been kindly translated into several other languages thanks to our translation team. Want to see your name? <a href="%s">Translate SportsPress</a>.', 'sportspress' ) ), 'https://translate.wordpress.org/projects/wp-plugins/sportspress' ); ?></p>
351
  </div>
352
  <?php
353
  }
includes/admin/importers/class-sp-event-importer.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
- * @version 2.7.9
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -470,7 +470,7 @@ if ( class_exists( 'WP_Importer' ) ) {
470
 
471
  // Show Result
472
  echo '<div class="updated settings-error below-h2"><p>
473
- ' . sprintf( esc_html__( 'Import complete - imported <strong>%1$s</strong> events and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) . '
474
  </p></div>';
475
 
476
  $this->import_end();
@@ -494,8 +494,8 @@ if ( class_exists( 'WP_Importer' ) ) {
494
  function greet() {
495
  echo '<div class="narrow">';
496
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
497
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Events need to be defined with columns in a specific order (3+ columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ) ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/events-sample.csv' ) . '</p>';
498
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Supports CSV files generated by <a href="%s">LeagueLobster</a>.', 'sportspress' ) ), 'http://tboy.co/leaguelobster' ) . '</p>';
499
  wp_import_upload_form( 'admin.php?import=sp_event_csv&step=1' );
500
  echo '</div>';
501
  }
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
470
 
471
  // Show Result
472
  echo '<div class="updated settings-error below-h2"><p>
473
+ ' . wp_kses_post( sprintf( __( 'Import complete - imported <strong>%1$s</strong> events and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) ) . '
474
  </p></div>';
475
 
476
  $this->import_end();
494
  function greet() {
495
  echo '<div class="narrow">';
496
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
497
+ echo '<p>' . wp_kses_post( sprintf( __( 'Events need to be defined with columns in a specific order (3+ columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/events-sample.csv' ) ) . '</p>';
498
+ echo '<p>' . wp_kses_post( sprintf( __( 'Supports CSV files generated by <a href="%s">LeagueLobster</a>.', 'sportspress' ), 'http://tboy.co/leaguelobster' ) ) . '</p>';
499
  wp_import_upload_form( 'admin.php?import=sp_event_csv&step=1' );
500
  echo '</div>';
501
  }
includes/admin/importers/class-sp-event-performance-importer.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
- * @version 2.7.9
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -135,7 +135,7 @@ if ( class_exists( 'WP_Importer' ) ) {
135
 
136
  // Show Result
137
  echo '<div class="updated settings-error below-h2"><p>
138
- ' . sprintf( esc_html__( 'Import complete - imported <strong>%1$s</strong> rows and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) . '
139
  </p></div>';
140
 
141
  $this->import_end( $event );
@@ -178,7 +178,7 @@ if ( class_exists( 'WP_Importer' ) ) {
178
  )
179
  );
180
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
181
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Box scores need to be defined with columns in a specific order. <a href="%s">Click here to download a sample</a>.', 'sportspress' ) ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/event-performance-sample.csv' ) . '</p>';
182
  wp_import_upload_form( add_query_arg( $args, 'admin.php' ) );
183
  } else {
184
  echo '<p><a href="' . esc_url( admin_url( add_query_arg( array( 'post_type' => 'sp_event' ), 'edit.php' ) ) ) . '">' . sprintf( esc_html__( 'Select %s', 'sportspress' ), esc_html__( 'Event', 'sportspress' ) ) . '</a></p>';
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
135
 
136
  // Show Result
137
  echo '<div class="updated settings-error below-h2"><p>
138
+ ' . wp_kses_post( sprintf( __( 'Import complete - imported <strong>%1$s</strong> rows and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) ) . '
139
  </p></div>';
140
 
141
  $this->import_end( $event );
178
  )
179
  );
180
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
181
+ echo '<p>' . wp_kses_post( sprintf( __( 'Box scores need to be defined with columns in a specific order. <a href="%s">Click here to download a sample</a>.', 'sportspress' ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/event-performance-sample.csv' ) ) . '</p>';
182
  wp_import_upload_form( add_query_arg( $args, 'admin.php' ) );
183
  } else {
184
  echo '<p><a href="' . esc_url( admin_url( add_query_arg( array( 'post_type' => 'sp_event' ), 'edit.php' ) ) ) . '">' . sprintf( esc_html__( 'Select %s', 'sportspress' ), esc_html__( 'Event', 'sportspress' ) ) . '</a></p>';
includes/admin/importers/class-sp-fixture-importer.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
- * @version 2.7
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -260,7 +260,7 @@ if ( class_exists( 'WP_Importer' ) ) {
260
 
261
  // Show Result
262
  echo '<div class="updated settings-error below-h2"><p>
263
- ' . sprintf( esc_html__( 'Import complete - imported <strong>%1$s</strong> events and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) . '
264
  </p></div>';
265
 
266
  $this->import_end();
@@ -284,8 +284,8 @@ if ( class_exists( 'WP_Importer' ) ) {
284
  function greet() {
285
  echo '<div class="narrow">';
286
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
287
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Fixtures need to be defined with columns in a specific order (4+ columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ) ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/fixtures-sample.csv' ) . '</p>';
288
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Supports CSV files generated by <a href="%s">LeagueLobster</a>.', 'sportspress' ) ), 'http://tboy.co/leaguelobster' ) . '</p>';
289
  wp_import_upload_form( 'admin.php?import=sp_fixture_csv&step=1' );
290
  echo '</div>';
291
  }
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
260
 
261
  // Show Result
262
  echo '<div class="updated settings-error below-h2"><p>
263
+ ' . wp_kses_post( sprintf( __( 'Import complete - imported <strong>%1$s</strong> events and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) ) . '
264
  </p></div>';
265
 
266
  $this->import_end();
284
  function greet() {
285
  echo '<div class="narrow">';
286
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
287
+ echo '<p>' . wp_kses_post( sprintf( __( 'Fixtures need to be defined with columns in a specific order (4+ columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/fixtures-sample.csv' ) ) . '</p>';
288
+ echo '<p>' . wp_kses_post( sprintf( __( 'Supports CSV files generated by <a href="%s">LeagueLobster</a>.', 'sportspress' ), 'http://tboy.co/leaguelobster' ) ) . '</p>';
289
  wp_import_upload_form( 'admin.php?import=sp_fixture_csv&step=1' );
290
  echo '</div>';
291
  }
includes/admin/importers/class-sp-official-importer.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
- * @version 2.5.1
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -83,7 +83,7 @@ if ( class_exists( 'WP_Importer' ) ) {
83
 
84
  // Show Result
85
  echo '<div class="updated settings-error below-h2"><p>
86
- ' . sprintf( esc_html__( 'Import complete - imported <strong>%1$s</strong> officials and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) . '
87
  </p></div>';
88
 
89
  $this->import_end();
@@ -117,7 +117,7 @@ if ( class_exists( 'WP_Importer' ) ) {
117
  function greet() {
118
  echo '<div class="narrow">';
119
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
120
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Officials need to be defined with columns in a specific order. <a href="%s">Click here to download a sample</a>.', 'sportspress' ) ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/officials-sample.csv' ) . '</p>';
121
  wp_import_upload_form( 'admin.php?import=sp_official_csv&step=1' );
122
  echo '</div>';
123
  }
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
83
 
84
  // Show Result
85
  echo '<div class="updated settings-error below-h2"><p>
86
+ ' . wp_kses_post( sprintf( __( 'Import complete - imported <strong>%1$s</strong> officials and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) ) . '
87
  </p></div>';
88
 
89
  $this->import_end();
117
  function greet() {
118
  echo '<div class="narrow">';
119
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
120
+ echo '<p>' . wp_kses_post( sprintf( __( 'Officials need to be defined with columns in a specific order. <a href="%s">Click here to download a sample</a>.', 'sportspress' ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/officials-sample.csv' ) ) . '</p>';
121
  wp_import_upload_form( 'admin.php?import=sp_official_csv&step=1' );
122
  echo '</div>';
123
  }
includes/admin/importers/class-sp-player-importer.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
- * @version 2.7
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -216,7 +216,7 @@ if ( class_exists( 'WP_Importer' ) ) {
216
 
217
  // Show Result
218
  echo '<div class="updated settings-error below-h2"><p>
219
- ' . sprintf( esc_html__( 'Import complete - imported <strong>%1$s</strong> players and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) . '
220
  </p></div>';
221
 
222
  $this->import_end();
@@ -250,7 +250,7 @@ if ( class_exists( 'WP_Importer' ) ) {
250
  function greet() {
251
  echo '<div class="narrow">';
252
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
253
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Players need to be defined with columns in a specific order (8 columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ) ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/players-sample.csv' ) . '</p>';
254
  wp_import_upload_form( 'admin.php?import=sp_player_csv&step=1' );
255
  echo '</div>';
256
  }
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
216
 
217
  // Show Result
218
  echo '<div class="updated settings-error below-h2"><p>
219
+ ' . wp_kses_post( sprintf( __( 'Import complete - imported <strong>%1$s</strong> players and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) ) . '
220
  </p></div>';
221
 
222
  $this->import_end();
250
  function greet() {
251
  echo '<div class="narrow">';
252
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
253
+ echo '<p>' . wp_kses_post( sprintf( __( 'Players need to be defined with columns in a specific order (8 columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/players-sample.csv' ) ) . '</p>';
254
  wp_import_upload_form( 'admin.php?import=sp_player_csv&step=1' );
255
  echo '</div>';
256
  }
includes/admin/importers/class-sp-staff-importer.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
- * @version 2.5.5
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -164,7 +164,7 @@ if ( class_exists( 'WP_Importer' ) ) {
164
 
165
  // Show Result
166
  echo '<div class="updated settings-error below-h2"><p>
167
- ' . sprintf( esc_html__( 'Import complete - imported <strong>%1$s</strong> staff and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) . '
168
  </p></div>';
169
 
170
  $this->import_end();
@@ -198,7 +198,7 @@ if ( class_exists( 'WP_Importer' ) ) {
198
  function greet() {
199
  echo '<div class="narrow">';
200
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
201
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Staff need to be defined with columns in a specific order (6 columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ) ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/staff-sample.csv' ) . '</p>';
202
  wp_import_upload_form( 'admin.php?import=sp_staff_csv&step=1' );
203
  echo '</div>';
204
  }
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
164
 
165
  // Show Result
166
  echo '<div class="updated settings-error below-h2"><p>
167
+ ' . wp_kses_post( sprintf( __( 'Import complete - imported <strong>%1$s</strong> staff and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) ) . '
168
  </p></div>';
169
 
170
  $this->import_end();
198
  function greet() {
199
  echo '<div class="narrow">';
200
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
201
+ echo '<p>' . wp_kses_post( sprintf( __( 'Staff need to be defined with columns in a specific order (6 columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/staff-sample.csv' ) ) . '</p>';
202
  wp_import_upload_form( 'admin.php?import=sp_staff_csv&step=1' );
203
  echo '</div>';
204
  }
includes/admin/importers/class-sp-team-importer.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
- * @version 2.5.5
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -120,7 +120,7 @@ if ( class_exists( 'WP_Importer' ) ) {
120
 
121
  // Show Result
122
  echo '<div class="updated settings-error below-h2"><p>
123
- ' . sprintf( esc_html__( 'Import complete - imported <strong>%1$s</strong> teams and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) . '
124
  </p></div>';
125
 
126
  $this->import_end();
@@ -144,7 +144,7 @@ if ( class_exists( 'WP_Importer' ) ) {
144
  function greet() {
145
  echo '<div class="narrow">';
146
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
147
- echo '<p>' . sprintf( wp_kses_post( esc_attr__( 'Teams need to be defined with columns in a specific order (3 columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ) ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/teams-sample.csv' ) . '</p>';
148
  wp_import_upload_form( 'admin.php?import=sp_team_csv&step=1' );
149
  echo '</div>';
150
  }
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin/Importers
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
120
 
121
  // Show Result
122
  echo '<div class="updated settings-error below-h2"><p>
123
+ ' . wp_kses_post( sprintf( __( 'Import complete - imported <strong>%1$s</strong> teams and skipped <strong>%2$s</strong>.', 'sportspress' ), esc_html( $this->imported ), esc_html( $this->skipped ) ) ) . '
124
  </p></div>';
125
 
126
  $this->import_end();
144
  function greet() {
145
  echo '<div class="narrow">';
146
  echo '<p>' . esc_html__( 'Hi there! Choose a .csv file to upload, then click "Upload file and import".', 'sportspress' ) . '</p>';
147
+ echo '<p>' . wp_kses_post( sprintf( __( 'Teams need to be defined with columns in a specific order (3 columns). <a href="%s">Click here to download a sample</a>.', 'sportspress' ), esc_url( plugin_dir_url( SP_PLUGIN_FILE ) ) . 'dummy-data/teams-sample.csv' ) ) . '</p>';
148
  wp_import_upload_form( 'admin.php?import=sp_team_csv&step=1' );
149
  echo '</div>';
150
  }
includes/admin/settings/class-sp-settings-general.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
- * @version 2.7.9
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -359,7 +359,7 @@ if ( ! class_exists( 'SP_Settings_General' ) ) :
359
  <td class="forminp">
360
  <legend class="screen-reader-text"><span><?php esc_html_e( 'Timezone', 'sportspress' ); ?></span></legend>
361
  <select id="timezone_string" name="timezone_string" class="<?php echo esc_attr( $class ); ?>">
362
- <?php echo esc_html( wp_timezone_choice( $tzstring ) ); ?>
363
  </select>
364
  </td>
365
  </tr>
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
359
  <td class="forminp">
360
  <legend class="screen-reader-text"><span><?php esc_html_e( 'Timezone', 'sportspress' ); ?></span></legend>
361
  <select id="timezone_string" name="timezone_string" class="<?php echo esc_attr( $class ); ?>">
362
+ <?php echo wp_kses( wp_timezone_choice( $tzstring ), array( 'option' => array( 'value' => array(), 'selected' => array() ) ) ); ?>
363
  </select>
364
  </td>
365
  </tr>
includes/admin/settings/class-sp-settings-status.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
- * @version 2.7.9
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
@@ -105,7 +105,7 @@ if ( ! class_exists( 'SP_Settings_Status' ) ) :
105
  $memory = sp_let_to_num( WP_MEMORY_LIMIT );
106
 
107
  if ( $memory < 67108864 ) {
108
- echo '<mark class="error">' . wp_kses_post( sprintf( esc_attr__( '%1$s - We recommend setting memory to at least 64MB. See: <a href="%2$s">Increasing memory allocated to PHP</a>', 'sportspress' ), esc_html( size_format( $memory ) ), 'http://codex.wordpress.org/Editing_wp-config.php#Increasing_memory_allocated_to_PHP' ) ) . '</mark>';
109
  } else {
110
  echo '<mark class="yes">' . esc_html( size_format( $memory ) ) . '</mark>';
111
  }
@@ -196,7 +196,7 @@ if ( ! class_exists( 'SP_Settings_Status' ) ) :
196
  $posting['soap_client']['note'] = esc_attr__( 'Your server has the SOAP Client class enabled.', 'sportspress' );
197
  $posting['soap_client']['success'] = true;
198
  } else {
199
- $posting['soap_client']['note'] = sprintf( esc_attr__( 'Your server does not have the <a href="%s">SOAP Client</a> class enabled - some gateway plugins which use SOAP may not work as expected.', 'sportspress' ), 'http://php.net/manual/en/class.soapclient.php' ) . '</mark>';
200
  $posting['soap_client']['success'] = false;
201
  }
202
 
@@ -636,7 +636,7 @@ if ( ! class_exists( 'SP_Settings_Status' ) ) :
636
  $theme_version = $status->get_file_version( $theme_file );
637
 
638
  if ( $core_version && ( empty( $theme_version ) || version_compare( $theme_version, $core_version, '<' ) ) ) {
639
- $found_files[ $plugin_name ][] = sprintf( esc_attr__( '<code>%1$s</code> version <strong style="color:red">%2$s</strong> is out of date. The core version is %3$s', 'sportspress' ), basename( $theme_file ), $theme_version ? $theme_version : '-', $core_version );
640
  } else {
641
  $found_files[ $plugin_name ][] = sprintf( '<code>%s</code>', basename( $theme_file ) );
642
  }
5
  * @author ThemeBoy
6
  * @category Admin
7
  * @package SportsPress/Admin
8
+ * @version 2.7.13
9
  */
10
 
11
  if ( ! defined( 'ABSPATH' ) ) {
105
  $memory = sp_let_to_num( WP_MEMORY_LIMIT );
106
 
107
  if ( $memory < 67108864 ) {
108
+ echo '<mark class="error">' . wp_kses_post( sprintf( __( '%1$s - We recommend setting memory to at least 64MB. See: <a href="%2$s">Increasing memory allocated to PHP</a>', 'sportspress' ), esc_html( size_format( $memory ) ), 'http://codex.wordpress.org/Editing_wp-config.php#Increasing_memory_allocated_to_PHP' ) ) . '</mark>';
109
  } else {
110
  echo '<mark class="yes">' . esc_html( size_format( $memory ) ) . '</mark>';
111
  }
196
  $posting['soap_client']['note'] = esc_attr__( 'Your server has the SOAP Client class enabled.', 'sportspress' );
197
  $posting['soap_client']['success'] = true;
198
  } else {
199
+ $posting['soap_client']['note'] = wp_kses_post( sprintf( __( 'Your server does not have the <a href="%s">SOAP Client</a> class enabled - some gateway plugins which use SOAP may not work as expected.', 'sportspress' ), 'http://php.net/manual/en/class.soapclient.php' ) ) . '</mark>';
200
  $posting['soap_client']['success'] = false;
201
  }
202
 
636
  $theme_version = $status->get_file_version( $theme_file );
637
 
638
  if ( $core_version && ( empty( $theme_version ) || version_compare( $theme_version, $core_version, '<' ) ) ) {
639
+ $found_files[ $plugin_name ][] = wp_kses_post( sprintf( __( '<code>%1$s</code> version <strong style="color:red">%2$s</strong> is out of date. The core version is %3$s', 'sportspress' ), basename( $theme_file ), $theme_version ? $theme_version : '-', $core_version ) );
640
  } else {
641
  $found_files[ $plugin_name ][] = sprintf( '<code>%s</code>', basename( $theme_file ) );
642
  }
includes/admin/views/html-admin-page-status.php CHANGED
@@ -64,7 +64,7 @@
64
  $memory = sp_let_to_num( WP_MEMORY_LIMIT );
65
 
66
  if ( $memory < 67108864 ) {
67
- echo '<mark class="error">' . wp_kses_post( sprintf( esc_attr__( '%1$s - We recommend setting memory to at least 64MB. See: <a href="%2$s">Increasing memory allocated to PHP</a>', 'sportspress' ), esc_html( size_format( $memory ) ), 'http://codex.wordpress.org/Editing_wp-config.php#Increasing_memory_allocated_to_PHP' ) ) . '</mark>';
68
  } else {
69
  echo '<mark class="yes">' . esc_html( size_format( $memory ) ) . '</mark>';
70
  }
@@ -592,7 +592,7 @@
592
  $theme_version = $this->get_file_version( $theme_file );
593
 
594
  if ( $core_version && ( empty( $theme_version ) || version_compare( $theme_version, $core_version, '<' ) ) ) {
595
- $found_files[ $plugin_name ][] = sprintf( esc_attr__( '<code>%1$s</code> version <strong style="color:red">%2$s</strong> is out of date. The core version is %3$s', 'sportspress' ), basename( $theme_file ), $theme_version ? $theme_version : '-', $core_version );
596
  } else {
597
  $found_files[ $plugin_name ][] = sprintf( '<code>%s</code>', basename( $theme_file ) );
598
  }
64
  $memory = sp_let_to_num( WP_MEMORY_LIMIT );
65
 
66
  if ( $memory < 67108864 ) {
67
+ echo '<mark class="error">' . wp_kses_post( sprintf( __( '%1$s - We recommend setting memory to at least 64MB. See: <a href="%2$s">Increasing memory allocated to PHP</a>', 'sportspress' ), esc_html( size_format( $memory ) ), 'http://codex.wordpress.org/Editing_wp-config.php#Increasing_memory_allocated_to_PHP' ) ) . '</mark>';
68
  } else {
69
  echo '<mark class="yes">' . esc_html( size_format( $memory ) ) . '</mark>';
70
  }
592
  $theme_version = $this->get_file_version( $theme_file );
593
 
594
  if ( $core_version && ( empty( $theme_version ) || version_compare( $theme_version, $core_version, '<' ) ) ) {
595
+ $found_files[ $plugin_name ][] = wp_kses_post( sprintf( __( '<code>%1$s</code> version <strong style="color:red">%2$s</strong> is out of date. The core version is %3$s', 'sportspress' ), basename( $theme_file ), $theme_version ? $theme_version : '-', $core_version ) );
596
  } else {
597
  $found_files[ $plugin_name ][] = sprintf( '<code>%s</code>', basename( $theme_file ) );
598
  }
includes/admin/views/html-notice-template-check.php CHANGED
@@ -4,7 +4,7 @@ if ( ! defined( 'ABSPATH' ) ) {
4
  }
5
  ?>
6
  <div id="message" class="updated sportspress-message wc-connect">
7
- <p><?php esc_attr_e( '<strong>Your theme has bundled outdated copies of SportsPress template files</strong> &#8211; if you encounter functionality issues on the frontend this could the reason. Ensure you update or remove them (in general we recommend only bundling the template files you actually need to customize). See the system report for full details.', 'sportspress' ); ?></p>
8
  <p class="submit"><a class="button-primary" href="
9
  <?php
10
  echo esc_url(
4
  }
5
  ?>
6
  <div id="message" class="updated sportspress-message wc-connect">
7
+ <p><?php echo wp_kses_post( __( '<strong>Your theme has bundled outdated copies of SportsPress template files</strong> &#8211; if you encounter functionality issues on the frontend this could the reason. Ensure you update or remove them (in general we recommend only bundling the template files you actually need to customize). See the system report for full details.', 'sportspress' ) ); ?></p>
8
  <p class="submit"><a class="button-primary" href="
9
  <?php
10
  echo esc_url(
includes/admin/views/html-notice-theme-support.php CHANGED
@@ -4,7 +4,7 @@ if ( ! defined( 'ABSPATH' ) ) {
4
  }
5
  ?>
6
  <div id="message" class="error sportspress-message">
7
- <p><?php esc_attr_e( '<strong>Your theme does not declare SportsPress support</strong> &#8211; if you encounter layout issues please read our integration guide or choose a SportsPress theme :)', 'sportspress' ); ?></p>
8
  <p><?php esc_attr_e( 'Have you tried the free Rookie theme yet?', 'sportspress' ); ?></p>
9
  <p class="submit">
10
  <a class="button-primary" href="<?php echo esc_url( add_query_arg( array( 'theme' => 'rookie' ), network_admin_url( 'theme-install.php' ) ) ); ?>"><?php esc_attr_e( 'Install Now', 'sportspress' ); ?></a>
4
  }
5
  ?>
6
  <div id="message" class="error sportspress-message">
7
+ <p><?php echo wp_kses_post( __( '<strong>Your theme does not declare SportsPress support</strong> &#8211; if you encounter layout issues please read our integration guide or choose a SportsPress theme :)', 'sportspress' ) ); ?></p>
8
  <p><?php esc_attr_e( 'Have you tried the free Rookie theme yet?', 'sportspress' ); ?></p>
9
  <p class="submit">
10
  <a class="button-primary" href="<?php echo esc_url( add_query_arg( array( 'theme' => 'rookie' ), network_admin_url( 'theme-install.php' ) ) ); ?>"><?php esc_attr_e( 'Install Now', 'sportspress' ); ?></a>
includes/libraries/class-tgm-plugin-activation.php CHANGED
@@ -16,2159 +16,2139 @@
16
  */
17
 
18
  /*
19
- Copyright 2011 Thomas Griffin (thomasgriffinmedia.com)
20
 
21
- This program is free software; you can redistribute it and/or modify
22
- it under the terms of the GNU General Public License, version 2, as
23
- published by the Free Software Foundation.
24
 
25
- This program is distributed in the hope that it will be useful,
26
- but WITHOUT ANY WARRANTY; without even the implied warranty of
27
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
28
- GNU General Public License for more details.
29
 
30
- You should have received a copy of the GNU General Public License
31
- along with this program; if not, write to the Free Software
32
- Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
33
  */
34
 
35
  if ( ! class_exists( 'TGM_Plugin_Activation' ) ) {
36
 
37
- /**
38
- * Automatic plugin installation and activation library.
39
- *
40
- * Creates a way to automatically install and activate plugins from within themes.
41
- * The plugins can be either bundled, downloaded from the WordPress
42
- * Plugin Repository or downloaded from another external source.
43
- *
44
- * @since 1.0.0
45
- *
46
- * @package TGM-Plugin-Activation
47
- * @author Thomas Griffin
48
- * @author Gary Jones
49
- */
50
- class TGM_Plugin_Activation {
51
- /**
52
- * TGMPA version number.
53
- *
54
- * @since 2.5.0
55
- *
56
- * @const string Version number.
57
- */
58
- const TGMPA_VERSION = '2.6.1';
59
-
60
- /**
61
- * Regular expression to test if a URL is a WP plugin repo URL.
62
- *
63
- * @const string Regex.
64
- *
65
- * @since 2.5.0
66
- */
67
- const WP_REPO_REGEX = '|^http[s]?://wordpress\.org/(?:extend/)?plugins/|';
68
-
69
- /**
70
- * Arbitrary regular expression to test if a string starts with a URL.
71
- *
72
- * @const string Regex.
73
- *
74
- * @since 2.5.0
75
- */
76
- const IS_URL_REGEX = '|^http[s]?://|';
77
-
78
- /**
79
- * Holds a copy of itself, so it can be referenced by the class name.
80
- *
81
- * @since 1.0.0
82
- *
83
- * @var TGM_Plugin_Activation
84
- */
85
- public static $instance;
86
-
87
- /**
88
- * Holds arrays of plugin details.
89
- *
90
- * @since 1.0.0
91
- * @since 2.5.0 the array has the plugin slug as an associative key.
92
- *
93
- * @var array
94
- */
95
- public $plugins = array();
96
-
97
- /**
98
- * Holds arrays of plugin names to use to sort the plugins array.
99
- *
100
- * @since 2.5.0
101
- *
102
- * @var array
103
- */
104
- protected $sort_order = array();
105
-
106
- /**
107
- * Whether any plugins have the 'force_activation' setting set to true.
108
- *
109
- * @since 2.5.0
110
- *
111
- * @var bool
112
- */
113
- protected $has_forced_activation = false;
114
-
115
- /**
116
- * Whether any plugins have the 'force_deactivation' setting set to true.
117
- *
118
- * @since 2.5.0
119
- *
120
- * @var bool
121
- */
122
- protected $has_forced_deactivation = false;
123
-
124
- /**
125
- * Name of the unique ID to hash notices.
126
- *
127
- * @since 2.4.0
128
- *
129
- * @var string
130
- */
131
- public $id = 'tgmpa';
132
-
133
- /**
134
- * Name of the query-string argument for the admin page.
135
- *
136
- * @since 1.0.0
137
- *
138
- * @var string
139
- */
140
- protected $menu = 'tgmpa-install-plugins';
141
-
142
- /**
143
- * Parent menu file slug.
144
- *
145
- * @since 2.5.0
146
- *
147
- * @var string
148
- */
149
- public $parent_slug = 'themes.php';
150
-
151
- /**
152
- * Capability needed to view the plugin installation menu item.
153
- *
154
- * @since 2.5.0
155
- *
156
- * @var string
157
- */
158
- public $capability = 'edit_theme_options';
159
-
160
- /**
161
- * Default absolute path to folder containing bundled plugin zip files.
162
- *
163
- * @since 2.0.0
164
- *
165
- * @var string Absolute path prefix to zip file location for bundled plugins. Default is empty string.
166
- */
167
- public $default_path = '';
168
-
169
- /**
170
- * Flag to show admin notices or not.
171
- *
172
- * @since 2.1.0
173
- *
174
- * @var boolean
175
- */
176
- public $has_notices = true;
177
-
178
- /**
179
- * Flag to determine if the user can dismiss the notice nag.
180
- *
181
- * @since 2.4.0
182
- *
183
- * @var boolean
184
- */
185
- public $dismissable = true;
186
-
187
- /**
188
- * Message to be output above nag notice if dismissable is false.
189
- *
190
- * @since 2.4.0
191
- *
192
- * @var string
193
- */
194
- public $dismiss_msg = '';
195
-
196
- /**
197
- * Flag to set automatic activation of plugins. Off by default.
198
- *
199
- * @since 2.2.0
200
- *
201
- * @var boolean
202
- */
203
- public $is_automatic = false;
204
-
205
- /**
206
- * Optional message to display before the plugins table.
207
- *
208
- * @since 2.2.0
209
- *
210
- * @var string Message filtered by wp_kses_post(). Default is empty string.
211
- */
212
- public $message = '';
213
-
214
- /**
215
- * Holds configurable array of strings.
216
- *
217
- * Default values are added in the constructor.
218
- *
219
- * @since 2.0.0
220
- *
221
- * @var array
222
- */
223
- public $strings = array();
224
-
225
- /**
226
- * Holds the version of WordPress.
227
- *
228
- * @since 2.4.0
229
- *
230
- * @var int
231
- */
232
- public $wp_version;
233
-
234
- /**
235
- * Holds the hook name for the admin page.
236
- *
237
- * @since 2.5.0
238
- *
239
- * @var string
240
- */
241
- public $page_hook;
242
-
243
- /**
244
- * Adds a reference of this object to $instance, populates default strings,
245
- * does the tgmpa_init action hook, and hooks in the interactions to init.
246
- *
247
- * {@internal This method should be `protected`, but as too many TGMPA implementations
248
- * haven't upgraded beyond v2.3.6 yet, this gives backward compatibility issues.
249
- * Reverted back to public for the time being.}}
250
- *
251
- * @since 1.0.0
252
- *
253
- * @see TGM_Plugin_Activation::init()
254
- */
255
- public function __construct() {
256
- // Set the current WordPress version.
257
- $this->wp_version = $GLOBALS['wp_version'];
258
-
259
- // Announce that the class is ready, and pass the object (for advanced use).
260
- do_action_ref_array( 'tgmpa_init', array( $this ) );
261
-
262
- /*
263
- * Load our text domain and allow for overloading the fall-back file.
264
- *
265
- * {@internal IMPORTANT! If this code changes, review the regex in the custom TGMPA
266
- * generator on the website.}}
267
- */
268
- add_action( 'init', array( $this, 'load_textdomain' ), 5 );
269
- add_filter( 'load_textdomain_mofile', array( $this, 'overload_textdomain_mofile' ), 10, 2 );
270
-
271
- // When the rest of WP has loaded, kick-start the rest of the class.
272
- add_action( 'init', array( $this, 'init' ) );
273
- }
274
-
275
- /**
276
- * Magic method to (not) set protected properties from outside of this class.
277
- *
278
- * {@internal hackedihack... There is a serious bug in v2.3.2 - 2.3.6 where the `menu` property
279
- * is being assigned rather than tested in a conditional, effectively rendering it useless.
280
- * This 'hack' prevents this from happening.}}
281
- *
282
- * @see https://github.com/TGMPA/TGM-Plugin-Activation/blob/2.3.6/tgm-plugin-activation/class-tgm-plugin-activation.php#L1593
283
- *
284
- * @since 2.5.2
285
- *
286
- * @param string $name Name of an inaccessible property.
287
- * @param mixed $value Value to assign to the property.
288
- * @return void Silently fail to set the property when this is tried from outside of this class context.
289
- * (Inside this class context, the __set() method if not used as there is direct access.)
290
- */
291
- public function __set( $name, $value ) {
292
- return;
293
- }
294
-
295
- /**
296
- * Magic method to get the value of a protected property outside of this class context.
297
- *
298
- * @since 2.5.2
299
- *
300
- * @param string $name Name of an inaccessible property.
301
- * @return mixed The property value.
302
- */
303
- public function __get( $name ) {
304
- return $this->{$name};
305
- }
306
-
307
- /**
308
- * Initialise the interactions between this class and WordPress.
309
- *
310
- * Hooks in three new methods for the class: admin_menu, notices and styles.
311
- *
312
- * @since 2.0.0
313
- *
314
- * @see TGM_Plugin_Activation::admin_menu()
315
- * @see TGM_Plugin_Activation::notices()
316
- * @see TGM_Plugin_Activation::styles()
317
- */
318
- public function init() {
319
- /**
320
- * By default TGMPA only loads on the WP back-end and not in an Ajax call. Using this filter
321
- * you can overrule that behaviour.
322
- *
323
- * @since 2.5.0
324
- *
325
- * @param bool $load Whether or not TGMPA should load.
326
- * Defaults to the return of `is_admin() && ! defined( 'DOING_AJAX' )`.
327
- */
328
- if ( true !== apply_filters( 'tgmpa_load', ( is_admin() && ! defined( 'DOING_AJAX' ) ) ) ) {
329
- return;
330
- }
331
-
332
- // Load class strings.
333
- $this->strings = array(
334
- 'page_title' => esc_attr__( 'Install Required Plugins', 'tgmpa' ),
335
- 'menu_title' => esc_attr__( 'Install Plugins', 'tgmpa' ),
336
- /* translators: %s: plugin name. */
337
- 'installing' => esc_attr__( 'Installing Plugin: %s', 'tgmpa' ),
338
- /* translators: %s: plugin name. */
339
- 'updating' => esc_attr__( 'Updating Plugin: %s', 'tgmpa' ),
340
- 'oops' => esc_attr__( 'Something went wrong with the plugin API.', 'tgmpa' ),
341
- 'notice_can_install_required' => _n_noop(
342
- /* translators: 1: plugin name(s). */
343
- 'This theme requires the following plugin: %1$s.',
344
- 'This theme requires the following plugins: %1$s.',
345
- 'tgmpa'
346
- ),
347
- 'notice_can_install_recommended' => _n_noop(
348
- /* translators: 1: plugin name(s). */
349
- 'This theme recommends the following plugin: %1$s.',
350
- 'This theme recommends the following plugins: %1$s.',
351
- 'tgmpa'
352
- ),
353
- 'notice_ask_to_update' => _n_noop(
354
- /* translators: 1: plugin name(s). */
355
- 'The following plugin needs to be updated to its latest version to ensure maximum compatibility with this theme: %1$s.',
356
- 'The following plugins need to be updated to their latest version to ensure maximum compatibility with this theme: %1$s.',
357
- 'tgmpa'
358
- ),
359
- 'notice_ask_to_update_maybe' => _n_noop(
360
- /* translators: 1: plugin name(s). */
361
- 'There is an update available for: %1$s.',
362
- 'There are updates available for the following plugins: %1$s.',
363
- 'tgmpa'
364
- ),
365
- 'notice_can_activate_required' => _n_noop(
366
- /* translators: 1: plugin name(s). */
367
- 'The following required plugin is currently inactive: %1$s.',
368
- 'The following required plugins are currently inactive: %1$s.',
369
- 'tgmpa'
370
- ),
371
- 'notice_can_activate_recommended' => _n_noop(
372
- /* translators: 1: plugin name(s). */
373
- 'The following recommended plugin is currently inactive: %1$s.',
374
- 'The following recommended plugins are currently inactive: %1$s.',
375
- 'tgmpa'
376
- ),
377
- 'install_link' => _n_noop(
378
- 'Begin installing plugin',
379
- 'Begin installing plugins',
380
- 'tgmpa'
381
- ),
382
- 'update_link' => _n_noop(
383
- 'Begin updating plugin',
384
- 'Begin updating plugins',
385
- 'tgmpa'
386
- ),
387
- 'activate_link' => _n_noop(
388
- 'Begin activating plugin',
389
- 'Begin activating plugins',
390
- 'tgmpa'
391
- ),
392
- 'return' => esc_attr__( 'Return to Required Plugins Installer', 'tgmpa' ),
393
- 'dashboard' => esc_attr__( 'Return to the Dashboard', 'tgmpa' ),
394
- 'plugin_activated' => esc_attr__( 'Plugin activated successfully.', 'tgmpa' ),
395
- 'activated_successfully' => esc_attr__( 'The following plugin was activated successfully:', 'tgmpa' ),
396
- /* translators: 1: plugin name. */
397
- 'plugin_already_active' => esc_attr__( 'No action taken. Plugin %1$s was already active.', 'tgmpa' ),
398
- /* translators: 1: plugin name. */
399
- 'plugin_needs_higher_version' => esc_attr__( 'Plugin not activated. A higher version of %s is needed for this theme. Please update the plugin.', 'tgmpa' ),
400
- /* translators: 1: dashboard link. */
401
- 'complete' => esc_attr__( 'All plugins installed and activated successfully. %1$s', 'tgmpa' ),
402
- 'dismiss' => esc_attr__( 'Dismiss this notice', 'tgmpa' ),
403
- 'notice_cannot_install_activate' => esc_attr__( 'There are one or more required or recommended plugins to install, update or activate.', 'tgmpa' ),
404
- 'contact_admin' => esc_attr__( 'Please contact the administrator of this site for help.', 'tgmpa' ),
405
- );
406
-
407
- do_action( 'tgmpa_register' );
408
-
409
- /* After this point, the plugins should be registered and the configuration set. */
410
-
411
- // Proceed only if we have plugins to handle.
412
- if ( empty( $this->plugins ) || ! is_array( $this->plugins ) ) {
413
- return;
414
- }
415
-
416
- // Set up the menu and notices if we still have outstanding actions.
417
- if ( true !== $this->is_tgmpa_complete() ) {
418
- // Sort the plugins.
419
- array_multisort( $this->sort_order, SORT_ASC, $this->plugins );
420
-
421
- add_action( 'admin_menu', array( $this, 'admin_menu' ) );
422
- add_action( 'admin_head', array( $this, 'dismiss' ) );
423
-
424
- // Prevent the normal links from showing underneath a single install/update page.
425
- add_filter( 'install_plugin_complete_actions', array( $this, 'actions' ) );
426
- add_filter( 'update_plugin_complete_actions', array( $this, 'actions' ) );
427
-
428
- if ( $this->has_notices ) {
429
- add_action( 'admin_notices', array( $this, 'notices' ) );
430
- add_action( 'admin_init', array( $this, 'admin_init' ), 1 );
431
- add_action( 'admin_enqueue_scripts', array( $this, 'thickbox' ) );
432
- }
433
- }
434
-
435
- // If needed, filter plugin action links.
436
- add_action( 'load-plugins.php', array( $this, 'add_plugin_action_link_filters' ), 1 );
437
-
438
- // Make sure things get reset on switch theme.
439
- add_action( 'switch_theme', array( $this, 'flush_plugins_cache' ) );
440
-
441
- if ( $this->has_notices ) {
442
- add_action( 'switch_theme', array( $this, 'update_dismiss' ) );
443
- }
444
-
445
- // Setup the force activation hook.
446
- if ( true === $this->has_forced_activation ) {
447
- add_action( 'admin_init', array( $this, 'force_activation' ) );
448
- }
449
-
450
- // Setup the force deactivation hook.
451
- if ( true === $this->has_forced_deactivation ) {
452
- add_action( 'switch_theme', array( $this, 'force_deactivation' ) );
453
- }
454
- }
455
-
456
- /**
457
- * Load translations.
458
- *
459
- * @since 2.6.0
460
- *
461
- * (@internal Uses `load_theme_textdomain()` rather than `load_plugin_textdomain()` to
462
- * get round the different ways of handling the path and deprecated notices being thrown
463
- * and such. For plugins, the actual file name will be corrected by a filter.}}
464
- *
465
- * {@internal IMPORTANT! If this function changes, review the regex in the custom TGMPA
466
- * generator on the website.}}
467
- */
468
- public function load_textdomain() {
469
- if ( is_textdomain_loaded( 'tgmpa' ) ) {
470
- return;
471
- }
472
-
473
- if ( false !== strpos( __FILE__, WP_PLUGIN_DIR ) || false !== strpos( __FILE__, WPMU_PLUGIN_DIR ) ) {
474
- // Plugin, we'll need to adjust the file name.
475
- add_action( 'load_textdomain_mofile', array( $this, 'correct_plugin_mofile' ), 10, 2 );
476
- load_theme_textdomain( 'tgmpa', dirname( __FILE__ ) . '/languages' );
477
- remove_action( 'load_textdomain_mofile', array( $this, 'correct_plugin_mofile' ), 10 );
478
- } else {
479
- load_theme_textdomain( 'tgmpa', dirname( __FILE__ ) . '/languages' );
480
- }
481
- }
482
-
483
- /**
484
- * Correct the .mo file name for (must-use) plugins.
485
- *
486
- * Themese use `/path/{locale}.mo` while plugins use `/path/{text-domain}-{locale}.mo`.
487
- *
488
- * {@internal IMPORTANT! If this function changes, review the regex in the custom TGMPA
489
- * generator on the website.}}
490
- *
491
- * @since 2.6.0
492
- *
493
- * @param string $mofile Full path to the target mofile.
494
- * @param string $domain The domain for which a language file is being loaded.
495
- * @return string $mofile
496
- */
497
- public function correct_plugin_mofile( $mofile, $domain ) {
498
- // Exit early if not our domain (just in case).
499
- if ( 'tgmpa' !== $domain ) {
500
- return $mofile;
501
- }
502
- return preg_replace( '`/([a-z]{2}_[A-Z]{2}.mo)$`', '/tgmpa-$1', $mofile );
503
- }
504
-
505
- /**
506
- * Potentially overload the fall-back translation file for the current language.
507
- *
508
- * WP, by default since WP 3.7, will load a local translation first and if none
509
- * can be found, will try and find a translation in the /wp-content/languages/ directory.
510
- * As this library is theme/plugin agnostic, translation files for TGMPA can exist both
511
- * in the WP_LANG_DIR /plugins/ subdirectory as well as in the /themes/ subdirectory.
512
- *
513
- * This method makes sure both directories are checked.
514
- *
515
- * {@internal IMPORTANT! If this function changes, review the regex in the custom TGMPA
516
- * generator on the website.}}
517
- *
518
- * @since 2.6.0
519
- *
520
- * @param string $mofile Full path to the target mofile.
521
- * @param string $domain The domain for which a language file is being loaded.
522
- * @return string $mofile
523
- */
524
- public function overload_textdomain_mofile( $mofile, $domain ) {
525
- // Exit early if not our domain, not a WP_LANG_DIR load or if the file exists and is readable.
526
- if ( 'tgmpa' !== $domain || false === strpos( $mofile, WP_LANG_DIR ) || @is_readable( $mofile ) ) {
527
- return $mofile;
528
- }
529
-
530
- // Current fallback file is not valid, let's try the alternative option.
531
- if ( false !== strpos( $mofile, '/themes/' ) ) {
532
- return str_replace( '/themes/', '/plugins/', $mofile );
533
- } elseif ( false !== strpos( $mofile, '/plugins/' ) ) {
534
- return str_replace( '/plugins/', '/themes/', $mofile );
535
- } else {
536
- return $mofile;
537
- }
538
- }
539
-
540
- /**
541
- * Hook in plugin action link filters for the WP native plugins page.
542
- *
543
- * - Prevent activation of plugins which don't meet the minimum version requirements.
544
- * - Prevent deactivation of force-activated plugins.
545
- * - Add update notice if update available.
546
- *
547
- * @since 2.5.0
548
- */
549
- public function add_plugin_action_link_filters() {
550
- foreach ( $this->plugins as $slug => $plugin ) {
551
- if ( false === $this->can_plugin_activate( $slug ) ) {
552
- add_filter( 'plugin_action_links_' . $plugin['file_path'], array( $this, 'filter_plugin_action_links_activate' ), 20 );
553
- }
554
-
555
- if ( true === $plugin['force_activation'] ) {
556
- add_filter( 'plugin_action_links_' . $plugin['file_path'], array( $this, 'filter_plugin_action_links_deactivate' ), 20 );
557
- }
558
-
559
- if ( false !== $this->does_plugin_require_update( $slug ) ) {
560
- add_filter( 'plugin_action_links_' . $plugin['file_path'], array( $this, 'filter_plugin_action_links_update' ), 20 );
561
- }
562
- }
563
- }
564
-
565
- /**
566
- * Remove the 'Activate' link on the WP native plugins page if the plugin does not meet the
567
- * minimum version requirements.
568
- *
569
- * @since 2.5.0
570
- *
571
- * @param array $actions Action links.
572
- * @return array
573
- */
574
- public function filter_plugin_action_links_activate( $actions ) {
575
- unset( $actions['activate'] );
576
-
577
- return $actions;
578
- }
579
-
580
- /**
581
- * Remove the 'Deactivate' link on the WP native plugins page if the plugin has been set to force activate.
582
- *
583
- * @since 2.5.0
584
- *
585
- * @param array $actions Action links.
586
- * @return array
587
- */
588
- public function filter_plugin_action_links_deactivate( $actions ) {
589
- unset( $actions['deactivate'] );
590
-
591
- return $actions;
592
- }
593
-
594
- /**
595
- * Add a 'Requires update' link on the WP native plugins page if the plugin does not meet the
596
- * minimum version requirements.
597
- *
598
- * @since 2.5.0
599
- *
600
- * @param array $actions Action links.
601
- * @return array
602
- */
603
- public function filter_plugin_action_links_update( $actions ) {
604
- $actions['update'] = sprintf(
605
- '<a href="%1$s" title="%2$s" class="edit">%3$s</a>',
606
- esc_url( $this->get_tgmpa_status_url( 'update' ) ),
607
- esc_attr__( 'This plugin needs to be updated to be compatible with your theme.', 'tgmpa' ),
608
- esc_html__( 'Update Required', 'tgmpa' )
609
- );
610
-
611
- return $actions;
612
- }
613
-
614
- /**
615
- * Handles calls to show plugin information via links in the notices.
616
- *
617
- * We get the links in the admin notices to point to the TGMPA page, rather
618
- * than the typical plugin-install.php file, so we can prepare everything
619
- * beforehand.
620
- *
621
- * WP does not make it easy to show the plugin information in the thickbox -
622
- * here we have to require a file that includes a function that does the
623
- * main work of displaying it, enqueue some styles, set up some globals and
624
- * finally call that function before exiting.
625
- *
626
- * Down right easy once you know how...
627
- *
628
- * Returns early if not the TGMPA page.
629
- *
630
- * @since 2.1.0
631
- *
632
- * @global string $tab Used as iframe div class names, helps with styling
633
- * @global string $body_id Used as the iframe body ID, helps with styling
634
- *
635
- * @return null Returns early if not the TGMPA page.
636
- */
637
- public function admin_init() {
638
- if ( ! $this->is_tgmpa_page() ) {
639
- return;
640
- }
641
-
642
- if ( isset( $_REQUEST['tab'] ) && 'plugin-information' === $_REQUEST['tab'] ) {
643
- // Needed for install_plugin_information().
644
- require_once ABSPATH . 'wp-admin/includes/plugin-install.php';
645
-
646
- wp_enqueue_style( 'plugin-install' );
647
-
648
- global $tab, $body_id;
649
- $body_id = 'plugin-information';
650
- // @codingStandardsIgnoreStart
651
- $tab = 'plugin-information';
652
- // @codingStandardsIgnoreEnd
653
-
654
- install_plugin_information();
655
-
656
- exit;
657
- }
658
- }
659
-
660
- /**
661
- * Enqueue thickbox scripts/styles for plugin info.
662
- *
663
- * Thickbox is not automatically included on all admin pages, so we must
664
- * manually enqueue it for those pages.
665
- *
666
- * Thickbox is only loaded if the user has not dismissed the admin
667
- * notice or if there are any plugins left to install and activate.
668
- *
669
- * @since 2.1.0
670
- */
671
- public function thickbox() {
672
- if ( ! get_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice_' . $this->id, true ) ) {
673
- add_thickbox();
674
- }
675
- }
676
-
677
- /**
678
- * Adds submenu page if there are plugin actions to take.
679
- *
680
- * This method adds the submenu page letting users know that a required
681
- * plugin needs to be installed.
682
- *
683
- * This page disappears once the plugin has been installed and activated.
684
- *
685
- * @since 1.0.0
686
- *
687
- * @see TGM_Plugin_Activation::init()
688
- * @see TGM_Plugin_Activation::install_plugins_page()
689
- *
690
- * @return null Return early if user lacks capability to install a plugin.
691
- */
692
- public function admin_menu() {
693
- // Make sure privileges are correct to see the page.
694
- if ( ! current_user_can( 'install_plugins' ) ) {
695
- return;
696
- }
697
-
698
- $args = apply_filters(
699
- 'tgmpa_admin_menu_args',
700
- array(
701
- 'parent_slug' => $this->parent_slug, // Parent Menu slug.
702
- 'page_title' => $this->strings['page_title'], // Page title.
703
- 'menu_title' => $this->strings['menu_title'], // Menu title.
704
- 'capability' => $this->capability, // Capability.
705
- 'menu_slug' => $this->menu, // Menu slug.
706
- 'function' => array( $this, 'install_plugins_page' ), // Callback.
707
- )
708
- );
709
-
710
- $this->add_admin_menu( $args );
711
- }
712
-
713
- /**
714
- * Add the menu item.
715
- *
716
- * {@internal IMPORTANT! If this function changes, review the regex in the custom TGMPA
717
- * generator on the website.}}
718
- *
719
- * @since 2.5.0
720
- *
721
- * @param array $args Menu item configuration.
722
- */
723
- protected function add_admin_menu( array $args ) {
724
- if ( has_filter( 'tgmpa_admin_menu_use_add_theme_page' ) ) {
725
- _deprecated_function( 'The "tgmpa_admin_menu_use_add_theme_page" filter', '2.5.0', esc_html__( 'Set the parent_slug config variable instead.', 'tgmpa' ) );
726
- }
727
-
728
- if ( 'themes.php' === $this->parent_slug ) {
729
- $this->page_hook = call_user_func( 'add_theme_page', $args['page_title'], $args['menu_title'], $args['capability'], $args['menu_slug'], $args['function'] );
730
- } else {
731
- $this->page_hook = call_user_func( 'add_submenu_page', $args['parent_slug'], $args['page_title'], $args['menu_title'], $args['capability'], $args['menu_slug'], $args['function'] );
732
- }
733
- }
734
-
735
- /**
736
- * Echoes plugin installation form.
737
- *
738
- * This method is the callback for the admin_menu method function.
739
- * This displays the admin page and form area where the user can select to install and activate the plugin.
740
- * Aborts early if we're processing a plugin installation action.
741
- *
742
- * @since 1.0.0
743
- *
744
- * @return null Aborts early if we're processing a plugin installation action.
745
- */
746
- public function install_plugins_page() {
747
- // Store new instance of plugin table in object.
748
- $plugin_table = new TGMPA_List_Table();
749
-
750
- // Return early if processing a plugin installation action.
751
- if ( ( ( 'tgmpa-bulk-install' === $plugin_table->current_action() || 'tgmpa-bulk-update' === $plugin_table->current_action() ) && $plugin_table->process_bulk_actions() ) || $this->do_plugin_install() ) {
752
- return;
753
- }
754
-
755
- // Force refresh of available plugin information so we'll know about manual updates/deletes.
756
- wp_clean_plugins_cache( false );
757
-
758
- ?>
759
- <div class="tgmpa wrap">
760
- <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
761
- <?php $plugin_table->prepare_items(); ?>
762
-
763
- <?php
764
- if ( ! empty( $this->message ) && is_string( $this->message ) ) {
765
- echo wp_kses_post( $this->message );
766
- }
767
- ?>
768
- <?php $plugin_table->views(); ?>
769
-
770
- <form id="tgmpa-plugins" action="" method="post">
771
- <input type="hidden" name="tgmpa-page" value="<?php echo esc_attr( $this->menu ); ?>" />
772
- <input type="hidden" name="plugin_status" value="<?php echo esc_attr( $plugin_table->view_context ); ?>" />
773
- <?php $plugin_table->display(); ?>
774
- </form>
775
- </div>
776
- <?php
777
- }
778
-
779
- /**
780
- * Installs, updates or activates a plugin depending on the action link clicked by the user.
781
- *
782
- * Checks the $_GET variable to see which actions have been
783
- * passed and responds with the appropriate method.
784
- *
785
- * Uses WP_Filesystem to process and handle the plugin installation
786
- * method.
787
- *
788
- * @since 1.0.0
789
- *
790
- * @uses WP_Filesystem
791
- * @uses WP_Error
792
- * @uses WP_Upgrader
793
- * @uses Plugin_Upgrader
794
- * @uses Plugin_Installer_Skin
795
- * @uses Plugin_Upgrader_Skin
796
- *
797
- * @return boolean True on success, false on failure.
798
- */
799
- protected function do_plugin_install() {
800
- if ( empty( $_GET['plugin'] ) ) {
801
- return false;
802
- }
803
-
804
- // All plugin information will be stored in an array for processing.
805
- $slug = $this->sanitize_key( urldecode( $_GET['plugin'] ) );
806
-
807
- if ( ! isset( $this->plugins[ $slug ] ) ) {
808
- return false;
809
- }
810
-
811
- // Was an install or upgrade action link clicked?
812
- if ( ( isset( $_GET['tgmpa-install'] ) && 'install-plugin' === $_GET['tgmpa-install'] ) || ( isset( $_GET['tgmpa-update'] ) && 'update-plugin' === $_GET['tgmpa-update'] ) ) {
813
-
814
- $install_type = 'install';
815
- if ( isset( $_GET['tgmpa-update'] ) && 'update-plugin' === $_GET['tgmpa-update'] ) {
816
- $install_type = 'update';
817
- }
818
-
819
- check_admin_referer( 'tgmpa-' . $install_type, 'tgmpa-nonce' );
820
-
821
- // Pass necessary information via URL if WP_Filesystem is needed.
822
- $url = wp_nonce_url(
823
- add_query_arg(
824
- array(
825
- 'plugin' => urlencode( $slug ),
826
- 'tgmpa-' . $install_type => $install_type . '-plugin',
827
- ),
828
- $this->get_tgmpa_url()
829
- ),
830
- 'tgmpa-' . $install_type,
831
- 'tgmpa-nonce'
832
- );
833
-
834
- $method = ''; // Leave blank so WP_Filesystem can populate it as necessary.
835
-
836
- if ( false === ( $creds = request_filesystem_credentials( esc_url_raw( $url ), $method, false, false, array() ) ) ) {
837
- return true;
838
- }
839
-
840
- if ( ! WP_Filesystem( $creds ) ) {
841
- request_filesystem_credentials( esc_url_raw( $url ), $method, true, false, array() ); // Setup WP_Filesystem.
842
- return true;
843
- }
844
-
845
- /* If we arrive here, we have the filesystem. */
846
-
847
- // Prep variables for Plugin_Installer_Skin class.
848
- $extra = array();
849
- $extra['slug'] = $slug; // Needed for potentially renaming of directory name.
850
- $source = $this->get_download_url( $slug );
851
- $api = ( 'repo' === $this->plugins[ $slug ]['source_type'] ) ? $this->get_plugins_api( $slug ) : null;
852
- $api = ( false !== $api ) ? $api : null;
853
-
854
- $url = add_query_arg(
855
- array(
856
- 'action' => $install_type . '-plugin',
857
- 'plugin' => urlencode( $slug ),
858
- ),
859
- 'update.php'
860
- );
861
-
862
- if ( ! class_exists( 'Plugin_Upgrader', false ) ) {
863
- require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
864
- }
865
-
866
- $title = ( 'update' === $install_type ) ? $this->strings['updating'] : $this->strings['installing'];
867
- $skin_args = array(
868
- 'type' => ( 'bundled' !== $this->plugins[ $slug ]['source_type'] ) ? 'web' : 'upload',
869
- 'title' => sprintf( $title, $this->plugins[ $slug ]['name'] ),
870
- 'url' => esc_url_raw( $url ),
871
- 'nonce' => $install_type . '-plugin_' . $slug,
872
- 'plugin' => '',
873
- 'api' => $api,
874
- 'extra' => $extra,
875
- );
876
- unset( $title );
877
-
878
- if ( 'update' === $install_type ) {
879
- $skin_args['plugin'] = $this->plugins[ $slug ]['file_path'];
880
- $skin = new Plugin_Upgrader_Skin( $skin_args );
881
- } else {
882
- $skin = new Plugin_Installer_Skin( $skin_args );
883
- }
884
-
885
- // Create a new instance of Plugin_Upgrader.
886
- $upgrader = new Plugin_Upgrader( $skin );
887
-
888
- // Perform the action and install the plugin from the $source urldecode().
889
- add_filter( 'upgrader_source_selection', array( $this, 'maybe_adjust_source_dir' ), 1, 3 );
890
-
891
- if ( 'update' === $install_type ) {
892
- // Inject our info into the update transient.
893
- $to_inject = array( $slug => $this->plugins[ $slug ] );
894
- $to_inject[ $slug ]['source'] = $source;
895
- $this->inject_update_info( $to_inject );
896
-
897
- $upgrader->upgrade( $this->plugins[ $slug ]['file_path'] );
898
- } else {
899
- $upgrader->install( $source );
900
- }
901
-
902
- remove_filter( 'upgrader_source_selection', array( $this, 'maybe_adjust_source_dir' ), 1 );
903
-
904
- // Make sure we have the correct file path now the plugin is installed/updated.
905
- $this->populate_file_path( $slug );
906
-
907
- // Only activate plugins if the config option is set to true and the plugin isn't
908
- // already active (upgrade).
909
- if ( $this->is_automatic && ! $this->is_plugin_active( $slug ) ) {
910
- $plugin_activate = $upgrader->plugin_info(); // Grab the plugin info from the Plugin_Upgrader method.
911
- if ( false === $this->activate_single_plugin( $plugin_activate, $slug, true ) ) {
912
- return true; // Finish execution of the function early as we encountered an error.
913
- }
914
- }
915
-
916
- $this->show_tgmpa_version();
917
-
918
- // Display message based on if all plugins are now active or not.
919
- if ( $this->is_tgmpa_complete() ) {
920
- echo '<p>', sprintf( esc_html( $this->strings['complete'] ), '<a href="' . esc_url( self_admin_url() ) . '">' . esc_html__( 'Return to the Dashboard', 'tgmpa' ) . '</a>' ), '</p>';
921
- echo '<style type="text/css">#adminmenu .wp-submenu li.current { display: none !important; }</style>';
922
- } else {
923
- echo '<p><a href="', esc_url( $this->get_tgmpa_url() ), '" target="_parent">', esc_html( $this->strings['return'] ), '</a></p>';
924
- }
925
-
926
- return true;
927
- } elseif ( isset( $this->plugins[ $slug ]['file_path'], $_GET['tgmpa-activate'] ) && 'activate-plugin' === $_GET['tgmpa-activate'] ) {
928
- // Activate action link was clicked.
929
- check_admin_referer( 'tgmpa-activate', 'tgmpa-nonce' );
930
-
931
- if ( false === $this->activate_single_plugin( $this->plugins[ $slug ]['file_path'], $slug ) ) {
932
- return true; // Finish execution of the function early as we encountered an error.
933
- }
934
- }
935
-
936
- return false;
937
- }
938
-
939
- /**
940
- * Inject information into the 'update_plugins' site transient as WP checks that before running an update.
941
- *
942
- * @since 2.5.0
943
- *
944
- * @param array $plugins The plugin information for the plugins which are to be updated.
945
- */
946
- public function inject_update_info( $plugins ) {
947
- $repo_updates = get_site_transient( 'update_plugins' );
948
-
949
- if ( ! is_object( $repo_updates ) ) {
950
- $repo_updates = new stdClass();
951
- }
952
-
953
- foreach ( $plugins as $slug => $plugin ) {
954
- $file_path = $plugin['file_path'];
955
-
956
- if ( empty( $repo_updates->response[ $file_path ] ) ) {
957
- $repo_updates->response[ $file_path ] = new stdClass();
958
- }
959
-
960
- // We only really need to set package, but let's do all we can in case WP changes something.
961
- $repo_updates->response[ $file_path ]->slug = $slug;
962
- $repo_updates->response[ $file_path ]->plugin = $file_path;
963
- $repo_updates->response[ $file_path ]->new_version = $plugin['version'];
964
- $repo_updates->response[ $file_path ]->package = $plugin['source'];
965
- if ( empty( $repo_updates->response[ $file_path ]->url ) && ! empty( $plugin['external_url'] ) ) {
966
- $repo_updates->response[ $file_path ]->url = $plugin['external_url'];
967
- }
968
- }
969
-
970
- set_site_transient( 'update_plugins', $repo_updates );
971
- }
972
-
973
- /**
974
- * Adjust the plugin directory name if necessary.
975
- *
976
- * The final destination directory of a plugin is based on the subdirectory name found in the
977
- * (un)zipped source. In some cases - most notably GitHub repository plugin downloads -, this
978
- * subdirectory name is not the same as the expected slug and the plugin will not be recognized
979
- * as installed. This is fixed by adjusting the temporary unzipped source subdirectory name to
980
- * the expected plugin slug.
981
- *
982
- * @since 2.5.0
983
- *
984
- * @param string $source Path to upgrade/zip-file-name.tmp/subdirectory/.
985
- * @param string $remote_source Path to upgrade/zip-file-name.tmp.
986
- * @param \WP_Upgrader $upgrader Instance of the upgrader which installs the plugin.
987
- * @return string $source
988
- */
989
- public function maybe_adjust_source_dir( $source, $remote_source, $upgrader ) {
990
- if ( ! $this->is_tgmpa_page() || ! is_object( $GLOBALS['wp_filesystem'] ) ) {
991
- return $source;
992
- }
993
-
994
- // Check for single file plugins.
995
- $source_files = array_keys( $GLOBALS['wp_filesystem']->dirlist( $remote_source ) );
996
- if ( 1 === count( $source_files ) && false === $GLOBALS['wp_filesystem']->is_dir( $source ) ) {
997
- return $source;
998
- }
999
-
1000
- // Multi-file plugin, let's see if the directory is correctly named.
1001
- $desired_slug = '';
1002
-
1003
- // Figure out what the slug is supposed to be.
1004
- if ( false === $upgrader->bulk && ! empty( $upgrader->skin->options['extra']['slug'] ) ) {
1005
- $desired_slug = $upgrader->skin->options['extra']['slug'];
1006
- } else {
1007
- // Bulk installer contains less info, so fall back on the info registered here.
1008
- foreach ( $this->plugins as $slug => $plugin ) {
1009
- if ( ! empty( $upgrader->skin->plugin_names[ $upgrader->skin->i ] ) && $plugin['name'] === $upgrader->skin->plugin_names[ $upgrader->skin->i ] ) {
1010
- $desired_slug = $slug;
1011
- break;
1012
- }
1013
- }
1014
- unset( $slug, $plugin );
1015
- }
1016
-
1017
- if ( ! empty( $desired_slug ) ) {
1018
- $subdir_name = untrailingslashit( str_replace( trailingslashit( $remote_source ), '', $source ) );
1019
-
1020
- if ( ! empty( $subdir_name ) && $subdir_name !== $desired_slug ) {
1021
- $from_path = untrailingslashit( $source );
1022
- $to_path = trailingslashit( $remote_source ) . $desired_slug;
1023
-
1024
- if ( true === $GLOBALS['wp_filesystem']->move( $from_path, $to_path ) ) {
1025
- return trailingslashit( $to_path );
1026
- } else {
1027
- return new WP_Error(
1028
- 'rename_failed',
1029
- esc_html__( 'The remote plugin package does not contain a folder with the desired slug and renaming did not work.', 'tgmpa' ) . ' ' . esc_html__( 'Please contact the plugin provider and ask them to package their plugin according to the WordPress guidelines.', 'tgmpa' ),
1030
- array(
1031
- 'found' => $subdir_name,
1032
- 'expected' => $desired_slug,
1033
- )
1034
- );
1035
- }
1036
- } elseif ( empty( $subdir_name ) ) {
1037
- return new WP_Error(
1038
- 'packaged_wrong',
1039
- esc_html__( 'The remote plugin package consists of more than one file, but the files are not packaged in a folder.', 'tgmpa' ) . ' ' . esc_html__( 'Please contact the plugin provider and ask them to package their plugin according to the WordPress guidelines.', 'tgmpa' ),
1040
- array(
1041
- 'found' => $subdir_name,
1042
- 'expected' => $desired_slug,
1043
- )
1044
- );
1045
- }
1046
- }
1047
-
1048
- return $source;
1049
- }
1050
-
1051
- /**
1052
- * Activate a single plugin and send feedback about the result to the screen.
1053
- *
1054
- * @since 2.5.0
1055
- *
1056
- * @param string $file_path Path within wp-plugins/ to main plugin file.
1057
- * @param string $slug Plugin slug.
1058
- * @param bool $automatic Whether this is an automatic activation after an install. Defaults to false.
1059
- * This determines the styling of the output messages.
1060
- * @return bool False if an error was encountered, true otherwise.
1061
- */
1062
- protected function activate_single_plugin( $file_path, $slug, $automatic = false ) {
1063
- if ( $this->can_plugin_activate( $slug ) ) {
1064
- $activate = activate_plugin( $file_path );
1065
-
1066
- if ( is_wp_error( $activate ) ) {
1067
- echo '<div id="message" class="error"><p>', wp_kses_post( $activate->get_error_message() ), '</p></div>',
1068
- '<p><a href="', esc_url( $this->get_tgmpa_url() ), '" target="_parent">', esc_html( $this->strings['return'] ), '</a></p>';
1069
-
1070
- return false; // End it here if there is an error with activation.
1071
- } else {
1072
- if ( ! $automatic ) {
1073
- // Make sure message doesn't display again if bulk activation is performed
1074
- // immediately after a single activation.
1075
- if ( ! isset( $_POST['action'] ) ) { // WPCS: CSRF OK.
1076
- echo '<div id="message" class="updated"><p>', esc_html( $this->strings['activated_successfully'] ), ' <strong>', esc_html( $this->plugins[ $slug ]['name'] ), '.</strong></p></div>';
1077
- }
1078
- } else {
1079
- // Simpler message layout for use on the plugin install page.
1080
- echo '<p>', esc_html( $this->strings['plugin_activated'] ), '</p>';
1081
- }
1082
- }
1083
- } elseif ( $this->is_plugin_active( $slug ) ) {
1084
- // No simpler message format provided as this message should never be encountered
1085
- // on the plugin install page.
1086
- echo '<div id="message" class="error"><p>',
1087
- sprintf(
1088
- esc_html( $this->strings['plugin_already_active'] ),
1089
- '<strong>' . esc_html( $this->plugins[ $slug ]['name'] ) . '</strong>'
1090
- ),
1091
- '</p></div>';
1092
- } elseif ( $this->does_plugin_require_update( $slug ) ) {
1093
- if ( ! $automatic ) {
1094
- // Make sure message doesn't display again if bulk activation is performed
1095
- // immediately after a single activation.
1096
- if ( ! isset( $_POST['action'] ) ) { // WPCS: CSRF OK.
1097
- echo '<div id="message" class="error"><p>',
1098
- sprintf(
1099
- esc_html( $this->strings['plugin_needs_higher_version'] ),
1100
- '<strong>' . esc_html( $this->plugins[ $slug ]['name'] ) . '</strong>'
1101
- ),
1102
- '</p></div>';
1103
- }
1104
- } else {
1105
- // Simpler message layout for use on the plugin install page.
1106
- echo '<p>', sprintf( esc_html( $this->strings['plugin_needs_higher_version'] ), esc_html( $this->plugins[ $slug ]['name'] ) ), '</p>';
1107
- }
1108
- }
1109
-
1110
- return true;
1111
- }
1112
-
1113
- /**
1114
- * Echoes required plugin notice.
1115
- *
1116
- * Outputs a message telling users that a specific plugin is required for
1117
- * their theme. If appropriate, it includes a link to the form page where
1118
- * users can install and activate the plugin.
1119
- *
1120
- * Returns early if we're on the Install page.
1121
- *
1122
- * @since 1.0.0
1123
- *
1124
- * @global object $current_screen
1125
- *
1126
- * @return null Returns early if we're on the Install page.
1127
- */
1128
- public function notices() {
1129
- // Remove nag on the install page / Return early if the nag message has been dismissed or user < author.
1130
- if ( ( $this->is_tgmpa_page() || $this->is_core_update_page() ) || get_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice_' . $this->id, true ) || ! current_user_can( apply_filters( 'tgmpa_show_admin_notice_capability', 'publish_posts' ) ) ) {
1131
- return;
1132
- }
1133
-
1134
- // Store for the plugin slugs by message type.
1135
- $message = array();
1136
-
1137
- // Initialize counters used to determine plurality of action link texts.
1138
- $install_link_count = 0;
1139
- $update_link_count = 0;
1140
- $activate_link_count = 0;
1141
- $total_required_action_count = 0;
1142
-
1143
- foreach ( $this->plugins as $slug => $plugin ) {
1144
- if ( $this->is_plugin_active( $slug ) && false === $this->does_plugin_have_update( $slug ) ) {
1145
- continue;
1146
- }
1147
-
1148
- if ( ! $this->is_plugin_installed( $slug ) ) {
1149
- if ( current_user_can( 'install_plugins' ) ) {
1150
- $install_link_count++;
1151
-
1152
- if ( true === $plugin['required'] ) {
1153
- $message['notice_can_install_required'][] = $slug;
1154
- } else {
1155
- $message['notice_can_install_recommended'][] = $slug;
1156
- }
1157
- }
1158
- if ( true === $plugin['required'] ) {
1159
- $total_required_action_count++;
1160
- }
1161
- } else {
1162
- if ( ! $this->is_plugin_active( $slug ) && $this->can_plugin_activate( $slug ) ) {
1163
- if ( current_user_can( 'activate_plugins' ) ) {
1164
- $activate_link_count++;
1165
-
1166
- if ( true === $plugin['required'] ) {
1167
- $message['notice_can_activate_required'][] = $slug;
1168
- } else {
1169
- $message['notice_can_activate_recommended'][] = $slug;
1170
- }
1171
- }
1172
- if ( true === $plugin['required'] ) {
1173
- $total_required_action_count++;
1174
- }
1175
- }
1176
-
1177
- if ( $this->does_plugin_require_update( $slug ) || false !== $this->does_plugin_have_update( $slug ) ) {
1178
-
1179
- if ( current_user_can( 'update_plugins' ) ) {
1180
- $update_link_count++;
1181
-
1182
- if ( $this->does_plugin_require_update( $slug ) ) {
1183
- $message['notice_ask_to_update'][] = $slug;
1184
- } elseif ( false !== $this->does_plugin_have_update( $slug ) ) {
1185
- $message['notice_ask_to_update_maybe'][] = $slug;
1186
- }
1187
- }
1188
- if ( true === $plugin['required'] ) {
1189
- $total_required_action_count++;
1190
- }
1191
- }
1192
- }
1193
- }
1194
- unset( $slug, $plugin );
1195
-
1196
- // If we have notices to display, we move forward.
1197
- if ( ! empty( $message ) || $total_required_action_count > 0 ) {
1198
- krsort( $message ); // Sort messages.
1199
- $rendered = '';
1200
-
1201
- // As add_settings_error() wraps the final message in a <p> and as the final message can't be
1202
- // filtered, using <p>'s in our html would render invalid html output.
1203
- $line_template = '<span style="display: block; margin: 0.5em 0.5em 0 0; clear: both;">%s</span>' . "\n";
1204
-
1205
- if ( ! current_user_can( 'activate_plugins' ) && ! current_user_can( 'install_plugins' ) && ! current_user_can( 'update_plugins' ) ) {
1206
- $rendered = esc_html( $this->strings['notice_cannot_install_activate'] ) . ' ' . esc_html( $this->strings['contact_admin'] );
1207
- $rendered .= $this->create_user_action_links_for_notice( 0, 0, 0, $line_template );
1208
- } else {
1209
-
1210
- // If dismissable is false and a message is set, output it now.
1211
- if ( ! $this->dismissable && ! empty( $this->dismiss_msg ) ) {
1212
- $rendered .= sprintf( $line_template, wp_kses_post( $this->dismiss_msg ) );
1213
- }
1214
-
1215
- // Render the individual message lines for the notice.
1216
- foreach ( $message as $type => $plugin_group ) {
1217
- $linked_plugins = array();
1218
-
1219
- // Get the external info link for a plugin if one is available.
1220
- foreach ( $plugin_group as $plugin_slug ) {
1221
- $linked_plugins[] = $this->get_info_link( $plugin_slug );
1222
- }
1223
- unset( $plugin_slug );
1224
-
1225
- $count = count( $plugin_group );
1226
- $linked_plugins = array_map( array( 'TGMPA_Utils', 'wrap_in_em' ), $linked_plugins );
1227
- $last_plugin = array_pop( $linked_plugins ); // Pop off last name to prep for readability.
1228
- $imploded = empty( $linked_plugins ) ? $last_plugin : ( implode( ', ', $linked_plugins ) . ' ' . esc_html_x( 'and', 'plugin A *and* plugin B', 'tgmpa' ) . ' ' . $last_plugin );
1229
-
1230
- $rendered .= sprintf(
1231
- $line_template,
1232
- sprintf(
1233
- translate_nooped_plural( $this->strings[ $type ], $count, 'tgmpa' ),
1234
- $imploded,
1235
- $count
1236
- )
1237
- );
1238
-
1239
- }
1240
- unset( $type, $plugin_group, $linked_plugins, $count, $last_plugin, $imploded );
1241
-
1242
- $rendered .= $this->create_user_action_links_for_notice( $install_link_count, $update_link_count, $activate_link_count, $line_template );
1243
- }
1244
-
1245
- // Register the nag messages and prepare them to be processed.
1246
- add_settings_error( 'tgmpa', 'tgmpa', $rendered, $this->get_admin_notice_class() );
1247
- }
1248
-
1249
- // Admin options pages already output settings_errors, so this is to avoid duplication.
1250
- if ( 'options-general' !== $GLOBALS['current_screen']->parent_base ) {
1251
- $this->display_settings_errors();
1252
- }
1253
- }
1254
-
1255
- /**
1256
- * Generate the user action links for the admin notice.
1257
- *
1258
- * @since 2.6.0
1259
- *
1260
- * @param int $install_count Number of plugins to install.
1261
- * @param int $update_count Number of plugins to update.
1262
- * @param int $activate_count Number of plugins to activate.
1263
- * @param int $line_template Template for the HTML tag to output a line.
1264
- * @return string Action links.
1265
- */
1266
- protected function create_user_action_links_for_notice( $install_count, $update_count, $activate_count, $line_template ) {
1267
- // Setup action links.
1268
- $action_links = array(
1269
- 'install' => '',
1270
- 'update' => '',
1271
- 'activate' => '',
1272
- 'dismiss' => $this->dismissable ? '<a href="' . esc_url( wp_nonce_url( add_query_arg( 'tgmpa-dismiss', 'dismiss_admin_notices' ), 'tgmpa-dismiss-' . get_current_user_id() ) ) . '" class="dismiss-notice" target="_parent">' . esc_html( $this->strings['dismiss'] ) . '</a>' : '',
1273
- );
1274
-
1275
- $link_template = '<a href="%2$s">%1$s</a>';
1276
-
1277
- if ( current_user_can( 'install_plugins' ) ) {
1278
- if ( $install_count > 0 ) {
1279
- $action_links['install'] = sprintf(
1280
- $link_template,
1281
- translate_nooped_plural( $this->strings['install_link'], $install_count, 'tgmpa' ),
1282
- esc_url( $this->get_tgmpa_status_url( 'install' ) )
1283
- );
1284
- }
1285
- if ( $update_count > 0 ) {
1286
- $action_links['update'] = sprintf(
1287
- $link_template,
1288
- translate_nooped_plural( $this->strings['update_link'], $update_count, 'tgmpa' ),
1289
- esc_url( $this->get_tgmpa_status_url( 'update' ) )
1290
- );
1291
- }
1292
- }
1293
-
1294
- if ( current_user_can( 'activate_plugins' ) && $activate_count > 0 ) {
1295
- $action_links['activate'] = sprintf(
1296
- $link_template,
1297
- translate_nooped_plural( $this->strings['activate_link'], $activate_count, 'tgmpa' ),
1298
- esc_url( $this->get_tgmpa_status_url( 'activate' ) )
1299
- );
1300
- }
1301
-
1302
- $action_links = apply_filters( 'tgmpa_notice_action_links', $action_links );
1303
-
1304
- $action_links = array_filter( (array) $action_links ); // Remove any empty array items.
1305
-
1306
- if ( ! empty( $action_links ) ) {
1307
- $action_links = sprintf( $line_template, implode( ' | ', $action_links ) );
1308
- return apply_filters( 'tgmpa_notice_rendered_action_links', $action_links );
1309
- } else {
1310
- return '';
1311
- }
1312
- }
1313
-
1314
- /**
1315
- * Get admin notice class.
1316
- *
1317
- * Work around all the changes to the various admin notice classes between WP 4.4 and 3.7
1318
- * (lowest supported version by TGMPA).
1319
- *
1320
- * @since 2.6.0
1321
- *
1322
- * @return string
1323
- */
1324
- protected function get_admin_notice_class() {
1325
- if ( ! empty( $this->strings['nag_type'] ) ) {
1326
- return sanitize_html_class( strtolower( $this->strings['nag_type'] ) );
1327
- } else {
1328
- if ( version_compare( $this->wp_version, '4.2', '>=' ) ) {
1329
- return 'notice-warning';
1330
- } elseif ( version_compare( $this->wp_version, '4.1', '>=' ) ) {
1331
- return 'notice';
1332
- } else {
1333
- return 'updated';
1334
- }
1335
- }
1336
- }
1337
-
1338
- /**
1339
- * Display settings errors and remove those which have been displayed to avoid duplicate messages showing
1340
- *
1341
- * @since 2.5.0
1342
- */
1343
- protected function display_settings_errors() {
1344
- global $wp_settings_errors;
1345
-
1346
- settings_errors( 'tgmpa' );
1347
-
1348
- foreach ( (array) $wp_settings_errors as $key => $details ) {
1349
- if ( 'tgmpa' === $details['setting'] ) {
1350
- unset( $wp_settings_errors[ $key ] );
1351
- break;
1352
- }
1353
- }
1354
- }
1355
-
1356
- /**
1357
- * Register dismissal of admin notices.
1358
- *
1359
- * Acts on the dismiss link in the admin nag messages.
1360
- * If clicked, the admin notice disappears and will no longer be visible to this user.
1361
- *
1362
- * @since 2.1.0
1363
- */
1364
- public function dismiss() {
1365
- if ( isset( $_GET['tgmpa-dismiss'] ) && check_admin_referer( 'tgmpa-dismiss-' . get_current_user_id() ) ) {
1366
- update_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice_' . $this->id, 1 );
1367
- }
1368
- }
1369
-
1370
- /**
1371
- * Add individual plugin to our collection of plugins.
1372
- *
1373
- * If the required keys are not set or the plugin has already
1374
- * been registered, the plugin is not added.
1375
- *
1376
- * @since 2.0.0
1377
- *
1378
- * @param array|null $plugin Array of plugin arguments or null if invalid argument.
1379
- * @return null Return early if incorrect argument.
1380
- */
1381
- public function register( $plugin ) {
1382
- if ( empty( $plugin['slug'] ) || empty( $plugin['name'] ) ) {
1383
- return;
1384
- }
1385
-
1386
- if ( empty( $plugin['slug'] ) || ! is_string( $plugin['slug'] ) || isset( $this->plugins[ $plugin['slug'] ] ) ) {
1387
- return;
1388
- }
1389
-
1390
- $defaults = array(
1391
- 'name' => '', // String
1392
- 'slug' => '', // String
1393
- 'source' => 'repo', // String
1394
- 'required' => false, // Boolean
1395
- 'version' => '', // String
1396
- 'force_activation' => false, // Boolean
1397
- 'force_deactivation' => false, // Boolean
1398
- 'external_url' => '', // String
1399
- 'is_callable' => '', // String|Array.
1400
- );
1401
-
1402
- // Prepare the received data.
1403
- $plugin = wp_parse_args( $plugin, $defaults );
1404
-
1405
- // Standardize the received slug.
1406
- $plugin['slug'] = $this->sanitize_key( $plugin['slug'] );
1407
-
1408
- // Forgive users for using string versions of booleans or floats for version number.
1409
- $plugin['version'] = (string) $plugin['version'];
1410
- $plugin['source'] = empty( $plugin['source'] ) ? 'repo' : $plugin['source'];
1411
- $plugin['required'] = TGMPA_Utils::validate_bool( $plugin['required'] );
1412
- $plugin['force_activation'] = TGMPA_Utils::validate_bool( $plugin['force_activation'] );
1413
- $plugin['force_deactivation'] = TGMPA_Utils::validate_bool( $plugin['force_deactivation'] );
1414
-
1415
- // Enrich the received data.
1416
- $plugin['file_path'] = $this->_get_plugin_basename_from_slug( $plugin['slug'] );
1417
- $plugin['source_type'] = $this->get_plugin_source_type( $plugin['source'] );
1418
-
1419
- // Set the class properties.
1420
- $this->plugins[ $plugin['slug'] ] = $plugin;
1421
- $this->sort_order[ $plugin['slug'] ] = $plugin['name'];
1422
-
1423
- // Should we add the force activation hook ?
1424
- if ( true === $plugin['force_activation'] ) {
1425
- $this->has_forced_activation = true;
1426
- }
1427
-
1428
- // Should we add the force deactivation hook ?
1429
- if ( true === $plugin['force_deactivation'] ) {
1430
- $this->has_forced_deactivation = true;
1431
- }
1432
- }
1433
-
1434
- /**
1435
- * Determine what type of source the plugin comes from.
1436
- *
1437
- * @since 2.5.0
1438
- *
1439
- * @param string $source The source of the plugin as provided, either empty (= WP repo), a file path
1440
- * (= bundled) or an external URL.
1441
- * @return string 'repo', 'external', or 'bundled'
1442
- */
1443
- protected function get_plugin_source_type( $source ) {
1444
- if ( 'repo' === $source || preg_match( self::WP_REPO_REGEX, $source ) ) {
1445
- return 'repo';
1446
- } elseif ( preg_match( self::IS_URL_REGEX, $source ) ) {
1447
- return 'external';
1448
- } else {
1449
- return 'bundled';
1450
- }
1451
- }
1452
-
1453
- /**
1454
- * Sanitizes a string key.
1455
- *
1456
- * Near duplicate of WP Core `sanitize_key()`. The difference is that uppercase characters *are*
1457
- * allowed, so as not to break upgrade paths from non-standard bundled plugins using uppercase
1458
- * characters in the plugin directory path/slug. Silly them.
1459
- *
1460
- * @see https://developer.wordpress.org/reference/hooks/sanitize_key/
1461
- *
1462
- * @since 2.5.0
1463
- *
1464
- * @param string $key String key.
1465
- * @return string Sanitized key
1466
- */
1467
- public function sanitize_key( $key ) {
1468
- $raw_key = $key;
1469
- $key = preg_replace( '`[^A-Za-z0-9_-]`', '', $key );
1470
-
1471
- /**
1472
- * Filter a sanitized key string.
1473
- *
1474
- * @since 2.5.0
1475
- *
1476
- * @param string $key Sanitized key.
1477
- * @param string $raw_key The key prior to sanitization.
1478
- */
1479
- return apply_filters( 'tgmpa_sanitize_key', $key, $raw_key );
1480
- }
1481
-
1482
- /**
1483
- * Amend default configuration settings.
1484
- *
1485
- * @since 2.0.0
1486
- *
1487
- * @param array $config Array of config options to pass as class properties.
1488
- */
1489
- public function config( $config ) {
1490
- $keys = array(
1491
- 'id',
1492
- 'default_path',
1493
- 'has_notices',
1494
- 'dismissable',
1495
- 'dismiss_msg',
1496
- 'menu',
1497
- 'parent_slug',
1498
- 'capability',
1499
- 'is_automatic',
1500
- 'message',
1501
- 'strings',
1502
- );
1503
-
1504
- foreach ( $keys as $key ) {
1505
- if ( isset( $config[ $key ] ) ) {
1506
- if ( is_array( $config[ $key ] ) ) {
1507
- $this->$key = array_merge( $this->$key, $config[ $key ] );
1508
- } else {
1509
- $this->$key = $config[ $key ];
1510
- }
1511
- }
1512
- }
1513
- }
1514
-
1515
- /**
1516
- * Amend action link after plugin installation.
1517
- *
1518
- * @since 2.0.0
1519
- *
1520
- * @param array $install_actions Existing array of actions.
1521
- * @return false|array Amended array of actions.
1522
- */
1523
- public function actions( $install_actions ) {
1524
- // Remove action links on the TGMPA install page.
1525
- if ( $this->is_tgmpa_page() ) {
1526
- return false;
1527
- }
1528
-
1529
- return $install_actions;
1530
- }
1531
-
1532
- /**
1533
- * Flushes the plugins cache on theme switch to prevent stale entries
1534
- * from remaining in the plugin table.
1535
- *
1536
- * @since 2.4.0
1537
- *
1538
- * @param bool $clear_update_cache Optional. Whether to clear the Plugin updates cache.
1539
- * Parameter added in v2.5.0.
1540
- */
1541
- public function flush_plugins_cache( $clear_update_cache = true ) {
1542
- wp_clean_plugins_cache( $clear_update_cache );
1543
- }
1544
-
1545
- /**
1546
- * Set file_path key for each installed plugin.
1547
- *
1548
- * @since 2.1.0
1549
- *
1550
- * @param string $plugin_slug Optional. If set, only (re-)populates the file path for that specific plugin.
1551
- * Parameter added in v2.5.0.
1552
- */
1553
- public function populate_file_path( $plugin_slug = '' ) {
1554
- if ( ! empty( $plugin_slug ) && is_string( $plugin_slug ) && isset( $this->plugins[ $plugin_slug ] ) ) {
1555
- $this->plugins[ $plugin_slug ]['file_path'] = $this->_get_plugin_basename_from_slug( $plugin_slug );
1556
- } else {
1557
- // Add file_path key for all plugins.
1558
- foreach ( $this->plugins as $slug => $values ) {
1559
- $this->plugins[ $slug ]['file_path'] = $this->_get_plugin_basename_from_slug( $slug );
1560
- }
1561
- }
1562
- }
1563
-
1564
- /**
1565
- * Helper function to extract the file path of the plugin file from the
1566
- * plugin slug, if the plugin is installed.
1567
- *
1568
- * @since 2.0.0
1569
- *
1570
- * @param string $slug Plugin slug (typically folder name) as provided by the developer.
1571
- * @return string Either file path for plugin if installed, or just the plugin slug.
1572
- */
1573
- protected function _get_plugin_basename_from_slug( $slug ) {
1574
- $keys = array_keys( $this->get_plugins() );
1575
-
1576
- foreach ( $keys as $key ) {
1577
- if ( preg_match( '|^' . $slug . '/|', $key ) ) {
1578
- return $key;
1579
- }
1580
- }
1581
-
1582
- return $slug;
1583
- }
1584
-
1585
- /**
1586
- * Retrieve plugin data, given the plugin name.
1587
- *
1588
- * Loops through the registered plugins looking for $name. If it finds it,
1589
- * it returns the $data from that plugin. Otherwise, returns false.
1590
- *
1591
- * @since 2.1.0
1592
- *
1593
- * @param string $name Name of the plugin, as it was registered.
1594
- * @param string $data Optional. Array key of plugin data to return. Default is slug.
1595
- * @return string|boolean Plugin slug if found, false otherwise.
1596
- */
1597
- public function _get_plugin_data_from_name( $name, $data = 'slug' ) {
1598
- foreach ( $this->plugins as $values ) {
1599
- if ( $name === $values['name'] && isset( $values[ $data ] ) ) {
1600
- return $values[ $data ];
1601
- }
1602
- }
1603
-
1604
- return false;
1605
- }
1606
-
1607
- /**
1608
- * Retrieve the download URL for a package.
1609
- *
1610
- * @since 2.5.0
1611
- *
1612
- * @param string $slug Plugin slug.
1613
- * @return string Plugin download URL or path to local file or empty string if undetermined.
1614
- */
1615
- public function get_download_url( $slug ) {
1616
- $dl_source = '';
1617
-
1618
- switch ( $this->plugins[ $slug ]['source_type'] ) {
1619
- case 'repo':
1620
- return $this->get_wp_repo_download_url( $slug );
1621
- case 'external':
1622
- return $this->plugins[ $slug ]['source'];
1623
- case 'bundled':
1624
- return $this->default_path . $this->plugins[ $slug ]['source'];
1625
- }
1626
-
1627
- return $dl_source; // Should never happen.
1628
- }
1629
-
1630
- /**
1631
- * Retrieve the download URL for a WP repo package.
1632
- *
1633
- * @since 2.5.0
1634
- *
1635
- * @param string $slug Plugin slug.
1636
- * @return string Plugin download URL.
1637
- */
1638
- protected function get_wp_repo_download_url( $slug ) {
1639
- $source = '';
1640
- $api = $this->get_plugins_api( $slug );
1641
-
1642
- if ( false !== $api && isset( $api->download_link ) ) {
1643
- $source = $api->download_link;
1644
- }
1645
-
1646
- return $source;
1647
- }
1648
-
1649
- /**
1650
- * Try to grab information from WordPress API.
1651
- *
1652
- * @since 2.5.0
1653
- *
1654
- * @param string $slug Plugin slug.
1655
- * @return object Plugins_api response object on success, WP_Error on failure.
1656
- */
1657
- protected function get_plugins_api( $slug ) {
1658
- static $api = array(); // Cache received responses.
1659
-
1660
- if ( ! isset( $api[ $slug ] ) ) {
1661
- if ( ! function_exists( 'plugins_api' ) ) {
1662
- require_once ABSPATH . 'wp-admin/includes/plugin-install.php';
1663
- }
1664
-
1665
- $response = plugins_api(
1666
- 'plugin_information',
1667
- array(
1668
- 'slug' => $slug,
1669
- 'fields' => array( 'sections' => false ),
1670
- )
1671
- );
1672
-
1673
- $api[ $slug ] = false;
1674
-
1675
- if ( is_wp_error( $response ) ) {
1676
- wp_die( esc_html( $this->strings['oops'] ) );
1677
- } else {
1678
- $api[ $slug ] = $response;
1679
- }
1680
- }
1681
-
1682
- return $api[ $slug ];
1683
- }
1684
-
1685
- /**
1686
- * Retrieve a link to a plugin information page.
1687
- *
1688
- * @since 2.5.0
1689
- *
1690
- * @param string $slug Plugin slug.
1691
- * @return string Fully formed html link to a plugin information page if available
1692
- * or the plugin name if not.
1693
- */
1694
- public function get_info_link( $slug ) {
1695
- if ( ! empty( $this->plugins[ $slug ]['external_url'] ) && preg_match( self::IS_URL_REGEX, $this->plugins[ $slug ]['external_url'] ) ) {
1696
- $link = sprintf(
1697
- '<a href="%1$s" target="_blank">%2$s</a>',
1698
- esc_url( $this->plugins[ $slug ]['external_url'] ),
1699
- esc_html( $this->plugins[ $slug ]['name'] )
1700
- );
1701
- } elseif ( 'repo' === $this->plugins[ $slug ]['source_type'] ) {
1702
- $url = add_query_arg(
1703
- array(
1704
- 'tab' => 'plugin-information',
1705
- 'plugin' => urlencode( $slug ),
1706
- 'TB_iframe' => 'true',
1707
- 'width' => '640',
1708
- 'height' => '500',
1709
- ),
1710
- self_admin_url( 'plugin-install.php' )
1711
- );
1712
-
1713
- $link = sprintf(
1714
- '<a href="%1$s" class="thickbox">%2$s</a>',
1715
- esc_url( $url ),
1716
- esc_html( $this->plugins[ $slug ]['name'] )
1717
- );
1718
- } else {
1719
- $link = esc_html( $this->plugins[ $slug ]['name'] ); // No hyperlink.
1720
- }
1721
-
1722
- return $link;
1723
- }
1724
-
1725
- /**
1726
- * Determine if we're on the TGMPA Install page.
1727
- *
1728
- * @since 2.1.0
1729
- *
1730
- * @return boolean True when on the TGMPA page, false otherwise.
1731
- */
1732
- protected function is_tgmpa_page() {
1733
- return isset( $_GET['page'] ) && $this->menu === $_GET['page'];
1734
- }
1735
-
1736
- /**
1737
- * Determine if we're on a WP Core installation/upgrade page.
1738
- *
1739
- * @since 2.6.0
1740
- *
1741
- * @return boolean True when on a WP Core installation/upgrade page, false otherwise.
1742
- */
1743
- protected function is_core_update_page() {
1744
- // Current screen is not always available, most notably on the customizer screen.
1745
- if ( ! function_exists( 'get_current_screen' ) ) {
1746
- return false;
1747
- }
1748
-
1749
- $screen = get_current_screen();
1750
-
1751
- if ( 'update-core' === $screen->base ) {
1752
- // Core update screen.
1753
- return true;
1754
- } elseif ( 'plugins' === $screen->base && ! empty( $_POST['action'] ) ) { // WPCS: CSRF ok.
1755
- // Plugins bulk update screen.
1756
- return true;
1757
- } elseif ( 'update' === $screen->base && ! empty( $_POST['action'] ) ) { // WPCS: CSRF ok.
1758
- // Individual updates (ajax call).
1759
- return true;
1760
- }
1761
-
1762
- return false;
1763
- }
1764
-
1765
- /**
1766
- * Retrieve the URL to the TGMPA Install page.
1767
- *
1768
- * I.e. depending on the config settings passed something along the lines of:
1769
- * http://example.com/wp-admin/themes.php?page=tgmpa-install-plugins
1770
- *
1771
- * @since 2.5.0
1772
- *
1773
- * @return string Properly encoded URL (not escaped).
1774
- */
1775
- public function get_tgmpa_url() {
1776
- static $url;
1777
-
1778
- if ( ! isset( $url ) ) {
1779
- $parent = $this->parent_slug;
1780
- if ( false === strpos( $parent, '.php' ) ) {
1781
- $parent = 'admin.php';
1782
- }
1783
- $url = add_query_arg(
1784
- array(
1785
- 'page' => urlencode( $this->menu ),
1786
- ),
1787
- self_admin_url( $parent )
1788
- );
1789
- }
1790
-
1791
- return $url;
1792
- }
1793
-
1794
- /**
1795
- * Retrieve the URL to the TGMPA Install page for a specific plugin status (view).
1796
- *
1797
- * I.e. depending on the config settings passed something along the lines of:
1798
- * http://example.com/wp-admin/themes.php?page=tgmpa-install-plugins&plugin_status=install
1799
- *
1800
- * @since 2.5.0
1801
- *
1802
- * @param string $status Plugin status - either 'install', 'update' or 'activate'.
1803
- * @return string Properly encoded URL (not escaped).
1804
- */
1805
- public function get_tgmpa_status_url( $status ) {
1806
- return add_query_arg(
1807
- array(
1808
- 'plugin_status' => urlencode( $status ),
1809
- ),
1810
- $this->get_tgmpa_url()
1811
- );
1812
- }
1813
-
1814
- /**
1815
- * Determine whether there are open actions for plugins registered with TGMPA.
1816
- *
1817
- * @since 2.5.0
1818
- *
1819
- * @return bool True if complete, i.e. no outstanding actions. False otherwise.
1820
- */
1821
- public function is_tgmpa_complete() {
1822
- $complete = true;
1823
- foreach ( $this->plugins as $slug => $plugin ) {
1824
- if ( ! $this->is_plugin_active( $slug ) || false !== $this->does_plugin_have_update( $slug ) ) {
1825
- $complete = false;
1826
- break;
1827
- }
1828
- }
1829
-
1830
- return $complete;
1831
- }
1832
-
1833
- /**
1834
- * Check if a plugin is installed. Does not take must-use plugins into account.
1835
- *
1836
- * @since 2.5.0
1837
- *
1838
- * @param string $slug Plugin slug.
1839
- * @return bool True if installed, false otherwise.
1840
- */
1841
- public function is_plugin_installed( $slug ) {
1842
- $installed_plugins = $this->get_plugins(); // Retrieve a list of all installed plugins (WP cached).
1843
-
1844
- return ( ! empty( $installed_plugins[ $this->plugins[ $slug ]['file_path'] ] ) );
1845
- }
1846
-
1847
- /**
1848
- * Check if a plugin is active.
1849
- *
1850
- * @since 2.5.0
1851
- *
1852
- * @param string $slug Plugin slug.
1853
- * @return bool True if active, false otherwise.
1854
- */
1855
- public function is_plugin_active( $slug ) {
1856
- return ( ( ! empty( $this->plugins[ $slug ]['is_callable'] ) && is_callable( $this->plugins[ $slug ]['is_callable'] ) ) || is_plugin_active( $this->plugins[ $slug ]['file_path'] ) );
1857
- }
1858
-
1859
- /**
1860
- * Check if a plugin can be updated, i.e. if we have information on the minimum WP version required
1861
- * available, check whether the current install meets them.
1862
- *
1863
- * @since 2.5.0
1864
- *
1865
- * @param string $slug Plugin slug.
1866
- * @return bool True if OK to update, false otherwise.
1867
- */
1868
- public function can_plugin_update( $slug ) {
1869
- // We currently can't get reliable info on non-WP-repo plugins - issue #380.
1870
- if ( 'repo' !== $this->plugins[ $slug ]['source_type'] ) {
1871
- return true;
1872
- }
1873
-
1874
- $api = $this->get_plugins_api( $slug );
1875
-
1876
- if ( false !== $api && isset( $api->requires ) ) {
1877
- return version_compare( $this->wp_version, $api->requires, '>=' );
1878
- }
1879
-
1880
- // No usable info received from the plugins API, presume we can update.
1881
- return true;
1882
- }
1883
-
1884
- /**
1885
- * Check to see if the plugin is 'updatetable', i.e. installed, with an update available
1886
- * and no WP version requirements blocking it.
1887
- *
1888
- * @since 2.6.0
1889
- *
1890
- * @param string $slug Plugin slug.
1891
- * @return bool True if OK to proceed with update, false otherwise.
1892
- */
1893
- public function is_plugin_updatetable( $slug ) {
1894
- if ( ! $this->is_plugin_installed( $slug ) ) {
1895
- return false;
1896
- } else {
1897
- return ( false !== $this->does_plugin_have_update( $slug ) && $this->can_plugin_update( $slug ) );
1898
- }
1899
- }
1900
-
1901
- /**
1902
- * Check if a plugin can be activated, i.e. is not currently active and meets the minimum
1903
- * plugin version requirements set in TGMPA (if any).
1904
- *
1905
- * @since 2.5.0
1906
- *
1907
- * @param string $slug Plugin slug.
1908
- * @return bool True if OK to activate, false otherwise.
1909
- */
1910
- public function can_plugin_activate( $slug ) {
1911
- return ( ! $this->is_plugin_active( $slug ) && ! $this->does_plugin_require_update( $slug ) );
1912
- }
1913
-
1914
- /**
1915
- * Retrieve the version number of an installed plugin.
1916
- *
1917
- * @since 2.5.0
1918
- *
1919
- * @param string $slug Plugin slug.
1920
- * @return string Version number as string or an empty string if the plugin is not installed
1921
- * or version unknown (plugins which don't comply with the plugin header standard).
1922
- */
1923
- public function get_installed_version( $slug ) {
1924
- $installed_plugins = $this->get_plugins(); // Retrieve a list of all installed plugins (WP cached).
1925
-
1926
- if ( ! empty( $installed_plugins[ $this->plugins[ $slug ]['file_path'] ]['Version'] ) ) {
1927
- return $installed_plugins[ $this->plugins[ $slug ]['file_path'] ]['Version'];
1928
- }
1929
-
1930
- return '';
1931
- }
1932
-
1933
- /**
1934
- * Check whether a plugin complies with the minimum version requirements.
1935
- *
1936
- * @since 2.5.0
1937
- *
1938
- * @param string $slug Plugin slug.
1939
- * @return bool True when a plugin needs to be updated, otherwise false.
1940
- */
1941
- public function does_plugin_require_update( $slug ) {
1942
- $installed_version = $this->get_installed_version( $slug );
1943
- $minimum_version = $this->plugins[ $slug ]['version'];
1944
-
1945
- return version_compare( $minimum_version, $installed_version, '>' );
1946
- }
1947
-
1948
- /**
1949
- * Check whether there is an update available for a plugin.
1950
- *
1951
- * @since 2.5.0
1952
- *
1953
- * @param string $slug Plugin slug.
1954
- * @return false|string Version number string of the available update or false if no update available.
1955
- */
1956
- public function does_plugin_have_update( $slug ) {
1957
- // Presume bundled and external plugins will point to a package which meets the minimum required version.
1958
- if ( 'repo' !== $this->plugins[ $slug ]['source_type'] ) {
1959
- if ( $this->does_plugin_require_update( $slug ) ) {
1960
- return $this->plugins[ $slug ]['version'];
1961
- }
1962
-
1963
- return false;
1964
- }
1965
-
1966
- $repo_updates = get_site_transient( 'update_plugins' );
1967
-
1968
- if ( isset( $repo_updates->response[ $this->plugins[ $slug ]['file_path'] ]->new_version ) ) {
1969
- return $repo_updates->response[ $this->plugins[ $slug ]['file_path'] ]->new_version;
1970
- }
1971
-
1972
- return false;
1973
- }
1974
-
1975
- /**
1976
- * Retrieve potential upgrade notice for a plugin.
1977
- *
1978
- * @since 2.5.0
1979
- *
1980
- * @param string $slug Plugin slug.
1981
- * @return string The upgrade notice or an empty string if no message was available or provided.
1982
- */
1983
- public function get_upgrade_notice( $slug ) {
1984
- // We currently can't get reliable info on non-WP-repo plugins - issue #380.
1985
- if ( 'repo' !== $this->plugins[ $slug ]['source_type'] ) {
1986
- return '';
1987
- }
1988
-
1989
- $repo_updates = get_site_transient( 'update_plugins' );
1990
-
1991
- if ( ! empty( $repo_updates->response[ $this->plugins[ $slug ]['file_path'] ]->upgrade_notice ) ) {
1992
- return $repo_updates->response[ $this->plugins[ $slug ]['file_path'] ]->upgrade_notice;
1993
- }
1994
-
1995
- return '';
1996
- }
1997
-
1998
- /**
1999
- * Wrapper around the core WP get_plugins function, making sure it's actually available.
2000
- *
2001
- * @since 2.5.0
2002
- *
2003
- * @param string $plugin_folder Optional. Relative path to single plugin folder.
2004
- * @return array Array of installed plugins with plugin information.
2005
- */
2006
- public function get_plugins( $plugin_folder = '' ) {
2007
- if ( ! function_exists( 'get_plugins' ) ) {
2008
- require_once ABSPATH . 'wp-admin/includes/plugin.php';
2009
- }
2010
-
2011
- return get_plugins( $plugin_folder );
2012
- }
2013
-
2014
- /**
2015
- * Delete dismissable nag option when theme is switched.
2016
- *
2017
- * This ensures that the user(s) is/are again reminded via nag of required
2018
- * and/or recommended plugins if they re-activate the theme.
2019
- *
2020
- * @since 2.1.1
2021
- */
2022
- public function update_dismiss() {
2023
- delete_metadata( 'user', null, 'tgmpa_dismissed_notice_' . $this->id, null, true );
2024
- }
2025
-
2026
- /**
2027
- * Forces plugin activation if the parameter 'force_activation' is
2028
- * set to true.
2029
- *
2030
- * This allows theme authors to specify certain plugins that must be
2031
- * active at all times while using the current theme.
2032
- *
2033
- * Please take special care when using this parameter as it has the
2034
- * potential to be harmful if not used correctly. Setting this parameter
2035
- * to true will not allow the specified plugin to be deactivated unless
2036
- * the user switches themes.
2037
- *
2038
- * @since 2.2.0
2039
- */
2040
- public function force_activation() {
2041
- foreach ( $this->plugins as $slug => $plugin ) {
2042
- if ( true === $plugin['force_activation'] ) {
2043
- if ( ! $this->is_plugin_installed( $slug ) ) {
2044
- // Oops, plugin isn't there so iterate to next condition.
2045
- continue;
2046
- } elseif ( $this->can_plugin_activate( $slug ) ) {
2047
- // There we go, activate the plugin.
2048
- activate_plugin( $plugin['file_path'] );
2049
- }
2050
- }
2051
- }
2052
- }
2053
-
2054
- /**
2055
- * Forces plugin deactivation if the parameter 'force_deactivation'
2056
- * is set to true and adds the plugin to the 'recently active' plugins list.
2057
- *
2058
- * This allows theme authors to specify certain plugins that must be
2059
- * deactivated upon switching from the current theme to another.
2060
- *
2061
- * Please take special care when using this parameter as it has the
2062
- * potential to be harmful if not used correctly.
2063
- *
2064
- * @since 2.2.0
2065
- */
2066
- public function force_deactivation() {
2067
- $deactivated = array();
2068
-
2069
- foreach ( $this->plugins as $slug => $plugin ) {
2070
- /*
2071
- * Only proceed forward if the parameter is set to true and plugin is active
2072
- * as a 'normal' (not must-use) plugin.
2073
- */
2074
- if ( true === $plugin['force_deactivation'] && is_plugin_active( $plugin['file_path'] ) ) {
2075
- deactivate_plugins( $plugin['file_path'] );
2076
- $deactivated[ $plugin['file_path'] ] = time();
2077
- }
2078
- }
2079
-
2080
- if ( ! empty( $deactivated ) ) {
2081
- update_option( 'recently_activated', $deactivated + (array) get_option( 'recently_activated' ) );
2082
- }
2083
- }
2084
-
2085
- /**
2086
- * Echo the current TGMPA version number to the page.
2087
- *
2088
- * @since 2.5.0
2089
- */
2090
- public function show_tgmpa_version() {
2091
- echo '<p style="float: right; padding: 0em 1.5em 0.5em 0;"><strong><small>',
2092
- esc_html(
2093
- sprintf(
2094
- /* translators: %s: version number */
2095
- __( 'TGMPA v%s', 'tgmpa' ),
2096
- self::TGMPA_VERSION
2097
- )
2098
- ),
2099
- '</small></strong></p>';
2100
- }
2101
-
2102
- /**
2103
- * Returns the singleton instance of the class.
2104
- *
2105
- * @since 2.4.0
2106
- *
2107
- * @return \TGM_Plugin_Activation The TGM_Plugin_Activation object.
2108
- */
2109
- public static function get_instance() {
2110
- if ( ! isset( self::$instance ) && ! ( self::$instance instanceof self ) ) {
2111
- self::$instance = new self();
2112
- }
2113
-
2114
- return self::$instance;
2115
- }
2116
- }
2117
-
2118
- if ( ! function_exists( 'load_tgm_plugin_activation' ) ) {
2119
- /**
2120
- * Ensure only one instance of the class is ever invoked.
2121
- *
2122
- * @since 2.5.0
2123
- */
2124
- function load_tgm_plugin_activation() {
2125
- $GLOBALS['tgmpa'] = TGM_Plugin_Activation::get_instance();
2126
- }
2127
- }
2128
-
2129
- if ( did_action( 'plugins_loaded' ) ) {
2130
- load_tgm_plugin_activation();
2131
- } else {
2132
- add_action( 'plugins_loaded', 'load_tgm_plugin_activation' );
2133
- }
2134
  }
2135
 
2136
  if ( ! function_exists( 'tgmpa' ) ) {
2137
- /**
2138
- * Helper function to register a collection of required plugins.
2139
- *
2140
- * @since 2.0.0
2141
- * @api
2142
- *
2143
- * @param array $plugins An array of plugin arrays.
2144
- * @param array $config Optional. An array of configuration values.
2145
- */
2146
- function tgmpa( $plugins, $config = array() ) {
2147
- $instance = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
2148
-
2149
- foreach ( $plugins as $plugin ) {
2150
- call_user_func( array( $instance, 'register' ), $plugin );
2151
- }
2152
-
2153
- if ( ! empty( $config ) && is_array( $config ) ) {
2154
- // Send out notices for deprecated arguments passed.
2155
- if ( isset( $config['notices'] ) ) {
2156
- _deprecated_argument( __FUNCTION__, '2.2.0', 'The `notices` config parameter was renamed to `has_notices` in TGMPA 2.2.0. Please adjust your configuration.' );
2157
- if ( ! isset( $config['has_notices'] ) ) {
2158
- $config['has_notices'] = $config['notices'];
2159
- }
2160
- }
2161
-
2162
- if ( isset( $config['parent_menu_slug'] ) ) {
2163
- _deprecated_argument( __FUNCTION__, '2.4.0', 'The `parent_menu_slug` config parameter was removed in TGMPA 2.4.0. In TGMPA 2.5.0 an alternative was (re-)introduced. Please adjust your configuration. For more information visit the website: http://tgmpluginactivation.com/configuration/#h-configuration-options.' );
2164
- }
2165
- if ( isset( $config['parent_url_slug'] ) ) {
2166
- _deprecated_argument( __FUNCTION__, '2.4.0', 'The `parent_url_slug` config parameter was removed in TGMPA 2.4.0. In TGMPA 2.5.0 an alternative was (re-)introduced. Please adjust your configuration. For more information visit the website: http://tgmpluginactivation.com/configuration/#h-configuration-options.' );
2167
- }
2168
-
2169
- call_user_func( array( $instance, 'config' ), $config );
2170
- }
2171
- }
2172
  }
2173
 
2174
  /**
@@ -2178,980 +2158,980 @@ if ( ! function_exists( 'tgmpa' ) ) {
2178
  * @since 2.2.0
2179
  */
2180
  if ( ! class_exists( 'WP_List_Table' ) ) {
2181
- require_once ABSPATH . 'wp-admin/includes/class-wp-list-table.php';
2182
  }
2183
 
2184
  if ( ! class_exists( 'TGMPA_List_Table' ) ) {
2185
 
2186
- /**
2187
- * List table class for handling plugins.
2188
- *
2189
- * Extends the WP_List_Table class to provide a future-compatible
2190
- * way of listing out all required/recommended plugins.
2191
- *
2192
- * Gives users an interface similar to the Plugin Administration
2193
- * area with similar (albeit stripped down) capabilities.
2194
- *
2195
- * This class also allows for the bulk install of plugins.
2196
- *
2197
- * @since 2.2.0
2198
- *
2199
- * @package TGM-Plugin-Activation
2200
- * @author Thomas Griffin
2201
- * @author Gary Jones
2202
- */
2203
- class TGMPA_List_Table extends WP_List_Table {
2204
- /**
2205
- * TGMPA instance.
2206
- *
2207
- * @since 2.5.0
2208
- *
2209
- * @var object
2210
- */
2211
- protected $tgmpa;
2212
-
2213
- /**
2214
- * The currently chosen view.
2215
- *
2216
- * @since 2.5.0
2217
- *
2218
- * @var string One of: 'all', 'install', 'update', 'activate'
2219
- */
2220
- public $view_context = 'all';
2221
-
2222
- /**
2223
- * The plugin counts for the various views.
2224
- *
2225
- * @since 2.5.0
2226
- *
2227
- * @var array
2228
- */
2229
- protected $view_totals = array(
2230
- 'all' => 0,
2231
- 'install' => 0,
2232
- 'update' => 0,
2233
- 'activate' => 0,
2234
- );
2235
-
2236
- /**
2237
- * References parent constructor and sets defaults for class.
2238
- *
2239
- * @since 2.2.0
2240
- */
2241
- public function __construct() {
2242
- $this->tgmpa = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
2243
-
2244
- parent::__construct(
2245
- array(
2246
- 'singular' => 'plugin',
2247
- 'plural' => 'plugins',
2248
- 'ajax' => false,
2249
- )
2250
- );
2251
-
2252
- if ( isset( $_REQUEST['plugin_status'] ) && in_array( $_REQUEST['plugin_status'], array( 'install', 'update', 'activate' ), true ) ) {
2253
- $this->view_context = sanitize_key( $_REQUEST['plugin_status'] );
2254
- }
2255
-
2256
- add_filter( 'tgmpa_table_data_items', array( $this, 'sort_table_items' ) );
2257
- }
2258
-
2259
- /**
2260
- * Get a list of CSS classes for the <table> tag.
2261
- *
2262
- * Overruled to prevent the 'plural' argument from being added.
2263
- *
2264
- * @since 2.5.0
2265
- *
2266
- * @return array CSS classnames.
2267
- */
2268
- public function get_table_classes() {
2269
- return array( 'widefat', 'fixed' );
2270
- }
2271
-
2272
- /**
2273
- * Gathers and renames all of our plugin information to be used by WP_List_Table to create our table.
2274
- *
2275
- * @since 2.2.0
2276
- *
2277
- * @return array $table_data Information for use in table.
2278
- */
2279
- protected function _gather_plugin_data() {
2280
- // Load thickbox for plugin links.
2281
- $this->tgmpa->admin_init();
2282
- $this->tgmpa->thickbox();
2283
-
2284
- // Categorize the plugins which have open actions.
2285
- $plugins = $this->categorize_plugins_to_views();
2286
-
2287
- // Set the counts for the view links.
2288
- $this->set_view_totals( $plugins );
2289
-
2290
- // Prep variables for use and grab list of all installed plugins.
2291
- $table_data = array();
2292
- $i = 0;
2293
-
2294
- // Redirect to the 'all' view if no plugins were found for the selected view context.
2295
- if ( empty( $plugins[ $this->view_context ] ) ) {
2296
- $this->view_context = 'all';
2297
- }
2298
-
2299
- foreach ( $plugins[ $this->view_context ] as $slug => $plugin ) {
2300
- $table_data[ $i ]['sanitized_plugin'] = $plugin['name'];
2301
- $table_data[ $i ]['slug'] = $slug;
2302
- $table_data[ $i ]['plugin'] = '<strong>' . $this->tgmpa->get_info_link( $slug ) . '</strong>';
2303
- $table_data[ $i ]['source'] = $this->get_plugin_source_type_text( $plugin['source_type'] );
2304
- $table_data[ $i ]['type'] = $this->get_plugin_advise_type_text( $plugin['required'] );
2305
- $table_data[ $i ]['status'] = $this->get_plugin_status_text( $slug );
2306
- $table_data[ $i ]['installed_version'] = $this->tgmpa->get_installed_version( $slug );
2307
- $table_data[ $i ]['minimum_version'] = $plugin['version'];
2308
- $table_data[ $i ]['available_version'] = $this->tgmpa->does_plugin_have_update( $slug );
2309
-
2310
- // Prep the upgrade notice info.
2311
- $upgrade_notice = $this->tgmpa->get_upgrade_notice( $slug );
2312
- if ( ! empty( $upgrade_notice ) ) {
2313
- $table_data[ $i ]['upgrade_notice'] = $upgrade_notice;
2314
-
2315
- add_action( "tgmpa_after_plugin_row_{$slug}", array( $this, 'wp_plugin_update_row' ), 10, 2 );
2316
- }
2317
-
2318
- $table_data[ $i ] = apply_filters( 'tgmpa_table_data_item', $table_data[ $i ], $plugin );
2319
-
2320
- $i++;
2321
- }
2322
-
2323
- return $table_data;
2324
- }
2325
-
2326
- /**
2327
- * Categorize the plugins which have open actions into views for the TGMPA page.
2328
- *
2329
- * @since 2.5.0
2330
- */
2331
- protected function categorize_plugins_to_views() {
2332
- $plugins = array(
2333
- 'all' => array(), // Meaning: all plugins which still have open actions.
2334
- 'install' => array(),
2335
- 'update' => array(),
2336
- 'activate' => array(),
2337
- );
2338
-
2339
- foreach ( $this->tgmpa->plugins as $slug => $plugin ) {
2340
- if ( $this->tgmpa->is_plugin_active( $slug ) && false === $this->tgmpa->does_plugin_have_update( $slug ) ) {
2341
- // No need to display plugins if they are installed, up-to-date and active.
2342
- continue;
2343
- } else {
2344
- $plugins['all'][ $slug ] = $plugin;
2345
-
2346
- if ( ! $this->tgmpa->is_plugin_installed( $slug ) ) {
2347
- $plugins['install'][ $slug ] = $plugin;
2348
- } else {
2349
- if ( false !== $this->tgmpa->does_plugin_have_update( $slug ) ) {
2350
- $plugins['update'][ $slug ] = $plugin;
2351
- }
2352
-
2353
- if ( $this->tgmpa->can_plugin_activate( $slug ) ) {
2354
- $plugins['activate'][ $slug ] = $plugin;
2355
- }
2356
- }
2357
- }
2358
- }
2359
-
2360
- return $plugins;
2361
- }
2362
-
2363
- /**
2364
- * Set the counts for the view links.
2365
- *
2366
- * @since 2.5.0
2367
- *
2368
- * @param array $plugins Plugins order by view.
2369
- */
2370
- protected function set_view_totals( $plugins ) {
2371
- foreach ( $plugins as $type => $list ) {
2372
- $this->view_totals[ $type ] = count( $list );
2373
- }
2374
- }
2375
-
2376
- /**
2377
- * Get the plugin required/recommended text string.
2378
- *
2379
- * @since 2.5.0
2380
- *
2381
- * @param string $required Plugin required setting.
2382
- * @return string
2383
- */
2384
- protected function get_plugin_advise_type_text( $required ) {
2385
- if ( true === $required ) {
2386
- return esc_attr__( 'Required', 'tgmpa' );
2387
- }
2388
-
2389
- return esc_attr__( 'Recommended', 'tgmpa' );
2390
- }
2391
-
2392
- /**
2393
- * Get the plugin source type text string.
2394
- *
2395
- * @since 2.5.0
2396
- *
2397
- * @param string $type Plugin type.
2398
- * @return string
2399
- */
2400
- protected function get_plugin_source_type_text( $type ) {
2401
- $string = '';
2402
-
2403
- switch ( $type ) {
2404
- case 'repo':
2405
- $string = esc_attr__( 'WordPress Repository', 'tgmpa' );
2406
- break;
2407
- case 'external':
2408
- $string = esc_attr__( 'External Source', 'tgmpa' );
2409
- break;
2410
- case 'bundled':
2411
- $string = esc_attr__( 'Pre-Packaged', 'tgmpa' );
2412
- break;
2413
- }
2414
-
2415
- return $string;
2416
- }
2417
-
2418
- /**
2419
- * Determine the plugin status message.
2420
- *
2421
- * @since 2.5.0
2422
- *
2423
- * @param string $slug Plugin slug.
2424
- * @return string
2425
- */
2426
- protected function get_plugin_status_text( $slug ) {
2427
- if ( ! $this->tgmpa->is_plugin_installed( $slug ) ) {
2428
- return esc_attr__( 'Not Installed', 'tgmpa' );
2429
- }
2430
-
2431
- if ( ! $this->tgmpa->is_plugin_active( $slug ) ) {
2432
- $install_status = esc_attr__( 'Installed But Not Activated', 'tgmpa' );
2433
- } else {
2434
- $install_status = esc_attr__( 'Active', 'tgmpa' );
2435
- }
2436
-
2437
- $update_status = '';
2438
-
2439
- if ( $this->tgmpa->does_plugin_require_update( $slug ) && false === $this->tgmpa->does_plugin_have_update( $slug ) ) {
2440
- $update_status = esc_attr__( 'Required Update not Available', 'tgmpa' );
2441
-
2442
- } elseif ( $this->tgmpa->does_plugin_require_update( $slug ) ) {
2443
- $update_status = esc_attr__( 'Requires Update', 'tgmpa' );
2444
-
2445
- } elseif ( false !== $this->tgmpa->does_plugin_have_update( $slug ) ) {
2446
- $update_status = esc_attr__( 'Update recommended', 'tgmpa' );
2447
- }
2448
-
2449
- if ( '' === $update_status ) {
2450
- return $install_status;
2451
- }
2452
-
2453
- return sprintf(
2454
- /* translators: 1: install status, 2: update status */
2455
- _x( '%1$s, %2$s', 'Install/Update Status', 'tgmpa' ),
2456
- $install_status,
2457
- $update_status
2458
- );
2459
- }
2460
-
2461
- /**
2462
- * Sort plugins by Required/Recommended type and by alphabetical plugin name within each type.
2463
- *
2464
- * @since 2.5.0
2465
- *
2466
- * @param array $items Prepared table items.
2467
- * @return array Sorted table items.
2468
- */
2469
- public function sort_table_items( $items ) {
2470
- $type = array();
2471
- $name = array();
2472
-
2473
- foreach ( $items as $i => $plugin ) {
2474
- $type[ $i ] = $plugin['type']; // Required / recommended.
2475
- $name[ $i ] = $plugin['sanitized_plugin'];
2476
- }
2477
-
2478
- array_multisort( $type, SORT_DESC, $name, SORT_ASC, $items );
2479
-
2480
- return $items;
2481
- }
2482
-
2483
- /**
2484
- * Get an associative array ( id => link ) of the views available on this table.
2485
- *
2486
- * @since 2.5.0
2487
- *
2488
- * @return array
2489
- */
2490
- public function get_views() {
2491
- $status_links = array();
2492
-
2493
- foreach ( $this->view_totals as $type => $count ) {
2494
- if ( $count < 1 ) {
2495
- continue;
2496
- }
2497
-
2498
- switch ( $type ) {
2499
- case 'all':
2500
- /* translators: 1: number of plugins. */
2501
- $text = _nx( 'All <span class="count">(%s)</span>', 'All <span class="count">(%s)</span>', $count, 'plugins', 'tgmpa' );
2502
- break;
2503
- case 'install':
2504
- /* translators: 1: number of plugins. */
2505
- $text = _n( 'To Install <span class="count">(%s)</span>', 'To Install <span class="count">(%s)</span>', $count, 'tgmpa' );
2506
- break;
2507
- case 'update':
2508
- /* translators: 1: number of plugins. */
2509
- $text = _n( 'Update Available <span class="count">(%s)</span>', 'Update Available <span class="count">(%s)</span>', $count, 'tgmpa' );
2510
- break;
2511
- case 'activate':
2512
- /* translators: 1: number of plugins. */
2513
- $text = _n( 'To Activate <span class="count">(%s)</span>', 'To Activate <span class="count">(%s)</span>', $count, 'tgmpa' );
2514
- break;
2515
- default:
2516
- $text = '';
2517
- break;
2518
- }
2519
-
2520
- if ( ! empty( $text ) ) {
2521
-
2522
- $status_links[ $type ] = sprintf(
2523
- '<a href="%s"%s>%s</a>',
2524
- esc_url( $this->tgmpa->get_tgmpa_status_url( $type ) ),
2525
- ( $type === $this->view_context ) ? ' class="current"' : '',
2526
- sprintf( $text, number_format_i18n( $count ) )
2527
- );
2528
- }
2529
- }
2530
-
2531
- return $status_links;
2532
- }
2533
-
2534
- /**
2535
- * Create default columns to display important plugin information
2536
- * like type, action and status.
2537
- *
2538
- * @since 2.2.0
2539
- *
2540
- * @param array $item Array of item data.
2541
- * @param string $column_name The name of the column.
2542
- * @return string
2543
- */
2544
- public function column_default( $item, $column_name ) {
2545
- return $item[ $column_name ];
2546
- }
2547
-
2548
- /**
2549
- * Required for bulk installing.
2550
- *
2551
- * Adds a checkbox for each plugin.
2552
- *
2553
- * @since 2.2.0
2554
- *
2555
- * @param array $item Array of item data.
2556
- * @return string The input checkbox with all necessary info.
2557
- */
2558
- public function column_cb( $item ) {
2559
- return sprintf(
2560
- '<input type="checkbox" name="%1$s[]" value="%2$s" id="%3$s" />',
2561
- esc_attr( $this->_args['singular'] ),
2562
- esc_attr( $item['slug'] ),
2563
- esc_attr( $item['sanitized_plugin'] )
2564
- );
2565
- }
2566
-
2567
- /**
2568
- * Create default title column along with the action links.
2569
- *
2570
- * @since 2.2.0
2571
- *
2572
- * @param array $item Array of item data.
2573
- * @return string The plugin name and action links.
2574
- */
2575
- public function column_plugin( $item ) {
2576
- return sprintf(
2577
- '%1$s %2$s',
2578
- $item['plugin'],
2579
- $this->row_actions( $this->get_row_actions( $item ), true )
2580
- );
2581
- }
2582
-
2583
- /**
2584
- * Create version information column.
2585
- *
2586
- * @since 2.5.0
2587
- *
2588
- * @param array $item Array of item data.
2589
- * @return string HTML-formatted version information.
2590
- */
2591
- public function column_version( $item ) {
2592
- $output = array();
2593
-
2594
- if ( $this->tgmpa->is_plugin_installed( $item['slug'] ) ) {
2595
- $installed = ! empty( $item['installed_version'] ) ? $item['installed_version'] : _x( 'unknown', 'as in: "version nr unknown"', 'tgmpa' );
2596
-
2597
- $color = '';
2598
- if ( ! empty( $item['minimum_version'] ) && $this->tgmpa->does_plugin_require_update( $item['slug'] ) ) {
2599
- $color = ' color: #ff0000; font-weight: bold;';
2600
- }
2601
-
2602
- $output[] = sprintf(
2603
- '<p><span style="min-width: 32px; text-align: right; float: right;%1$s">%2$s</span>' . esc_attr__( 'Installed version:', 'tgmpa' ) . '</p>',
2604
- $color,
2605
- $installed
2606
- );
2607
- }
2608
-
2609
- if ( ! empty( $item['minimum_version'] ) ) {
2610
- $output[] = sprintf(
2611
- '<p><span style="min-width: 32px; text-align: right; float: right;">%1$s</span>' . esc_attr__( 'Minimum required version:', 'tgmpa' ) . '</p>',
2612
- $item['minimum_version']
2613
- );
2614
- }
2615
-
2616
- if ( ! empty( $item['available_version'] ) ) {
2617
- $color = '';
2618
- if ( ! empty( $item['minimum_version'] ) && version_compare( $item['available_version'], $item['minimum_version'], '>=' ) ) {
2619
- $color = ' color: #71C671; font-weight: bold;';
2620
- }
2621
-
2622
- $output[] = sprintf(
2623
- '<p><span style="min-width: 32px; text-align: right; float: right;%1$s">%2$s</span>' . esc_attr__( 'Available version:', 'tgmpa' ) . '</p>',
2624
- $color,
2625
- $item['available_version']
2626
- );
2627
- }
2628
-
2629
- if ( empty( $output ) ) {
2630
- return '&nbsp;'; // Let's not break the table layout.
2631
- } else {
2632
- return implode( "\n", $output );
2633
- }
2634
- }
2635
-
2636
- /**
2637
- * Sets default message within the plugins table if no plugins
2638
- * are left for interaction.
2639
- *
2640
- * Hides the menu item to prevent the user from clicking and
2641
- * getting a permissions error.
2642
- *
2643
- * @since 2.2.0
2644
- */
2645
- public function no_items() {
2646
- echo esc_html__( 'No plugins to install, update or activate.', 'tgmpa' ) . ' <a href="' . esc_url( self_admin_url() ) . '"> ' . esc_html__( 'Return to the Dashboard', 'tgmpa' ) . '</a>';
2647
- echo '<style type="text/css">#adminmenu .wp-submenu li.current { display: none !important; }</style>';
2648
- }
2649
-
2650
- /**
2651
- * Output all the column information within the table.
2652
- *
2653
- * @since 2.2.0
2654
- *
2655
- * @return array $columns The column names.
2656
- */
2657
- public function get_columns() {
2658
- $columns = array(
2659
- 'cb' => '<input type="checkbox" />',
2660
- 'plugin' => esc_attr__( 'Plugin', 'tgmpa' ),
2661
- 'source' => esc_attr__( 'Source', 'tgmpa' ),
2662
- 'type' => esc_attr__( 'Type', 'tgmpa' ),
2663
- );
2664
-
2665
- if ( 'all' === $this->view_context || 'update' === $this->view_context ) {
2666
- $columns['version'] = esc_attr__( 'Version', 'tgmpa' );
2667
- $columns['status'] = esc_attr__( 'Status', 'tgmpa' );
2668
- }
2669
-
2670
- return apply_filters( 'tgmpa_table_columns', $columns );
2671
- }
2672
-
2673
- /**
2674
- * Get name of default primary column
2675
- *
2676
- * @since 2.5.0 / WP 4.3+ compatibility
2677
- * @access protected
2678
- *
2679
- * @return string
2680
- */
2681
- protected function get_default_primary_column_name() {
2682
- return 'plugin';
2683
- }
2684
-
2685
- /**
2686
- * Get the name of the primary column.
2687
- *
2688
- * @since 2.5.0 / WP 4.3+ compatibility
2689
- * @access protected
2690
- *
2691
- * @return string The name of the primary column.
2692
- */
2693
- protected function get_primary_column_name() {
2694
- if ( method_exists( 'WP_List_Table', 'get_primary_column_name' ) ) {
2695
- return parent::get_primary_column_name();
2696
- } else {
2697
- return $this->get_default_primary_column_name();
2698
- }
2699
- }
2700
-
2701
- /**
2702
- * Get the actions which are relevant for a specific plugin row.
2703
- *
2704
- * @since 2.5.0
2705
- *
2706
- * @param array $item Array of item data.
2707
- * @return array Array with relevant action links.
2708
- */
2709
- protected function get_row_actions( $item ) {
2710
- $actions = array();
2711
- $action_links = array();
2712
-
2713
- // Display the 'Install' action link if the plugin is not yet available.
2714
- if ( ! $this->tgmpa->is_plugin_installed( $item['slug'] ) ) {
2715
- /* translators: %2$s: plugin name in screen reader markup */
2716
- $actions['install'] = esc_attr__( 'Install %2$s', 'tgmpa' );
2717
- } else {
2718
- // Display the 'Update' action link if an update is available and WP complies with plugin minimum.
2719
- if ( false !== $this->tgmpa->does_plugin_have_update( $item['slug'] ) && $this->tgmpa->can_plugin_update( $item['slug'] ) ) {
2720
- /* translators: %2$s: plugin name in screen reader markup */
2721
- $actions['update'] = esc_attr__( 'Update %2$s', 'tgmpa' );
2722
- }
2723
-
2724
- // Display the 'Activate' action link, but only if the plugin meets the minimum version.
2725
- if ( $this->tgmpa->can_plugin_activate( $item['slug'] ) ) {
2726
- /* translators: %2$s: plugin name in screen reader markup */
2727
- $actions['activate'] = esc_attr__( 'Activate %2$s', 'tgmpa' );
2728
- }
2729
- }
2730
-
2731
- // Create the actual links.
2732
- foreach ( $actions as $action => $text ) {
2733
- $nonce_url = wp_nonce_url(
2734
- add_query_arg(
2735
- array(
2736
- 'plugin' => urlencode( $item['slug'] ),
2737
- 'tgmpa-' . $action => $action . '-plugin',
2738
- ),
2739
- $this->tgmpa->get_tgmpa_url()
2740
- ),
2741
- 'tgmpa-' . $action,
2742
- 'tgmpa-nonce'
2743
- );
2744
-
2745
- $action_links[ $action ] = sprintf(
2746
- '<a href="%1$s">' . esc_html( $text ) . '</a>', // $text contains the second placeholder.
2747
- esc_url( $nonce_url ),
2748
- '<span class="screen-reader-text">' . esc_html( $item['sanitized_plugin'] ) . '</span>'
2749
- );
2750
- }
2751
-
2752
- $prefix = ( defined( 'WP_NETWORK_ADMIN' ) && WP_NETWORK_ADMIN ) ? 'network_admin_' : '';
2753
- return apply_filters( "tgmpa_{$prefix}plugin_action_links", array_filter( $action_links ), $item['slug'], $item, $this->view_context );
2754
- }
2755
-
2756
- /**
2757
- * Generates content for a single row of the table.
2758
- *
2759
- * @since 2.5.0
2760
- *
2761
- * @param object $item The current item.
2762
- */
2763
- public function single_row( $item ) {
2764
- parent::single_row( $item );
2765
-
2766
- /**
2767
- * Fires after each specific row in the TGMPA Plugins list table.
2768
- *
2769
- * The dynamic portion of the hook name, `$item['slug']`, refers to the slug
2770
- * for the plugin.
2771
- *
2772
- * @since 2.5.0
2773
- */
2774
- do_action( "tgmpa_after_plugin_row_{$item['slug']}", $item['slug'], $item, $this->view_context );
2775
- }
2776
-
2777
- /**
2778
- * Show the upgrade notice below a plugin row if there is one.
2779
- *
2780
- * @since 2.5.0
2781
- *
2782
- * @see /wp-admin/includes/update.php
2783
- *
2784
- * @param string $slug Plugin slug.
2785
- * @param array $item The information available in this table row.
2786
- * @return null Return early if upgrade notice is empty.
2787
- */
2788
- public function wp_plugin_update_row( $slug, $item ) {
2789
- if ( empty( $item['upgrade_notice'] ) ) {
2790
- return;
2791
- }
2792
-
2793
- echo '
2794
- <tr class="plugin-update-tr">
2795
- <td colspan="', absint( $this->get_column_count() ), '" class="plugin-update colspanchange">
2796
- <div class="update-message">',
2797
- esc_html__( 'Upgrade message from the plugin author:', 'tgmpa' ),
2798
- ' <strong>', wp_kses_data( $item['upgrade_notice'] ), '</strong>
2799
- </div>
2800
- </td>
2801
- </tr>';
2802
- }
2803
-
2804
- /**
2805
- * Extra controls to be displayed between bulk actions and pagination.
2806
- *
2807
- * @since 2.5.0
2808
- *
2809
- * @param string $which 'top' or 'bottom' table navigation.
2810
- */
2811
- public function extra_tablenav( $which ) {
2812
- if ( 'bottom' === $which ) {
2813
- $this->tgmpa->show_tgmpa_version();
2814
- }
2815
- }
2816
-
2817
- /**
2818
- * Defines the bulk actions for handling registered plugins.
2819
- *
2820
- * @since 2.2.0
2821
- *
2822
- * @return array $actions The bulk actions for the plugin install table.
2823
- */
2824
- public function get_bulk_actions() {
2825
-
2826
- $actions = array();
2827
-
2828
- if ( 'update' !== $this->view_context && 'activate' !== $this->view_context ) {
2829
- if ( current_user_can( 'install_plugins' ) ) {
2830
- $actions['tgmpa-bulk-install'] = esc_attr__( 'Install', 'tgmpa' );
2831
- }
2832
- }
2833
-
2834
- if ( 'install' !== $this->view_context ) {
2835
- if ( current_user_can( 'update_plugins' ) ) {
2836
- $actions['tgmpa-bulk-update'] = esc_attr__( 'Update', 'tgmpa' );
2837
- }
2838
- if ( current_user_can( 'activate_plugins' ) ) {
2839
- $actions['tgmpa-bulk-activate'] = esc_attr__( 'Activate', 'tgmpa' );
2840
- }
2841
- }
2842
-
2843
- return $actions;
2844
- }
2845
-
2846
- /**
2847
- * Processes bulk installation and activation actions.
2848
- *
2849
- * The bulk installation process looks for the $_POST information and passes that
2850
- * through if a user has to use WP_Filesystem to enter their credentials.
2851
- *
2852
- * @since 2.2.0
2853
- */
2854
- public function process_bulk_actions() {
2855
- // Bulk installation process.
2856
- if ( 'tgmpa-bulk-install' === $this->current_action() || 'tgmpa-bulk-update' === $this->current_action() ) {
2857
-
2858
- check_admin_referer( 'bulk-' . $this->_args['plural'] );
2859
-
2860
- $install_type = 'install';
2861
- if ( 'tgmpa-bulk-update' === $this->current_action() ) {
2862
- $install_type = 'update';
2863
- }
2864
-
2865
- $plugins_to_install = array();
2866
-
2867
- // Did user actually select any plugins to install/update ?
2868
- if ( empty( $_POST['plugin'] ) ) {
2869
- if ( 'install' === $install_type ) {
2870
- $message = esc_attr__( 'No plugins were selected to be installed. No action taken.', 'tgmpa' );
2871
- } else {
2872
- $message = esc_attr__( 'No plugins were selected to be updated. No action taken.', 'tgmpa' );
2873
- }
2874
-
2875
- echo '<div id="message" class="error"><p>', esc_html( $message ), '</p></div>';
2876
-
2877
- return false;
2878
- }
2879
-
2880
- if ( is_array( $_POST['plugin'] ) ) {
2881
- $plugins_to_install = (array) $_POST['plugin'];
2882
- } elseif ( is_string( $_POST['plugin'] ) ) {
2883
- // Received via Filesystem page - un-flatten array (WP bug #19643).
2884
- $plugins_to_install = explode( ',', $_POST['plugin'] );
2885
- }
2886
-
2887
- // Sanitize the received input.
2888
- $plugins_to_install = array_map( 'urldecode', $plugins_to_install );
2889
- $plugins_to_install = array_map( array( $this->tgmpa, 'sanitize_key' ), $plugins_to_install );
2890
-
2891
- // Validate the received input.
2892
- foreach ( $plugins_to_install as $key => $slug ) {
2893
- // Check if the plugin was registered with TGMPA and remove if not.
2894
- if ( ! isset( $this->tgmpa->plugins[ $slug ] ) ) {
2895
- unset( $plugins_to_install[ $key ] );
2896
- continue;
2897
- }
2898
-
2899
- // For install: make sure this is a plugin we *can* install and not one already installed.
2900
- if ( 'install' === $install_type && true === $this->tgmpa->is_plugin_installed( $slug ) ) {
2901
- unset( $plugins_to_install[ $key ] );
2902
- }
2903
-
2904
- // For updates: make sure this is a plugin we *can* update (update available and WP version ok).
2905
- if ( 'update' === $install_type && false === $this->tgmpa->is_plugin_updatetable( $slug ) ) {
2906
- unset( $plugins_to_install[ $key ] );
2907
- }
2908
- }
2909
-
2910
- // No need to proceed further if we have no plugins to handle.
2911
- if ( empty( $plugins_to_install ) ) {
2912
- if ( 'install' === $install_type ) {
2913
- $message = esc_attr__( 'No plugins are available to be installed at this time.', 'tgmpa' );
2914
- } else {
2915
- $message = esc_attr__( 'No plugins are available to be updated at this time.', 'tgmpa' );
2916
- }
2917
-
2918
- echo '<div id="message" class="error"><p>', esc_html( $message ), '</p></div>';
2919
-
2920
- return false;
2921
- }
2922
-
2923
- // Pass all necessary information if WP_Filesystem is needed.
2924
- $url = wp_nonce_url(
2925
- $this->tgmpa->get_tgmpa_url(),
2926
- 'bulk-' . $this->_args['plural']
2927
- );
2928
-
2929
- // Give validated data back to $_POST which is the only place the filesystem looks for extra fields.
2930
- $_POST['plugin'] = implode( ',', $plugins_to_install ); // Work around for WP bug #19643.
2931
-
2932
- $method = ''; // Leave blank so WP_Filesystem can populate it as necessary.
2933
- $fields = array_keys( $_POST ); // Extra fields to pass to WP_Filesystem.
2934
-
2935
- if ( false === ( $creds = request_filesystem_credentials( esc_url_raw( $url ), $method, false, false, $fields ) ) ) {
2936
- return true; // Stop the normal page form from displaying, credential request form will be shown.
2937
- }
2938
-
2939
- // Now we have some credentials, setup WP_Filesystem.
2940
- if ( ! WP_Filesystem( $creds ) ) {
2941
- // Our credentials were no good, ask the user for them again.
2942
- request_filesystem_credentials( esc_url_raw( $url ), $method, true, false, $fields );
2943
-
2944
- return true;
2945
- }
2946
-
2947
- /* If we arrive here, we have the filesystem */
2948
-
2949
- // Store all information in arrays since we are processing a bulk installation.
2950
- $names = array();
2951
- $sources = array(); // Needed for installs.
2952
- $file_paths = array(); // Needed for upgrades.
2953
- $to_inject = array(); // Information to inject into the update_plugins transient.
2954
-
2955
- // Prepare the data for validated plugins for the install/upgrade.
2956
- foreach ( $plugins_to_install as $slug ) {
2957
- $name = $this->tgmpa->plugins[ $slug ]['name'];
2958
- $source = $this->tgmpa->get_download_url( $slug );
2959
-
2960
- if ( ! empty( $name ) && ! empty( $source ) ) {
2961
- $names[] = $name;
2962
-
2963
- switch ( $install_type ) {
2964
-
2965
- case 'install':
2966
- $sources[] = $source;
2967
- break;
2968
-
2969
- case 'update':
2970
- $file_paths[] = $this->tgmpa->plugins[ $slug ]['file_path'];
2971
- $to_inject[ $slug ] = $this->tgmpa->plugins[ $slug ];
2972
- $to_inject[ $slug ]['source'] = $source;
2973
- break;
2974
- }
2975
- }
2976
- }
2977
- unset( $slug, $name, $source );
2978
-
2979
- // Create a new instance of TGMPA_Bulk_Installer.
2980
- $installer = new TGMPA_Bulk_Installer(
2981
- new TGMPA_Bulk_Installer_Skin(
2982
- array(
2983
- 'url' => esc_url_raw( $this->tgmpa->get_tgmpa_url() ),
2984
- 'nonce' => 'bulk-' . $this->_args['plural'],
2985
- 'names' => $names,
2986
- 'install_type' => $install_type,
2987
- )
2988
- )
2989
- );
2990
-
2991
- // Wrap the install process with the appropriate HTML.
2992
- echo '<div class="tgmpa">',
2993
- '<h2 style="font-size: 23px; font-weight: 400; line-height: 29px; margin: 0; padding: 9px 15px 4px 0;">', esc_html( get_admin_page_title() ), '</h2>
2994
- <div class="update-php" style="width: 100%; height: 98%; min-height: 850px; padding-top: 1px;">';
2995
-
2996
- // Process the bulk installation submissions.
2997
- add_filter( 'upgrader_source_selection', array( $this->tgmpa, 'maybe_adjust_source_dir' ), 1, 3 );
2998
-
2999
- if ( 'tgmpa-bulk-update' === $this->current_action() ) {
3000
- // Inject our info into the update transient.
3001
- $this->tgmpa->inject_update_info( $to_inject );
3002
-
3003
- $installer->bulk_upgrade( $file_paths );
3004
- } else {
3005
- $installer->bulk_install( $sources );
3006
- }
3007
-
3008
- remove_filter( 'upgrader_source_selection', array( $this->tgmpa, 'maybe_adjust_source_dir' ), 1 );
3009
-
3010
- echo '</div></div>';
3011
-
3012
- return true;
3013
- }
3014
-
3015
- // Bulk activation process.
3016
- if ( 'tgmpa-bulk-activate' === $this->current_action() ) {
3017
- check_admin_referer( 'bulk-' . $this->_args['plural'] );
3018
-
3019
- // Did user actually select any plugins to activate ?
3020
- if ( empty( $_POST['plugin'] ) ) {
3021
- echo '<div id="message" class="error"><p>', esc_html__( 'No plugins were selected to be activated. No action taken.', 'tgmpa' ), '</p></div>';
3022
-
3023
- return false;
3024
- }
3025
-
3026
- // Grab plugin data from $_POST.
3027
- $plugins = array();
3028
- if ( isset( $_POST['plugin'] ) ) {
3029
- $plugins = array_map( 'urldecode', (array) $_POST['plugin'] );
3030
- $plugins = array_map( array( $this->tgmpa, 'sanitize_key' ), $plugins );
3031
- }
3032
-
3033
- $plugins_to_activate = array();
3034
- $plugin_names = array();
3035
-
3036
- // Grab the file paths for the selected & inactive plugins from the registration array.
3037
- foreach ( $plugins as $slug ) {
3038
- if ( $this->tgmpa->can_plugin_activate( $slug ) ) {
3039
- $plugins_to_activate[] = $this->tgmpa->plugins[ $slug ]['file_path'];
3040
- $plugin_names[] = $this->tgmpa->plugins[ $slug ]['name'];
3041
- }
3042
- }
3043
- unset( $slug );
3044
-
3045
- // Return early if there are no plugins to activate.
3046
- if ( empty( $plugins_to_activate ) ) {
3047
- echo '<div id="message" class="error"><p>', esc_html__( 'No plugins are available to be activated at this time.', 'tgmpa' ), '</p></div>';
3048
-
3049
- return false;
3050
- }
3051
-
3052
- // Now we are good to go - let's start activating plugins.
3053
- $activate = activate_plugins( $plugins_to_activate );
3054
-
3055
- if ( is_wp_error( $activate ) ) {
3056
- echo '<div id="message" class="error"><p>', wp_kses_post( $activate->get_error_message() ), '</p></div>';
3057
- } else {
3058
- $count = count( $plugin_names ); // Count so we can use _n function.
3059
- $plugin_names = array_map( array( 'TGMPA_Utils', 'wrap_in_strong' ), $plugin_names );
3060
- $last_plugin = array_pop( $plugin_names ); // Pop off last name to prep for readability.
3061
- $imploded = empty( $plugin_names ) ? $last_plugin : ( implode( ', ', $plugin_names ) . ' ' . esc_html_x( 'and', 'plugin A *and* plugin B', 'tgmpa' ) . ' ' . $last_plugin );
3062
-
3063
- printf( // WPCS: xss ok.
3064
- '<div id="message" class="updated"><p>%1$s %2$s.</p></div>',
3065
- esc_html( _n( 'The following plugin was activated successfully:', 'The following plugins were activated successfully:', $count, 'tgmpa' ) ),
3066
- $imploded
3067
- );
3068
-
3069
- // Update recently activated plugins option.
3070
- $recent = (array) get_option( 'recently_activated' );
3071
- foreach ( $plugins_to_activate as $plugin => $time ) {
3072
- if ( isset( $recent[ $plugin ] ) ) {
3073
- unset( $recent[ $plugin ] );
3074
- }
3075
- }
3076
- update_option( 'recently_activated', $recent );
3077
- }
3078
-
3079
- unset( $_POST ); // Reset the $_POST variable in case user wants to perform one action after another.
3080
-
3081
- return true;
3082
- }
3083
-
3084
- return false;
3085
- }
3086
-
3087
- /**
3088
- * Prepares all of our information to be outputted into a usable table.
3089
- *
3090
- * @since 2.2.0
3091
- */
3092
- public function prepare_items() {
3093
- $columns = $this->get_columns(); // Get all necessary column information.
3094
- $hidden = array(); // No columns to hide, but we must set as an array.
3095
- $sortable = array(); // No reason to make sortable columns.
3096
- $primary = $this->get_primary_column_name(); // Column which has the row actions.
3097
- $this->_column_headers = array( $columns, $hidden, $sortable, $primary ); // Get all necessary column headers.
3098
-
3099
- // Process our bulk activations here.
3100
- if ( 'tgmpa-bulk-activate' === $this->current_action() ) {
3101
- $this->process_bulk_actions();
3102
- }
3103
-
3104
- // Store all of our plugin data into $items array so WP_List_Table can use it.
3105
- $this->items = apply_filters( 'tgmpa_table_data_items', $this->_gather_plugin_data() );
3106
- }
3107
-
3108
- /* *********** DEPRECATED METHODS *********** */
3109
-
3110
- /**
3111
- * Retrieve plugin data, given the plugin name.
3112
- *
3113
- * @since 2.2.0
3114
- * @deprecated 2.5.0 use {@see TGM_Plugin_Activation::_get_plugin_data_from_name()} instead.
3115
- * @see TGM_Plugin_Activation::_get_plugin_data_from_name()
3116
- *
3117
- * @param string $name Name of the plugin, as it was registered.
3118
- * @param string $data Optional. Array key of plugin data to return. Default is slug.
3119
- * @return string|boolean Plugin slug if found, false otherwise.
3120
- */
3121
- protected function _get_plugin_data_from_name( $name, $data = 'slug' ) {
3122
- _deprecated_function( __FUNCTION__, 'TGMPA 2.5.0', 'TGM_Plugin_Activation::_get_plugin_data_from_name()' );
3123
-
3124
- return $this->tgmpa->_get_plugin_data_from_name( $name, $data );
3125
- }
3126
- }
3127
  }
3128
 
3129
 
3130
  if ( ! class_exists( 'TGM_Bulk_Installer' ) ) {
3131
 
3132
- /**
3133
- * Hack: Prevent TGMPA v2.4.1- bulk installer class from being loaded if 2.4.1- is loaded after 2.5+.
3134
- *
3135
- * @since 2.5.2
3136
- *
3137
- * {@internal The TGMPA_Bulk_Installer class was originally called TGM_Bulk_Installer.
3138
- * For more information, see that class.}}
3139
- */
3140
- class TGM_Bulk_Installer {
3141
- }
3142
  }
3143
  if ( ! class_exists( 'TGM_Bulk_Installer_Skin' ) ) {
3144
 
3145
- /**
3146
- * Hack: Prevent TGMPA v2.4.1- bulk installer skin class from being loaded if 2.4.1- is loaded after 2.5+.
3147
- *
3148
- * @since 2.5.2
3149
- *
3150
- * {@internal The TGMPA_Bulk_Installer_Skin class was originally called TGM_Bulk_Installer_Skin.
3151
- * For more information, see that class.}}
3152
- */
3153
- class TGM_Bulk_Installer_Skin {
3154
- }
3155
  }
3156
 
3157
  /**
@@ -3166,712 +3146,708 @@ if ( ! class_exists( 'TGM_Bulk_Installer_Skin' ) ) {
3166
  */
3167
  add_action( 'admin_init', 'tgmpa_load_bulk_installer' );
3168
  if ( ! function_exists( 'tgmpa_load_bulk_installer' ) ) {
3169
- /**
3170
- * Load bulk installer
3171
- */
3172
- function tgmpa_load_bulk_installer() {
3173
- // Silently fail if 2.5+ is loaded *after* an older version.
3174
- if ( ! isset( $GLOBALS['tgmpa'] ) ) {
3175
- return;
3176
- }
3177
-
3178
- // Get TGMPA class instance.
3179
- $tgmpa_instance = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
3180
-
3181
- if ( isset( $_GET['page'] ) && $tgmpa_instance->menu === $_GET['page'] ) {
3182
- if ( ! class_exists( 'Plugin_Upgrader', false ) ) {
3183
- require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
3184
- }
3185
-
3186
- if ( ! class_exists( 'TGMPA_Bulk_Installer' ) ) {
3187
-
3188
- /**
3189
- * Installer class to handle bulk plugin installations.
3190
- *
3191
- * Extends WP_Upgrader and customizes to suit the installation of multiple
3192
- * plugins.
3193
- *
3194
- * @since 2.2.0
3195
- *
3196
- * {@internal Since 2.5.0 the class is an extension of Plugin_Upgrader rather than WP_Upgrader.}}
3197
- * {@internal Since 2.5.2 the class has been renamed from TGM_Bulk_Installer to TGMPA_Bulk_Installer.
3198
- * This was done to prevent backward compatibility issues with v2.3.6.}}
3199
- *
3200
- * @package TGM-Plugin-Activation
3201
- * @author Thomas Griffin
3202
- * @author Gary Jones
3203
- */
3204
- class TGMPA_Bulk_Installer extends Plugin_Upgrader {
3205
- /**
3206
- * Holds result of bulk plugin installation.
3207
- *
3208
- * @since 2.2.0
3209
- *
3210
- * @var string
3211
- */
3212
- public $result;
3213
-
3214
- /**
3215
- * Flag to check if bulk installation is occurring or not.
3216
- *
3217
- * @since 2.2.0
3218
- *
3219
- * @var boolean
3220
- */
3221
- public $bulk = false;
3222
-
3223
- /**
3224
- * TGMPA instance
3225
- *
3226
- * @since 2.5.0
3227
- *
3228
- * @var object
3229
- */
3230
- protected $tgmpa;
3231
-
3232
- /**
3233
- * Whether or not the destination directory needs to be cleared ( = on update).
3234
- *
3235
- * @since 2.5.0
3236
- *
3237
- * @var bool
3238
- */
3239
- protected $clear_destination = false;
3240
-
3241
- /**
3242
- * References parent constructor and sets defaults for class.
3243
- *
3244
- * @since 2.2.0
3245
- *
3246
- * @param \Bulk_Upgrader_Skin|null $skin Installer skin.
3247
- */
3248
- public function __construct( $skin = null ) {
3249
- // Get TGMPA class instance.
3250
- $this->tgmpa = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
3251
-
3252
- parent::__construct( $skin );
3253
-
3254
- if ( isset( $this->skin->options['install_type'] ) && 'update' === $this->skin->options['install_type'] ) {
3255
- $this->clear_destination = true;
3256
- }
3257
-
3258
- if ( $this->tgmpa->is_automatic ) {
3259
- $this->activate_strings();
3260
- }
3261
-
3262
- add_action( 'upgrader_process_complete', array( $this->tgmpa, 'populate_file_path' ) );
3263
- }
3264
-
3265
- /**
3266
- * Sets the correct activation strings for the installer skin to use.
3267
- *
3268
- * @since 2.2.0
3269
- */
3270
- public function activate_strings() {
3271
- $this->strings['activation_failed'] = esc_attr__( 'Plugin activation failed.', 'tgmpa' );
3272
- $this->strings['activation_success'] = esc_attr__( 'Plugin activated successfully.', 'tgmpa' );
3273
- }
3274
-
3275
- /**
3276
- * Performs the actual installation of each plugin.
3277
- *
3278
- * @since 2.2.0
3279
- *
3280
- * @see WP_Upgrader::run()
3281
- *
3282
- * @param array $options The installation config options.
3283
- * @return null|array Return early if error, array of installation data on success.
3284
- */
3285
- public function run( $options ) {
3286
- $result = parent::run( $options );
3287
-
3288
- // Reset the strings in case we changed one during automatic activation.
3289
- if ( $this->tgmpa->is_automatic ) {
3290
- if ( 'update' === $this->skin->options['install_type'] ) {
3291
- $this->upgrade_strings();
3292
- } else {
3293
- $this->install_strings();
3294
- }
3295
- }
3296
-
3297
- return $result;
3298
- }
3299
-
3300
- /**
3301
- * Processes the bulk installation of plugins.
3302
- *
3303
- * @since 2.2.0
3304
- *
3305
- * {@internal This is basically a near identical copy of the WP Core
3306
- * Plugin_Upgrader::bulk_upgrade() method, with minor adjustments to deal with
3307
- * new installs instead of upgrades.
3308
- * For ease of future synchronizations, the adjustments are clearly commented, but no other
3309
- * comments are added. Code style has been made to comply.}}
3310
- *
3311
- * @see Plugin_Upgrader::bulk_upgrade()
3312
- * @see https://core.trac.wordpress.org/browser/tags/4.2.1/src/wp-admin/includes/class-wp-upgrader.php#L838
3313
- * (@internal Last synced: Dec 31st 2015 against https://core.trac.wordpress.org/browser/trunk?rev=36134}}
3314
- *
3315
- * @param array $plugins The plugin sources needed for installation.
3316
- * @param array $args Arbitrary passed extra arguments.
3317
- * @return array|false Install confirmation messages on success, false on failure.
3318
- */
3319
- public function bulk_install( $plugins, $args = array() ) {
3320
- // [TGMPA + ] Hook auto-activation in.
3321
- add_filter( 'upgrader_post_install', array( $this, 'auto_activate' ), 10 );
3322
-
3323
- $defaults = array(
3324
- 'clear_update_cache' => true,
3325
- );
3326
- $parsed_args = wp_parse_args( $args, $defaults );
3327
-
3328
- $this->init();
3329
- $this->bulk = true;
3330
-
3331
- $this->install_strings(); // [TGMPA + ] adjusted.
3332
-
3333
- /* [TGMPA - ] $current = get_site_transient( 'update_plugins' ); */
3334
-
3335
- /* [TGMPA - ] add_filter('upgrader_clear_destination', array($this, 'delete_old_plugin'), 10, 4); */
3336
-
3337
- $this->skin->header();
3338
-
3339
- // Connect to the Filesystem first.
3340
- $res = $this->fs_connect( array( WP_CONTENT_DIR, WP_PLUGIN_DIR ) );
3341
- if ( ! $res ) {
3342
- $this->skin->footer();
3343
- return false;
3344
- }
3345
-
3346
- $this->skin->bulk_header();
3347
-
3348
- /*
3349
- * Only start maintenance mode if:
3350
- * - running Multisite and there are one or more plugins specified, OR
3351
- * - a plugin with an update available is currently active.
3352
- * @TODO: For multisite, maintenance mode should only kick in for individual sites if at all possible.
3353
- */
3354
- $maintenance = ( is_multisite() && ! empty( $plugins ) );
3355
-
3356
- /*
3357
- [TGMPA - ]
3358
- foreach ( $plugins as $plugin )
3359
- $maintenance = $maintenance || ( is_plugin_active( $plugin ) && isset( $current->response[ $plugin] ) );
3360
- */
3361
- if ( $maintenance ) {
3362
- $this->maintenance_mode( true );
3363
- }
3364
-
3365
- $results = array();
3366
-
3367
- $this->update_count = count( $plugins );
3368
- $this->update_current = 0;
3369
- foreach ( $plugins as $plugin ) {
3370
- $this->update_current++;
3371
-
3372
- /*
3373
- [TGMPA - ]
3374
- $this->skin->plugin_info = get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin, false, true);
3375
-
3376
- if ( !isset( $current->response[ $plugin ] ) ) {
3377
- $this->skin->set_result('up_to_date');
3378
- $this->skin->before();
3379
- $this->skin->feedback('up_to_date');
3380
- $this->skin->after();
3381
- $results[$plugin] = true;
3382
- continue;
3383
- }
3384
-
3385
- // Get the URL to the zip file.
3386
- $r = $current->response[ $plugin ];
3387
-
3388
- $this->skin->plugin_active = is_plugin_active($plugin);
3389
- */
3390
-
3391
- $result = $this->run(
3392
- array(
3393
- 'package' => $plugin, // [TGMPA + ] adjusted.
3394
- 'destination' => WP_PLUGIN_DIR,
3395
- 'clear_destination' => false, // [TGMPA + ] adjusted.
3396
- 'clear_working' => true,
3397
- 'is_multi' => true,
3398
- 'hook_extra' => array(
3399
- 'plugin' => $plugin,
3400
- ),
3401
- )
3402
- );
3403
-
3404
- $results[ $plugin ] = $this->result;
3405
-
3406
- // Prevent credentials auth screen from displaying multiple times.
3407
- if ( false === $result ) {
3408
- break;
3409
- }
3410
- } //end foreach $plugins
3411
-
3412
- $this->maintenance_mode( false );
3413
-
3414
- /**
3415
- * Fires when the bulk upgrader process is complete.
3416
- *
3417
- * @since WP 3.6.0 / TGMPA 2.5.0
3418
- *
3419
- * @param Plugin_Upgrader $this Plugin_Upgrader instance. In other contexts, $this, might
3420
- * be a Theme_Upgrader or Core_Upgrade instance.
3421
- * @param array $data {
3422
- * Array of bulk item update data.
3423
- *
3424
- * @type string $action Type of action. Default 'update'.
3425
- * @type string $type Type of update process. Accepts 'plugin', 'theme', or 'core'.
3426
- * @type bool $bulk Whether the update process is a bulk update. Default true.
3427
- * @type array $packages Array of plugin, theme, or core packages to update.
3428
- * }
3429
- */
3430
- do_action(
3431
- 'upgrader_process_complete',
3432
- $this,
3433
- array(
3434
- 'action' => 'install', // [TGMPA + ] adjusted.
3435
- 'type' => 'plugin',
3436
- 'bulk' => true,
3437
- 'plugins' => $plugins,
3438
- )
3439
- );
3440
-
3441
- $this->skin->bulk_footer();
3442
-
3443
- $this->skin->footer();
3444
-
3445
- // Cleanup our hooks, in case something else does a upgrade on this connection.
3446
- /* [TGMPA - ] remove_filter('upgrader_clear_destination', array($this, 'delete_old_plugin')); */
3447
-
3448
- // [TGMPA + ] Remove our auto-activation hook.
3449
- remove_filter( 'upgrader_post_install', array( $this, 'auto_activate' ), 10 );
3450
-
3451
- // Force refresh of plugin update information.
3452
- wp_clean_plugins_cache( $parsed_args['clear_update_cache'] );
3453
-
3454
- return $results;
3455
- }
3456
-
3457
- /**
3458
- * Handle a bulk upgrade request.
3459
- *
3460
- * @since 2.5.0
3461
- *
3462
- * @see Plugin_Upgrader::bulk_upgrade()
3463
- *
3464
- * @param array $plugins The local WP file_path's of the plugins which should be upgraded.
3465
- * @param array $args Arbitrary passed extra arguments.
3466
- * @return string|bool Install confirmation messages on success, false on failure.
3467
- */
3468
- public function bulk_upgrade( $plugins, $args = array() ) {
3469
-
3470
- add_filter( 'upgrader_post_install', array( $this, 'auto_activate' ), 10 );
3471
-
3472
- $result = parent::bulk_upgrade( $plugins, $args );
3473
-
3474
- remove_filter( 'upgrader_post_install', array( $this, 'auto_activate' ), 10 );
3475
-
3476
- return $result;
3477
- }
3478
-
3479
- /**
3480
- * Abuse a filter to auto-activate plugins after installation.
3481
- *
3482
- * Hooked into the 'upgrader_post_install' filter hook.
3483
- *
3484
- * @since 2.5.0
3485
- *
3486
- * @param bool $bool The value we need to give back (true).
3487
- * @return bool
3488
- */
3489
- public function auto_activate( $bool ) {
3490
- // Only process the activation of installed plugins if the automatic flag is set to true.
3491
- if ( $this->tgmpa->is_automatic ) {
3492
- // Flush plugins cache so the headers of the newly installed plugins will be read correctly.
3493
- wp_clean_plugins_cache();
3494
-
3495
- // Get the installed plugin file.
3496
- $plugin_info = $this->plugin_info();
3497
-
3498
- // Don't try to activate on upgrade of active plugin as WP will do this already.
3499
- if ( ! is_plugin_active( $plugin_info ) ) {
3500
- $activate = activate_plugin( $plugin_info );
3501
-
3502
- // Adjust the success string based on the activation result.
3503
- $this->strings['process_success'] = $this->strings['process_success'] . "<br />\n";
3504
-
3505
- if ( is_wp_error( $activate ) ) {
3506
- $this->skin->error( $activate );
3507
- $this->strings['process_success'] .= $this->strings['activation_failed'];
3508
- } else {
3509
- $this->strings['process_success'] .= $this->strings['activation_success'];
3510
- }
3511
- }
3512
- }
3513
-
3514
- return $bool;
3515
- }
3516
- }
3517
- }
3518
-
3519
- if ( ! class_exists( 'TGMPA_Bulk_Installer_Skin' ) ) {
3520
-
3521
- /**
3522
- * Installer skin to set strings for the bulk plugin installations..
3523
- *
3524
- * Extends Bulk_Upgrader_Skin and customizes to suit the installation of multiple
3525
- * plugins.
3526
- *
3527
- * @since 2.2.0
3528
- *
3529
- * {@internal Since 2.5.2 the class has been renamed from TGM_Bulk_Installer_Skin to
3530
- * TGMPA_Bulk_Installer_Skin.
3531
- * This was done to prevent backward compatibility issues with v2.3.6.}}
3532
- *
3533
- * @see https://core.trac.wordpress.org/browser/trunk/src/wp-admin/includes/class-wp-upgrader-skins.php
3534
- *
3535
- * @package TGM-Plugin-Activation
3536
- * @author Thomas Griffin
3537
- * @author Gary Jones
3538
- */
3539
- class TGMPA_Bulk_Installer_Skin extends Bulk_Upgrader_Skin {
3540
- /**
3541
- * Holds plugin info for each individual plugin installation.
3542
- *
3543
- * @since 2.2.0
3544
- *
3545
- * @var array
3546
- */
3547
- public $plugin_info = array();
3548
-
3549
- /**
3550
- * Holds names of plugins that are undergoing bulk installations.
3551
- *
3552
- * @since 2.2.0
3553
- *
3554
- * @var array
3555
- */
3556
- public $plugin_names = array();
3557
-
3558
- /**
3559
- * Integer to use for iteration through each plugin installation.
3560
- *
3561
- * @since 2.2.0
3562
- *
3563
- * @var integer
3564
- */
3565
- public $i = 0;
3566
-
3567
- /**
3568
- * TGMPA instance
3569
- *
3570
- * @since 2.5.0
3571
- *
3572
- * @var object
3573
- */
3574
- protected $tgmpa;
3575
-
3576
- /**
3577
- * Constructor. Parses default args with new ones and extracts them for use.
3578
- *
3579
- * @since 2.2.0
3580
- *
3581
- * @param array $args Arguments to pass for use within the class.
3582
- */
3583
- public function __construct( $args = array() ) {
3584
- // Get TGMPA class instance.
3585
- $this->tgmpa = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
3586
-
3587
- // Parse default and new args.
3588
- $defaults = array(
3589
- 'url' => '',
3590
- 'nonce' => '',
3591
- 'names' => array(),
3592
- 'install_type' => 'install',
3593
- );
3594
- $args = wp_parse_args( $args, $defaults );
3595
-
3596
- // Set plugin names to $this->plugin_names property.
3597
- $this->plugin_names = $args['names'];
3598
-
3599
- // Extract the new args.
3600
- parent::__construct( $args );
3601
- }
3602
-
3603
- /**
3604
- * Sets install skin strings for each individual plugin.
3605
- *
3606
- * Checks to see if the automatic activation flag is set and uses the
3607
- * the proper strings accordingly.
3608
- *
3609
- * @since 2.2.0
3610
- */
3611
- public function add_strings() {
3612
- if ( 'update' === $this->options['install_type'] ) {
3613
- parent::add_strings();
3614
- /* translators: 1: plugin name, 2: action number 3: total number of actions. */
3615
- $this->upgrader->strings['skin_before_update_header'] = esc_attr__( 'Updating Plugin %1$s (%2$d/%3$d)', 'tgmpa' );
3616
- } else {
3617
- /* translators: 1: plugin name, 2: error message. */
3618
- $this->upgrader->strings['skin_update_failed_error'] = esc_attr__( 'An error occurred while installing %1$s: <strong>%2$s</strong>.', 'tgmpa' );
3619
- /* translators: 1: plugin name. */
3620
- $this->upgrader->strings['skin_update_failed'] = esc_attr__( 'The installation of %1$s failed.', 'tgmpa' );
3621
-
3622
- if ( $this->tgmpa->is_automatic ) {
3623
- // Automatic activation strings.
3624
- $this->upgrader->strings['skin_upgrade_start'] = esc_attr__( 'The installation and activation process is starting. This process may take a while on some hosts, so please be patient.', 'tgmpa' );
3625
- /* translators: 1: plugin name. */
3626
- $this->upgrader->strings['skin_update_successful'] = esc_attr__( '%1$s installed and activated successfully.', 'tgmpa' ) . ' <a href="#" class="hide-if-no-js" onclick="%2$s"><span>' . esc_html__( 'Show Details', 'tgmpa' ) . '</span><span class="hidden">' . esc_html__( 'Hide Details', 'tgmpa' ) . '</span>.</a>';
3627
- $this->upgrader->strings['skin_upgrade_end'] = esc_attr__( 'All installations and activations have been completed.', 'tgmpa' );
3628
- /* translators: 1: plugin name, 2: action number 3: total number of actions. */
3629
- $this->upgrader->strings['skin_before_update_header'] = esc_attr__( 'Installing and Activating Plugin %1$s (%2$d/%3$d)', 'tgmpa' );
3630
- } else {
3631
- // Default installation strings.
3632
- $this->upgrader->strings['skin_upgrade_start'] = esc_attr__( 'The installation process is starting. This process may take a while on some hosts, so please be patient.', 'tgmpa' );
3633
- /* translators: 1: plugin name. */
3634
- $this->upgrader->strings['skin_update_successful'] = esc_html__( '%1$s installed successfully.', 'tgmpa' ) . ' <a href="#" class="hide-if-no-js" onclick="%2$s"><span>' . esc_html__( 'Show Details', 'tgmpa' ) . '</span><span class="hidden">' . esc_html__( 'Hide Details', 'tgmpa' ) . '</span>.</a>';
3635
- $this->upgrader->strings['skin_upgrade_end'] = esc_attr__( 'All installations have been completed.', 'tgmpa' );
3636
- /* translators: 1: plugin name, 2: action number 3: total number of actions. */
3637
- $this->upgrader->strings['skin_before_update_header'] = esc_attr__( 'Installing Plugin %1$s (%2$d/%3$d)', 'tgmpa' );
3638
- }
3639
- }
3640
- }
3641
-
3642
- /**
3643
- * Outputs the header strings and necessary JS before each plugin installation.
3644
- *
3645
- * @since 2.2.0
3646
- *
3647
- * @param string $title Unused in this implementation.
3648
- */
3649
- public function before( $title = '' ) {
3650
- if ( empty( $title ) ) {
3651
- $title = esc_html( $this->plugin_names[ $this->i ] );
3652
- }
3653
- parent::before( $title );
3654
- }
3655
-
3656
- /**
3657
- * Outputs the footer strings and necessary JS after each plugin installation.
3658
- *
3659
- * Checks for any errors and outputs them if they exist, else output
3660
- * success strings.
3661
- *
3662
- * @since 2.2.0
3663
- *
3664
- * @param string $title Unused in this implementation.
3665
- */
3666
- public function after( $title = '' ) {
3667
- if ( empty( $title ) ) {
3668
- $title = esc_html( $this->plugin_names[ $this->i ] );
3669
- }
3670
- parent::after( $title );
3671
-
3672
- $this->i++;
3673
- }
3674
-
3675
- /**
3676
- * Outputs links after bulk plugin installation is complete.
3677
- *
3678
- * @since 2.2.0
3679
- */
3680
- public function bulk_footer() {
3681
- // Serve up the string to say installations (and possibly activations) are complete.
3682
- parent::bulk_footer();
3683
-
3684
- // Flush plugins cache so we can make sure that the installed plugins list is always up to date.
3685
- wp_clean_plugins_cache();
3686
-
3687
- $this->tgmpa->show_tgmpa_version();
3688
-
3689
- // Display message based on if all plugins are now active or not.
3690
- $update_actions = array();
3691
-
3692
- if ( $this->tgmpa->is_tgmpa_complete() ) {
3693
- // All plugins are active, so we display the complete string and hide the menu to protect users.
3694
- echo '<style type="text/css">#adminmenu .wp-submenu li.current { display: none !important; }</style>';
3695
- $update_actions['dashboard'] = sprintf(
3696
- esc_html( $this->tgmpa->strings['complete'] ),
3697
- '<a href="' . esc_url( self_admin_url() ) . '">' . esc_html__( 'Return to the Dashboard', 'tgmpa' ) . '</a>'
3698
- );
3699
- } else {
3700
- $update_actions['tgmpa_page'] = '<a href="' . esc_url( $this->tgmpa->get_tgmpa_url() ) . '" target="_parent">' . esc_html( $this->tgmpa->strings['return'] ) . '</a>';
3701
- }
3702
-
3703
- /**
3704
- * Filter the list of action links available following bulk plugin installs/updates.
3705
- *
3706
- * @since 2.5.0
3707
- *
3708
- * @param array $update_actions Array of plugin action links.
3709
- * @param array $plugin_info Array of information for the last-handled plugin.
3710
- */
3711
- $update_actions = apply_filters( 'tgmpa_update_bulk_plugins_complete_actions', $update_actions, $this->plugin_info );
3712
-
3713
- if ( ! empty( $update_actions ) ) {
3714
- $this->feedback( implode( ' | ', (array) $update_actions ) );
3715
- }
3716
- }
3717
-
3718
- /* *********** DEPRECATED METHODS *********** */
3719
-
3720
- /**
3721
- * Flush header output buffer.
3722
- *
3723
- * @since 2.2.0
3724
- * @deprecated 2.5.0 use {@see Bulk_Upgrader_Skin::flush_output()} instead
3725
- * @see Bulk_Upgrader_Skin::flush_output()
3726
- */
3727
- public function before_flush_output() {
3728
- _deprecated_function( __FUNCTION__, 'TGMPA 2.5.0', 'Bulk_Upgrader_Skin::flush_output()' );
3729
- $this->flush_output();
3730
- }
3731
-
3732
- /**
3733
- * Flush footer output buffer and iterate $this->i to make sure the
3734
- * installation strings reference the correct plugin.
3735
- *
3736
- * @since 2.2.0
3737
- * @deprecated 2.5.0 use {@see Bulk_Upgrader_Skin::flush_output()} instead
3738
- * @see Bulk_Upgrader_Skin::flush_output()
3739
- */
3740
- public function after_flush_output() {
3741
- _deprecated_function( __FUNCTION__, 'TGMPA 2.5.0', 'Bulk_Upgrader_Skin::flush_output()' );
3742
- $this->flush_output();
3743
- $this->i++;
3744
- }
3745
- }
3746
- }
3747
- }
3748
- }
3749
  }
3750
 
3751
  if ( ! class_exists( 'TGMPA_Utils' ) ) {
3752
 
3753
- /**
3754
- * Generic utilities for TGMPA.
3755
- *
3756
- * All methods are static, poor-dev name-spacing class wrapper.
3757
- *
3758
- * Class was called TGM_Utils in 2.5.0 but renamed TGMPA_Utils in 2.5.1 as this was conflicting with Soliloquy.
3759
- *
3760
- * @since 2.5.0
3761
- *
3762
- * @package TGM-Plugin-Activation
3763
- * @author Juliette Reinders Folmer
3764
- */
3765
- class TGMPA_Utils {
3766
- /**
3767
- * Whether the PHP filter extension is enabled.
3768
- *
3769
- * @see http://php.net/book.filter
3770
- *
3771
- * @since 2.5.0
3772
- *
3773
- * @static
3774
- *
3775
- * @var bool $has_filters True is the extension is enabled.
3776
- */
3777
- public static $has_filters;
3778
-
3779
- /**
3780
- * Wrap an arbitrary string in <em> tags. Meant to be used in combination with array_map().
3781
- *
3782
- * @since 2.5.0
3783
- *
3784
- * @static
3785
- *
3786
- * @param string $string Text to be wrapped.
3787
- * @return string
3788
- */
3789
- public static function wrap_in_em( $string ) {
3790
- return '<em>' . wp_kses_post( $string ) . '</em>';
3791
- }
3792
-
3793
- /**
3794
- * Wrap an arbitrary string in <strong> tags. Meant to be used in combination with array_map().
3795
- *
3796
- * @since 2.5.0
3797
- *
3798
- * @static
3799
- *
3800
- * @param string $string Text to be wrapped.
3801
- * @return string
3802
- */
3803
- public static function wrap_in_strong( $string ) {
3804
- return '<strong>' . wp_kses_post( $string ) . '</strong>';
3805
- }
3806
-
3807
- /**
3808
- * Helper function: Validate a value as boolean
3809
- *
3810
- * @since 2.5.0
3811
- *
3812
- * @static
3813
- *
3814
- * @param mixed $value Arbitrary value.
3815
- * @return bool
3816
- */
3817
- public static function validate_bool( $value ) {
3818
- if ( ! isset( self::$has_filters ) ) {
3819
- self::$has_filters = extension_loaded( 'filter' );
3820
- }
3821
-
3822
- if ( self::$has_filters ) {
3823
- return filter_var( $value, FILTER_VALIDATE_BOOLEAN );
3824
- } else {
3825
- return self::emulate_filter_bool( $value );
3826
- }
3827
- }
3828
-
3829
- /**
3830
- * Helper function: Cast a value to bool
3831
- *
3832
- * @since 2.5.0
3833
- *
3834
- * @static
3835
- *
3836
- * @param mixed $value Value to cast.
3837
- * @return bool
3838
- */
3839
- protected static function emulate_filter_bool( $value ) {
3840
- // @codingStandardsIgnoreStart
3841
- static $true = array(
3842
- '1',
3843
- 'true', 'True', 'TRUE',
3844
- 'y', 'Y',
3845
- 'yes', 'Yes', 'YES',
3846
- 'on', 'On', 'ON',
3847
- );
3848
- static $false = array(
3849
- '0',
3850
- 'false', 'False', 'FALSE',
3851
- 'n', 'N',
3852
- 'no', 'No', 'NO',
3853
- 'off', 'Off', 'OFF',
3854
- );
3855
- // @codingStandardsIgnoreEnd
3856
-
3857
- if ( is_bool( $value ) ) {
3858
- return $value;
3859
- } elseif ( is_int( $value ) && ( 0 === $value || 1 === $value ) ) {
3860
- return (bool) $value;
3861
- } elseif ( ( is_float( $value ) && ! is_nan( $value ) ) && ( (float) 0 === $value || (float) 1 === $value ) ) {
3862
- return (bool) $value;
3863
- } elseif ( is_string( $value ) ) {
3864
- $value = trim( $value );
3865
- if ( in_array( $value, $true, true ) ) {
3866
- return true;
3867
- } elseif ( in_array( $value, $false, true ) ) {
3868
- return false;
3869
- } else {
3870
- return false;
3871
- }
3872
- }
3873
-
3874
- return false;
3875
- }
3876
- } // End of class TGMPA_Utils
3877
- } // End of class_exists wrapper
16
  */
17
 
18
  /*
19
+ Copyright 2011 Thomas Griffin (thomasgriffinmedia.com)
20
 
21
+ This program is free software; you can redistribute it and/or modify
22
+ it under the terms of the GNU General Public License, version 2, as
23
+ published by the Free Software Foundation.
24
 
25
+ This program is distributed in the hope that it will be useful,
26
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
27
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
28
+ GNU General Public License for more details.
29
 
30
+ You should have received a copy of the GNU General Public License
31
+ along with this program; if not, write to the Free Software
32
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
33
  */
34
 
35
  if ( ! class_exists( 'TGM_Plugin_Activation' ) ) {
36
 
37
+ /**
38
+ * Automatic plugin installation and activation library.
39
+ *
40
+ * Creates a way to automatically install and activate plugins from within themes.
41
+ * The plugins can be either bundled, downloaded from the WordPress
42
+ * Plugin Repository or downloaded from another external source.
43
+ *
44
+ * @since 1.0.0
45
+ *
46
+ * @package TGM-Plugin-Activation
47
+ * @author Thomas Griffin
48
+ * @author Gary Jones
49
+ */
50
+ class TGM_Plugin_Activation {
51
+ /**
52
+ * TGMPA version number.
53
+ *
54
+ * @since 2.5.0
55
+ *
56
+ * @const string Version number.
57
+ */
58
+ const TGMPA_VERSION = '2.6.1';
59
+
60
+ /**
61
+ * Regular expression to test if a URL is a WP plugin repo URL.
62
+ *
63
+ * @const string Regex.
64
+ *
65
+ * @since 2.5.0
66
+ */
67
+ const WP_REPO_REGEX = '|^http[s]?://wordpress\.org/(?:extend/)?plugins/|';
68
+
69
+ /**
70
+ * Arbitrary regular expression to test if a string starts with a URL.
71
+ *
72
+ * @const string Regex.
73
+ *
74
+ * @since 2.5.0
75
+ */
76
+ const IS_URL_REGEX = '|^http[s]?://|';
77
+
78
+ /**
79
+ * Holds a copy of itself, so it can be referenced by the class name.
80
+ *
81
+ * @since 1.0.0
82
+ *
83
+ * @var TGM_Plugin_Activation
84
+ */
85
+ public static $instance;
86
+
87
+ /**
88
+ * Holds arrays of plugin details.
89
+ *
90
+ * @since 1.0.0
91
+ * @since 2.5.0 the array has the plugin slug as an associative key.
92
+ *
93
+ * @var array
94
+ */
95
+ public $plugins = array();
96
+
97
+ /**
98
+ * Holds arrays of plugin names to use to sort the plugins array.
99
+ *
100
+ * @since 2.5.0
101
+ *
102
+ * @var array
103
+ */
104
+ protected $sort_order = array();
105
+
106
+ /**
107
+ * Whether any plugins have the 'force_activation' setting set to true.
108
+ *
109
+ * @since 2.5.0
110
+ *
111
+ * @var bool
112
+ */
113
+ protected $has_forced_activation = false;
114
+
115
+ /**
116
+ * Whether any plugins have the 'force_deactivation' setting set to true.
117
+ *
118
+ * @since 2.5.0
119
+ *
120
+ * @var bool
121
+ */
122
+ protected $has_forced_deactivation = false;
123
+
124
+ /**
125
+ * Name of the unique ID to hash notices.
126
+ *
127
+ * @since 2.4.0
128
+ *
129
+ * @var string
130
+ */
131
+ public $id = 'tgmpa';
132
+
133
+ /**
134
+ * Name of the query-string argument for the admin page.
135
+ *
136
+ * @since 1.0.0
137
+ *
138
+ * @var string
139
+ */
140
+ protected $menu = 'tgmpa-install-plugins';
141
+
142
+ /**
143
+ * Parent menu file slug.
144
+ *
145
+ * @since 2.5.0
146
+ *
147
+ * @var string
148
+ */
149
+ public $parent_slug = 'themes.php';
150
+
151
+ /**
152
+ * Capability needed to view the plugin installation menu item.
153
+ *
154
+ * @since 2.5.0
155
+ *
156
+ * @var string
157
+ */
158
+ public $capability = 'edit_theme_options';
159
+
160
+ /**
161
+ * Default absolute path to folder containing bundled plugin zip files.
162
+ *
163
+ * @since 2.0.0
164
+ *
165
+ * @var string Absolute path prefix to zip file location for bundled plugins. Default is empty string.
166
+ */
167
+ public $default_path = '';
168
+
169
+ /**
170
+ * Flag to show admin notices or not.
171
+ *
172
+ * @since 2.1.0
173
+ *
174
+ * @var boolean
175
+ */
176
+ public $has_notices = true;
177
+
178
+ /**
179
+ * Flag to determine if the user can dismiss the notice nag.
180
+ *
181
+ * @since 2.4.0
182
+ *
183
+ * @var boolean
184
+ */
185
+ public $dismissable = true;
186
+
187
+ /**
188
+ * Message to be output above nag notice if dismissable is false.
189
+ *
190
+ * @since 2.4.0
191
+ *
192
+ * @var string
193
+ */
194
+ public $dismiss_msg = '';
195
+
196
+ /**
197
+ * Flag to set automatic activation of plugins. Off by default.
198
+ *
199
+ * @since 2.2.0
200
+ *
201
+ * @var boolean
202
+ */
203
+ public $is_automatic = false;
204
+
205
+ /**
206
+ * Optional message to display before the plugins table.
207
+ *
208
+ * @since 2.2.0
209
+ *
210
+ * @var string Message filtered by wp_kses_post(). Default is empty string.
211
+ */
212
+ public $message = '';
213
+
214
+ /**
215
+ * Holds configurable array of strings.
216
+ *
217
+ * Default values are added in the constructor.
218
+ *
219
+ * @since 2.0.0
220
+ *
221
+ * @var array
222
+ */
223
+ public $strings = array();
224
+
225
+ /**
226
+ * Holds the version of WordPress.
227
+ *
228
+ * @since 2.4.0
229
+ *
230
+ * @var int
231
+ */
232
+ public $wp_version;
233
+
234
+ /**
235
+ * Holds the hook name for the admin page.
236
+ *
237
+ * @since 2.5.0
238
+ *
239
+ * @var string
240
+ */
241
+ public $page_hook;
242
+
243
+ /**
244
+ * Adds a reference of this object to $instance, populates default strings,
245
+ * does the tgmpa_init action hook, and hooks in the interactions to init.
246
+ *
247
+ * {@internal This method should be `protected`, but as too many TGMPA implementations
248
+ * haven't upgraded beyond v2.3.6 yet, this gives backward compatibility issues.
249
+ * Reverted back to public for the time being.}}
250
+ *
251
+ * @since 1.0.0
252
+ *
253
+ * @see TGM_Plugin_Activation::init()
254
+ */
255
+ public function __construct() {
256
+ // Set the current WordPress version.
257
+ $this->wp_version = $GLOBALS['wp_version'];
258
+
259
+ // Announce that the class is ready, and pass the object (for advanced use).
260
+ do_action_ref_array( 'tgmpa_init', array( $this ) );
261
+
262
+ /*
263
+ * Load our text domain and allow for overloading the fall-back file.
264
+ *
265
+ * {@internal IMPORTANT! If this code changes, review the regex in the custom TGMPA
266
+ * generator on the website.}}
267
+ */
268
+ add_action( 'init', array( $this, 'load_textdomain' ), 5 );
269
+ add_filter( 'load_textdomain_mofile', array( $this, 'overload_textdomain_mofile' ), 10, 2 );
270
+
271
+ // When the rest of WP has loaded, kick-start the rest of the class.
272
+ add_action( 'init', array( $this, 'init' ) );
273
+ }
274
+
275
+ /**
276
+ * Magic method to (not) set protected properties from outside of this class.
277
+ *
278
+ * {@internal hackedihack... There is a serious bug in v2.3.2 - 2.3.6 where the `menu` property
279
+ * is being assigned rather than tested in a conditional, effectively rendering it useless.
280
+ * This 'hack' prevents this from happening.}}
281
+ *
282
+ * @see https://github.com/TGMPA/TGM-Plugin-Activation/blob/2.3.6/tgm-plugin-activation/class-tgm-plugin-activation.php#L1593
283
+ *
284
+ * @since 2.5.2
285
+ *
286
+ * @param string $name Name of an inaccessible property.
287
+ * @param mixed $value Value to assign to the property.
288
+ * @return void Silently fail to set the property when this is tried from outside of this class context.
289
+ * (Inside this class context, the __set() method if not used as there is direct access.)
290
+ */
291
+ public function __set( $name, $value ) {
292
+ return;
293
+ }
294
+
295
+ /**
296
+ * Magic method to get the value of a protected property outside of this class context.
297
+ *
298
+ * @since 2.5.2
299
+ *
300
+ * @param string $name Name of an inaccessible property.
301
+ * @return mixed The property value.
302
+ */
303
+ public function __get( $name ) {
304
+ return $this->{$name};
305
+ }
306
+
307
+ /**
308
+ * Initialise the interactions between this class and WordPress.
309
+ *
310
+ * Hooks in three new methods for the class: admin_menu, notices and styles.
311
+ *
312
+ * @since 2.0.0
313
+ *
314
+ * @see TGM_Plugin_Activation::admin_menu()
315
+ * @see TGM_Plugin_Activation::notices()
316
+ * @see TGM_Plugin_Activation::styles()
317
+ */
318
+ public function init() {
319
+ /**
320
+ * By default TGMPA only loads on the WP back-end and not in an Ajax call. Using this filter
321
+ * you can overrule that behaviour.
322
+ *
323
+ * @since 2.5.0
324
+ *
325
+ * @param bool $load Whether or not TGMPA should load.
326
+ * Defaults to the return of `is_admin() && ! defined( 'DOING_AJAX' )`.
327
+ */
328
+ if ( true !== apply_filters( 'tgmpa_load', ( is_admin() && ! defined( 'DOING_AJAX' ) ) ) ) {
329
+ return;
330
+ }
331
+
332
+ // Load class strings.
333
+ $this->strings = array(
334
+ 'page_title' => __( 'Install Required Plugins', 'tgmpa' ),
335
+ 'menu_title' => __( 'Install Plugins', 'tgmpa' ),
336
+ /* translators: %s: plugin name. */
337
+ 'installing' => __( 'Installing Plugin: %s', 'tgmpa' ),
338
+ /* translators: %s: plugin name. */
339
+ 'updating' => __( 'Updating Plugin: %s', 'tgmpa' ),
340
+ 'oops' => __( 'Something went wrong with the plugin API.', 'tgmpa' ),
341
+ 'notice_can_install_required' => _n_noop(
342
+ /* translators: 1: plugin name(s). */
343
+ 'This theme requires the following plugin: %1$s.',
344
+ 'This theme requires the following plugins: %1$s.',
345
+ 'tgmpa'
346
+ ),
347
+ 'notice_can_install_recommended' => _n_noop(
348
+ /* translators: 1: plugin name(s). */
349
+ 'This theme recommends the following plugin: %1$s.',
350
+ 'This theme recommends the following plugins: %1$s.',
351
+ 'tgmpa'
352
+ ),
353
+ 'notice_ask_to_update' => _n_noop(
354
+ /* translators: 1: plugin name(s). */
355
+ 'The following plugin needs to be updated to its latest version to ensure maximum compatibility with this theme: %1$s.',
356
+ 'The following plugins need to be updated to their latest version to ensure maximum compatibility with this theme: %1$s.',
357
+ 'tgmpa'
358
+ ),
359
+ 'notice_ask_to_update_maybe' => _n_noop(
360
+ /* translators: 1: plugin name(s). */
361
+ 'There is an update available for: %1$s.',
362
+ 'There are updates available for the following plugins: %1$s.',
363
+ 'tgmpa'
364
+ ),
365
+ 'notice_can_activate_required' => _n_noop(
366
+ /* translators: 1: plugin name(s). */
367
+ 'The following required plugin is currently inactive: %1$s.',
368
+ 'The following required plugins are currently inactive: %1$s.',
369
+ 'tgmpa'
370
+ ),
371
+ 'notice_can_activate_recommended' => _n_noop(
372
+ /* translators: 1: plugin name(s). */
373
+ 'The following recommended plugin is currently inactive: %1$s.',
374
+ 'The following recommended plugins are currently inactive: %1$s.',
375
+ 'tgmpa'
376
+ ),
377
+ 'install_link' => _n_noop(
378
+ 'Begin installing plugin',
379
+ 'Begin installing plugins',
380
+ 'tgmpa'
381
+ ),
382
+ 'update_link' => _n_noop(
383
+ 'Begin updating plugin',
384
+ 'Begin updating plugins',
385
+ 'tgmpa'
386
+ ),
387
+ 'activate_link' => _n_noop(
388
+ 'Begin activating plugin',
389
+ 'Begin activating plugins',
390
+ 'tgmpa'
391
+ ),
392
+ 'return' => __( 'Return to Required Plugins Installer', 'tgmpa' ),
393
+ 'dashboard' => __( 'Return to the Dashboard', 'tgmpa' ),
394
+ 'plugin_activated' => __( 'Plugin activated successfully.', 'tgmpa' ),
395
+ 'activated_successfully' => __( 'The following plugin was activated successfully:', 'tgmpa' ),
396
+ /* translators: 1: plugin name. */
397
+ 'plugin_already_active' => __( 'No action taken. Plugin %1$s was already active.', 'tgmpa' ),
398
+ /* translators: 1: plugin name. */
399
+ 'plugin_needs_higher_version' => __( 'Plugin not activated. A higher version of %s is needed for this theme. Please update the plugin.', 'tgmpa' ),
400
+ /* translators: 1: dashboard link. */
401
+ 'complete' => __( 'All plugins installed and activated successfully. %1$s', 'tgmpa' ),
402
+ 'dismiss' => __( 'Dismiss this notice', 'tgmpa' ),
403
+ 'notice_cannot_install_activate' => __( 'There are one or more required or recommended plugins to install, update or activate.', 'tgmpa' ),
404
+ 'contact_admin' => __( 'Please contact the administrator of this site for help.', 'tgmpa' ),
405
+ );
406
+
407
+ do_action( 'tgmpa_register' );
408
+
409
+ /* After this point, the plugins should be registered and the configuration set. */
410
+
411
+ // Proceed only if we have plugins to handle.
412
+ if ( empty( $this->plugins ) || ! is_array( $this->plugins ) ) {
413
+ return;
414
+ }
415
+
416
+ // Set up the menu and notices if we still have outstanding actions.
417
+ if ( true !== $this->is_tgmpa_complete() ) {
418
+ // Sort the plugins.
419
+ array_multisort( $this->sort_order, SORT_ASC, $this->plugins );
420
+
421
+ add_action( 'admin_menu', array( $this, 'admin_menu' ) );
422
+ add_action( 'admin_head', array( $this, 'dismiss' ) );
423
+
424
+ // Prevent the normal links from showing underneath a single install/update page.
425
+ add_filter( 'install_plugin_complete_actions', array( $this, 'actions' ) );
426
+ add_filter( 'update_plugin_complete_actions', array( $this, 'actions' ) );
427
+
428
+ if ( $this->has_notices ) {
429
+ add_action( 'admin_notices', array( $this, 'notices' ) );
430
+ add_action( 'admin_init', array( $this, 'admin_init' ), 1 );
431
+ add_action( 'admin_enqueue_scripts', array( $this, 'thickbox' ) );
432
+ }
433
+ }
434
+
435
+ // If needed, filter plugin action links.
436
+ add_action( 'load-plugins.php', array( $this, 'add_plugin_action_link_filters' ), 1 );
437
+
438
+ // Make sure things get reset on switch theme.
439
+ add_action( 'switch_theme', array( $this, 'flush_plugins_cache' ) );
440
+
441
+ if ( $this->has_notices ) {
442
+ add_action( 'switch_theme', array( $this, 'update_dismiss' ) );
443
+ }
444
+
445
+ // Setup the force activation hook.
446
+ if ( true === $this->has_forced_activation ) {
447
+ add_action( 'admin_init', array( $this, 'force_activation' ) );
448
+ }
449
+
450
+ // Setup the force deactivation hook.
451
+ if ( true === $this->has_forced_deactivation ) {
452
+ add_action( 'switch_theme', array( $this, 'force_deactivation' ) );
453
+ }
454
+ }
455
+
456
+ /**
457
+ * Load translations.
458
+ *
459
+ * @since 2.6.0
460
+ *
461
+ * (@internal Uses `load_theme_textdomain()` rather than `load_plugin_textdomain()` to
462
+ * get round the different ways of handling the path and deprecated notices being thrown
463
+ * and such. For plugins, the actual file name will be corrected by a filter.}}
464
+ *
465
+ * {@internal IMPORTANT! If this function changes, review the regex in the custom TGMPA
466
+ * generator on the website.}}
467
+ */
468
+ public function load_textdomain() {
469
+ if ( is_textdomain_loaded( 'tgmpa' ) ) {
470
+ return;
471
+ }
472
+
473
+ if ( false !== strpos( __FILE__, WP_PLUGIN_DIR ) || false !== strpos( __FILE__, WPMU_PLUGIN_DIR ) ) {
474
+ // Plugin, we'll need to adjust the file name.
475
+ add_action( 'load_textdomain_mofile', array( $this, 'correct_plugin_mofile' ), 10, 2 );
476
+ load_theme_textdomain( 'tgmpa', dirname( __FILE__ ) . '/languages' );
477
+ remove_action( 'load_textdomain_mofile', array( $this, 'correct_plugin_mofile' ), 10 );
478
+ } else {
479
+ load_theme_textdomain( 'tgmpa', dirname( __FILE__ ) . '/languages' );
480
+ }
481
+ }
482
+
483
+ /**
484
+ * Correct the .mo file name for (must-use) plugins.
485
+ *
486
+ * Themese use `/path/{locale}.mo` while plugins use `/path/{text-domain}-{locale}.mo`.
487
+ *
488
+ * {@internal IMPORTANT! If this function changes, review the regex in the custom TGMPA
489
+ * generator on the website.}}
490
+ *
491
+ * @since 2.6.0
492
+ *
493
+ * @param string $mofile Full path to the target mofile.
494
+ * @param string $domain The domain for which a language file is being loaded.
495
+ * @return string $mofile
496
+ */
497
+ public function correct_plugin_mofile( $mofile, $domain ) {
498
+ // Exit early if not our domain (just in case).
499
+ if ( 'tgmpa' !== $domain ) {
500
+ return $mofile;
501
+ }
502
+ return preg_replace( '`/([a-z]{2}_[A-Z]{2}.mo)$`', '/tgmpa-$1', $mofile );
503
+ }
504
+
505
+ /**
506
+ * Potentially overload the fall-back translation file for the current language.
507
+ *
508
+ * WP, by default since WP 3.7, will load a local translation first and if none
509
+ * can be found, will try and find a translation in the /wp-content/languages/ directory.
510
+ * As this library is theme/plugin agnostic, translation files for TGMPA can exist both
511
+ * in the WP_LANG_DIR /plugins/ subdirectory as well as in the /themes/ subdirectory.
512
+ *
513
+ * This method makes sure both directories are checked.
514
+ *
515
+ * {@internal IMPORTANT! If this function changes, review the regex in the custom TGMPA
516
+ * generator on the website.}}
517
+ *
518
+ * @since 2.6.0
519
+ *
520
+ * @param string $mofile Full path to the target mofile.
521
+ * @param string $domain The domain for which a language file is being loaded.
522
+ * @return string $mofile
523
+ */
524
+ public function overload_textdomain_mofile( $mofile, $domain ) {
525
+ // Exit early if not our domain, not a WP_LANG_DIR load or if the file exists and is readable.
526
+ if ( 'tgmpa' !== $domain || false === strpos( $mofile, WP_LANG_DIR ) || @is_readable( $mofile ) ) {
527
+ return $mofile;
528
+ }
529
+
530
+ // Current fallback file is not valid, let's try the alternative option.
531
+ if ( false !== strpos( $mofile, '/themes/' ) ) {
532
+ return str_replace( '/themes/', '/plugins/', $mofile );
533
+ } elseif ( false !== strpos( $mofile, '/plugins/' ) ) {
534
+ return str_replace( '/plugins/', '/themes/', $mofile );
535
+ } else {
536
+ return $mofile;
537
+ }
538
+ }
539
+
540
+ /**
541
+ * Hook in plugin action link filters for the WP native plugins page.
542
+ *
543
+ * - Prevent activation of plugins which don't meet the minimum version requirements.
544
+ * - Prevent deactivation of force-activated plugins.
545
+ * - Add update notice if update available.
546
+ *
547
+ * @since 2.5.0
548
+ */
549
+ public function add_plugin_action_link_filters() {
550
+ foreach ( $this->plugins as $slug => $plugin ) {
551
+ if ( false === $this->can_plugin_activate( $slug ) ) {
552
+ add_filter( 'plugin_action_links_' . $plugin['file_path'], array( $this, 'filter_plugin_action_links_activate' ), 20 );
553
+ }
554
+
555
+ if ( true === $plugin['force_activation'] ) {
556
+ add_filter( 'plugin_action_links_' . $plugin['file_path'], array( $this, 'filter_plugin_action_links_deactivate' ), 20 );
557
+ }
558
+
559
+ if ( false !== $this->does_plugin_require_update( $slug ) ) {
560
+ add_filter( 'plugin_action_links_' . $plugin['file_path'], array( $this, 'filter_plugin_action_links_update' ), 20 );
561
+ }
562
+ }
563
+ }
564
+
565
+ /**
566
+ * Remove the 'Activate' link on the WP native plugins page if the plugin does not meet the
567
+ * minimum version requirements.
568
+ *
569
+ * @since 2.5.0
570
+ *
571
+ * @param array $actions Action links.
572
+ * @return array
573
+ */
574
+ public function filter_plugin_action_links_activate( $actions ) {
575
+ unset( $actions['activate'] );
576
+
577
+ return $actions;
578
+ }
579
+
580
+ /**
581
+ * Remove the 'Deactivate' link on the WP native plugins page if the plugin has been set to force activate.
582
+ *
583
+ * @since 2.5.0
584
+ *
585
+ * @param array $actions Action links.
586
+ * @return array
587
+ */
588
+ public function filter_plugin_action_links_deactivate( $actions ) {
589
+ unset( $actions['deactivate'] );
590
+
591
+ return $actions;
592
+ }
593
+
594
+ /**
595
+ * Add a 'Requires update' link on the WP native plugins page if the plugin does not meet the
596
+ * minimum version requirements.
597
+ *
598
+ * @since 2.5.0
599
+ *
600
+ * @param array $actions Action links.
601
+ * @return array
602
+ */
603
+ public function filter_plugin_action_links_update( $actions ) {
604
+ $actions['update'] = sprintf(
605
+ '<a href="%1$s" title="%2$s" class="edit">%3$s</a>',
606
+ esc_url( $this->get_tgmpa_status_url( 'update' ) ),
607
+ esc_attr__( 'This plugin needs to be updated to be compatible with your theme.', 'tgmpa' ),
608
+ esc_html__( 'Update Required', 'tgmpa' )
609
+ );
610
+
611
+ return $actions;
612
+ }
613
+
614
+ /**
615
+ * Handles calls to show plugin information via links in the notices.
616
+ *
617
+ * We get the links in the admin notices to point to the TGMPA page, rather
618
+ * than the typical plugin-install.php file, so we can prepare everything
619
+ * beforehand.
620
+ *
621
+ * WP does not make it easy to show the plugin information in the thickbox -
622
+ * here we have to require a file that includes a function that does the
623
+ * main work of displaying it, enqueue some styles, set up some globals and
624
+ * finally call that function before exiting.
625
+ *
626
+ * Down right easy once you know how...
627
+ *
628
+ * Returns early if not the TGMPA page.
629
+ *
630
+ * @since 2.1.0
631
+ *
632
+ * @global string $tab Used as iframe div class names, helps with styling
633
+ * @global string $body_id Used as the iframe body ID, helps with styling
634
+ *
635
+ * @return null Returns early if not the TGMPA page.
636
+ */
637
+ public function admin_init() {
638
+ if ( ! $this->is_tgmpa_page() ) {
639
+ return;
640
+ }
641
+
642
+ if ( isset( $_REQUEST['tab'] ) && 'plugin-information' === $_REQUEST['tab'] ) {
643
+ // Needed for install_plugin_information().
644
+ require_once ABSPATH . 'wp-admin/includes/plugin-install.php';
645
+
646
+ wp_enqueue_style( 'plugin-install' );
647
+
648
+ global $tab, $body_id;
649
+ $body_id = 'plugin-information';
650
+ // @codingStandardsIgnoreStart
651
+ $tab = 'plugin-information';
652
+ // @codingStandardsIgnoreEnd
653
+
654
+ install_plugin_information();
655
+
656
+ exit;
657
+ }
658
+ }
659
+
660
+ /**
661
+ * Enqueue thickbox scripts/styles for plugin info.
662
+ *
663
+ * Thickbox is not automatically included on all admin pages, so we must
664
+ * manually enqueue it for those pages.
665
+ *
666
+ * Thickbox is only loaded if the user has not dismissed the admin
667
+ * notice or if there are any plugins left to install and activate.
668
+ *
669
+ * @since 2.1.0
670
+ */
671
+ public function thickbox() {
672
+ if ( ! get_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice_' . $this->id, true ) ) {
673
+ add_thickbox();
674
+ }
675
+ }
676
+
677
+ /**
678
+ * Adds submenu page if there are plugin actions to take.
679
+ *
680
+ * This method adds the submenu page letting users know that a required
681
+ * plugin needs to be installed.
682
+ *
683
+ * This page disappears once the plugin has been installed and activated.
684
+ *
685
+ * @since 1.0.0
686
+ *
687
+ * @see TGM_Plugin_Activation::init()
688
+ * @see TGM_Plugin_Activation::install_plugins_page()
689
+ *
690
+ * @return null Return early if user lacks capability to install a plugin.
691
+ */
692
+ public function admin_menu() {
693
+ // Make sure privileges are correct to see the page.
694
+ if ( ! current_user_can( 'install_plugins' ) ) {
695
+ return;
696
+ }
697
+
698
+ $args = apply_filters(
699
+ 'tgmpa_admin_menu_args',
700
+ array(
701
+ 'parent_slug' => $this->parent_slug, // Parent Menu slug.
702
+ 'page_title' => $this->strings['page_title'], // Page title.
703
+ 'menu_title' => $this->strings['menu_title'], // Menu title.
704
+ 'capability' => $this->capability, // Capability.
705
+ 'menu_slug' => $this->menu, // Menu slug.
706
+ 'function' => array( $this, 'install_plugins_page' ), // Callback.
707
+ )
708
+ );
709
+
710
+ $this->add_admin_menu( $args );
711
+ }
712
+
713
+ /**
714
+ * Add the menu item.
715
+ *
716
+ * {@internal IMPORTANT! If this function changes, review the regex in the custom TGMPA
717
+ * generator on the website.}}
718
+ *
719
+ * @since 2.5.0
720
+ *
721
+ * @param array $args Menu item configuration.
722
+ */
723
+ protected function add_admin_menu( array $args ) {
724
+ if ( has_filter( 'tgmpa_admin_menu_use_add_theme_page' ) ) {
725
+ _deprecated_function( 'The "tgmpa_admin_menu_use_add_theme_page" filter', '2.5.0', esc_html__( 'Set the parent_slug config variable instead.', 'tgmpa' ) );
726
+ }
727
+
728
+ if ( 'themes.php' === $this->parent_slug ) {
729
+ $this->page_hook = call_user_func( 'add_theme_page', $args['page_title'], $args['menu_title'], $args['capability'], $args['menu_slug'], $args['function'] );
730
+ } else {
731
+ $this->page_hook = call_user_func( 'add_submenu_page', $args['parent_slug'], $args['page_title'], $args['menu_title'], $args['capability'], $args['menu_slug'], $args['function'] );
732
+ }
733
+ }
734
+
735
+ /**
736
+ * Echoes plugin installation form.
737
+ *
738
+ * This method is the callback for the admin_menu method function.
739
+ * This displays the admin page and form area where the user can select to install and activate the plugin.
740
+ * Aborts early if we're processing a plugin installation action.
741
+ *
742
+ * @since 1.0.0
743
+ *
744
+ * @return null Aborts early if we're processing a plugin installation action.
745
+ */
746
+ public function install_plugins_page() {
747
+ // Store new instance of plugin table in object.
748
+ $plugin_table = new TGMPA_List_Table;
749
+
750
+ // Return early if processing a plugin installation action.
751
+ if ( ( ( 'tgmpa-bulk-install' === $plugin_table->current_action() || 'tgmpa-bulk-update' === $plugin_table->current_action() ) && $plugin_table->process_bulk_actions() ) || $this->do_plugin_install() ) {
752
+ return;
753
+ }
754
+
755
+ // Force refresh of available plugin information so we'll know about manual updates/deletes.
756
+ wp_clean_plugins_cache( false );
757
+
758
+ ?>
759
+ <div class="tgmpa wrap">
760
+ <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
761
+ <?php $plugin_table->prepare_items(); ?>
762
+
763
+ <?php
764
+ if ( ! empty( $this->message ) && is_string( $this->message ) ) {
765
+ echo wp_kses_post( $this->message );
766
+ }
767
+ ?>
768
+ <?php $plugin_table->views(); ?>
769
+
770
+ <form id="tgmpa-plugins" action="" method="post">
771
+ <input type="hidden" name="tgmpa-page" value="<?php echo esc_attr( $this->menu ); ?>" />
772
+ <input type="hidden" name="plugin_status" value="<?php echo esc_attr( $plugin_table->view_context ); ?>" />
773
+ <?php $plugin_table->display(); ?>
774
+ </form>
775
+ </div>
776
+ <?php
777
+ }
778
+
779
+ /**
780
+ * Installs, updates or activates a plugin depending on the action link clicked by the user.
781
+ *
782
+ * Checks the $_GET variable to see which actions have been
783
+ * passed and responds with the appropriate method.
784
+ *
785
+ * Uses WP_Filesystem to process and handle the plugin installation
786
+ * method.
787
+ *
788
+ * @since 1.0.0
789
+ *
790
+ * @uses WP_Filesystem
791
+ * @uses WP_Error
792
+ * @uses WP_Upgrader
793
+ * @uses Plugin_Upgrader
794
+ * @uses Plugin_Installer_Skin
795
+ * @uses Plugin_Upgrader_Skin
796
+ *
797
+ * @return boolean True on success, false on failure.
798
+ */
799
+ protected function do_plugin_install() {
800
+ if ( empty( $_GET['plugin'] ) ) {
801
+ return false;
802
+ }
803
+
804
+ // All plugin information will be stored in an array for processing.
805
+ $slug = $this->sanitize_key( urldecode( $_GET['plugin'] ) );
806
+
807
+ if ( ! isset( $this->plugins[ $slug ] ) ) {
808
+ return false;
809
+ }
810
+
811
+ // Was an install or upgrade action link clicked?
812
+ if ( ( isset( $_GET['tgmpa-install'] ) && 'install-plugin' === $_GET['tgmpa-install'] ) || ( isset( $_GET['tgmpa-update'] ) && 'update-plugin' === $_GET['tgmpa-update'] ) ) {
813
+
814
+ $install_type = 'install';
815
+ if ( isset( $_GET['tgmpa-update'] ) && 'update-plugin' === $_GET['tgmpa-update'] ) {
816
+ $install_type = 'update';
817
+ }
818
+
819
+ check_admin_referer( 'tgmpa-' . $install_type, 'tgmpa-nonce' );
820
+
821
+ // Pass necessary information via URL if WP_Filesystem is needed.
822
+ $url = wp_nonce_url(
823
+ add_query_arg(
824
+ array(
825
+ 'plugin' => urlencode( $slug ),
826
+ 'tgmpa-' . $install_type => $install_type . '-plugin',
827
+ ),
828
+ $this->get_tgmpa_url()
829
+ ),
830
+ 'tgmpa-' . $install_type,
831
+ 'tgmpa-nonce'
832
+ );
833
+
834
+ $method = ''; // Leave blank so WP_Filesystem can populate it as necessary.
835
+
836
+ if ( false === ( $creds = request_filesystem_credentials( esc_url_raw( $url ), $method, false, false, array() ) ) ) {
837
+ return true;
838
+ }
839
+
840
+ if ( ! WP_Filesystem( $creds ) ) {
841
+ request_filesystem_credentials( esc_url_raw( $url ), $method, true, false, array() ); // Setup WP_Filesystem.
842
+ return true;
843
+ }
844
+
845
+ /* If we arrive here, we have the filesystem. */
846
+
847
+ // Prep variables for Plugin_Installer_Skin class.
848
+ $extra = array();
849
+ $extra['slug'] = $slug; // Needed for potentially renaming of directory name.
850
+ $source = $this->get_download_url( $slug );
851
+ $api = ( 'repo' === $this->plugins[ $slug ]['source_type'] ) ? $this->get_plugins_api( $slug ) : null;
852
+ $api = ( false !== $api ) ? $api : null;
853
+
854
+ $url = add_query_arg(
855
+ array(
856
+ 'action' => $install_type . '-plugin',
857
+ 'plugin' => urlencode( $slug ),
858
+ ),
859
+ 'update.php'
860
+ );
861
+
862
+ if ( ! class_exists( 'Plugin_Upgrader', false ) ) {
863
+ require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
864
+ }
865
+
866
+ $title = ( 'update' === $install_type ) ? $this->strings['updating'] : $this->strings['installing'];
867
+ $skin_args = array(
868
+ 'type' => ( 'bundled' !== $this->plugins[ $slug ]['source_type'] ) ? 'web' : 'upload',
869
+ 'title' => sprintf( $title, $this->plugins[ $slug ]['name'] ),
870
+ 'url' => esc_url_raw( $url ),
871
+ 'nonce' => $install_type . '-plugin_' . $slug,
872
+ 'plugin' => '',
873
+ 'api' => $api,
874
+ 'extra' => $extra,
875
+ );
876
+ unset( $title );
877
+
878
+ if ( 'update' === $install_type ) {
879
+ $skin_args['plugin'] = $this->plugins[ $slug ]['file_path'];
880
+ $skin = new Plugin_Upgrader_Skin( $skin_args );
881
+ } else {
882
+ $skin = new Plugin_Installer_Skin( $skin_args );
883
+ }
884
+
885
+ // Create a new instance of Plugin_Upgrader.
886
+ $upgrader = new Plugin_Upgrader( $skin );
887
+
888
+ // Perform the action and install the plugin from the $source urldecode().
889
+ add_filter( 'upgrader_source_selection', array( $this, 'maybe_adjust_source_dir' ), 1, 3 );
890
+
891
+ if ( 'update' === $install_type ) {
892
+ // Inject our info into the update transient.
893
+ $to_inject = array( $slug => $this->plugins[ $slug ] );
894
+ $to_inject[ $slug ]['source'] = $source;
895
+ $this->inject_update_info( $to_inject );
896
+
897
+ $upgrader->upgrade( $this->plugins[ $slug ]['file_path'] );
898
+ } else {
899
+ $upgrader->install( $source );
900
+ }
901
+
902
+ remove_filter( 'upgrader_source_selection', array( $this, 'maybe_adjust_source_dir' ), 1 );
903
+
904
+ // Make sure we have the correct file path now the plugin is installed/updated.
905
+ $this->populate_file_path( $slug );
906
+
907
+ // Only activate plugins if the config option is set to true and the plugin isn't
908
+ // already active (upgrade).
909
+ if ( $this->is_automatic && ! $this->is_plugin_active( $slug ) ) {
910
+ $plugin_activate = $upgrader->plugin_info(); // Grab the plugin info from the Plugin_Upgrader method.
911
+ if ( false === $this->activate_single_plugin( $plugin_activate, $slug, true ) ) {
912
+ return true; // Finish execution of the function early as we encountered an error.
913
+ }
914
+ }
915
+
916
+ $this->show_tgmpa_version();
917
+
918
+ // Display message based on if all plugins are now active or not.
919
+ if ( $this->is_tgmpa_complete() ) {
920
+ echo '<p>', sprintf( esc_html( $this->strings['complete'] ), '<a href="' . esc_url( self_admin_url() ) . '">' . esc_html__( 'Return to the Dashboard', 'tgmpa' ) . '</a>' ), '</p>';
921
+ echo '<style type="text/css">#adminmenu .wp-submenu li.current { display: none !important; }</style>';
922
+ } else {
923
+ echo '<p><a href="', esc_url( $this->get_tgmpa_url() ), '" target="_parent">', esc_html( $this->strings['return'] ), '</a></p>';
924
+ }
925
+
926
+ return true;
927
+ } elseif ( isset( $this->plugins[ $slug ]['file_path'], $_GET['tgmpa-activate'] ) && 'activate-plugin' === $_GET['tgmpa-activate'] ) {
928
+ // Activate action link was clicked.
929
+ check_admin_referer( 'tgmpa-activate', 'tgmpa-nonce' );
930
+
931
+ if ( false === $this->activate_single_plugin( $this->plugins[ $slug ]['file_path'], $slug ) ) {
932
+ return true; // Finish execution of the function early as we encountered an error.
933
+ }
934
+ }
935
+
936
+ return false;
937
+ }
938
+
939
+ /**
940
+ * Inject information into the 'update_plugins' site transient as WP checks that before running an update.
941
+ *
942
+ * @since 2.5.0
943
+ *
944
+ * @param array $plugins The plugin information for the plugins which are to be updated.
945
+ */
946
+ public function inject_update_info( $plugins ) {
947
+ $repo_updates = get_site_transient( 'update_plugins' );
948
+
949
+ if ( ! is_object( $repo_updates ) ) {
950
+ $repo_updates = new stdClass;
951
+ }
952
+
953
+ foreach ( $plugins as $slug => $plugin ) {
954
+ $file_path = $plugin['file_path'];
955
+
956
+ if ( empty( $repo_updates->response[ $file_path ] ) ) {
957
+ $repo_updates->response[ $file_path ] = new stdClass;
958
+ }
959
+
960
+ // We only really need to set package, but let's do all we can in case WP changes something.
961
+ $repo_updates->response[ $file_path ]->slug = $slug;
962
+ $repo_updates->response[ $file_path ]->plugin = $file_path;
963
+ $repo_updates->response[ $file_path ]->new_version = $plugin['version'];
964
+ $repo_updates->response[ $file_path ]->package = $plugin['source'];
965
+ if ( empty( $repo_updates->response[ $file_path ]->url ) && ! empty( $plugin['external_url'] ) ) {
966
+ $repo_updates->response[ $file_path ]->url = $plugin['external_url'];
967
+ }
968
+ }
969
+
970
+ set_site_transient( 'update_plugins', $repo_updates );
971
+ }
972
+
973
+ /**
974
+ * Adjust the plugin directory name if necessary.
975
+ *
976
+ * The final destination directory of a plugin is based on the subdirectory name found in the
977
+ * (un)zipped source. In some cases - most notably GitHub repository plugin downloads -, this
978
+ * subdirectory name is not the same as the expected slug and the plugin will not be recognized
979
+ * as installed. This is fixed by adjusting the temporary unzipped source subdirectory name to
980
+ * the expected plugin slug.
981
+ *
982
+ * @since 2.5.0
983
+ *
984
+ * @param string $source Path to upgrade/zip-file-name.tmp/subdirectory/.
985
+ * @param string $remote_source Path to upgrade/zip-file-name.tmp.
986
+ * @param \WP_Upgrader $upgrader Instance of the upgrader which installs the plugin.
987
+ * @return string $source
988
+ */
989
+ public function maybe_adjust_source_dir( $source, $remote_source, $upgrader ) {
990
+ if ( ! $this->is_tgmpa_page() || ! is_object( $GLOBALS['wp_filesystem'] ) ) {
991
+ return $source;
992
+ }
993
+
994
+ // Check for single file plugins.
995
+ $source_files = array_keys( $GLOBALS['wp_filesystem']->dirlist( $remote_source ) );
996
+ if ( 1 === count( $source_files ) && false === $GLOBALS['wp_filesystem']->is_dir( $source ) ) {
997
+ return $source;
998
+ }
999
+
1000
+ // Multi-file plugin, let's see if the directory is correctly named.
1001
+ $desired_slug = '';
1002
+
1003
+ // Figure out what the slug is supposed to be.
1004
+ if ( false === $upgrader->bulk && ! empty( $upgrader->skin->options['extra']['slug'] ) ) {
1005
+ $desired_slug = $upgrader->skin->options['extra']['slug'];
1006
+ } else {
1007
+ // Bulk installer contains less info, so fall back on the info registered here.
1008
+ foreach ( $this->plugins as $slug => $plugin ) {
1009
+ if ( ! empty( $upgrader->skin->plugin_names[ $upgrader->skin->i ] ) && $plugin['name'] === $upgrader->skin->plugin_names[ $upgrader->skin->i ] ) {
1010
+ $desired_slug = $slug;
1011
+ break;
1012
+ }
1013
+ }
1014
+ unset( $slug, $plugin );
1015
+ }
1016
+
1017
+ if ( ! empty( $desired_slug ) ) {
1018
+ $subdir_name = untrailingslashit( str_replace( trailingslashit( $remote_source ), '', $source ) );
1019
+
1020
+ if ( ! empty( $subdir_name ) && $subdir_name !== $desired_slug ) {
1021
+ $from_path = untrailingslashit( $source );
1022
+ $to_path = trailingslashit( $remote_source ) . $desired_slug;
1023
+
1024
+ if ( true === $GLOBALS['wp_filesystem']->move( $from_path, $to_path ) ) {
1025
+ return trailingslashit( $to_path );
1026
+ } else {
1027
+ return new WP_Error( 'rename_failed', esc_html__( 'The remote plugin package does not contain a folder with the desired slug and renaming did not work.', 'tgmpa' ) . ' ' . esc_html__( 'Please contact the plugin provider and ask them to package their plugin according to the WordPress guidelines.', 'tgmpa' ), array( 'found' => $subdir_name, 'expected' => $desired_slug ) );
1028
+ }
1029
+ } elseif ( empty( $subdir_name ) ) {
1030
+ return new WP_Error( 'packaged_wrong', esc_html__( 'The remote plugin package consists of more than one file, but the files are not packaged in a folder.', 'tgmpa' ) . ' ' . esc_html__( 'Please contact the plugin provider and ask them to package their plugin according to the WordPress guidelines.', 'tgmpa' ), array( 'found' => $subdir_name, 'expected' => $desired_slug ) );
1031
+ }
1032
+ }
1033
+
1034
+ return $source;
1035
+ }
1036
+
1037
+ /**
1038
+ * Activate a single plugin and send feedback about the result to the screen.
1039
+ *
1040
+ * @since 2.5.0
1041
+ *
1042
+ * @param string $file_path Path within wp-plugins/ to main plugin file.
1043
+ * @param string $slug Plugin slug.
1044
+ * @param bool $automatic Whether this is an automatic activation after an install. Defaults to false.
1045
+ * This determines the styling of the output messages.
1046
+ * @return bool False if an error was encountered, true otherwise.
1047
+ */
1048
+ protected function activate_single_plugin( $file_path, $slug, $automatic = false ) {
1049
+ if ( $this->can_plugin_activate( $slug ) ) {
1050
+ $activate = activate_plugin( $file_path );
1051
+
1052
+ if ( is_wp_error( $activate ) ) {
1053
+ echo '<div id="message" class="error"><p>', wp_kses_post( $activate->get_error_message() ), '</p></div>',
1054
+ '<p><a href="', esc_url( $this->get_tgmpa_url() ), '" target="_parent">', esc_html( $this->strings['return'] ), '</a></p>';
1055
+
1056
+ return false; // End it here if there is an error with activation.
1057
+ } else {
1058
+ if ( ! $automatic ) {
1059
+ // Make sure message doesn't display again if bulk activation is performed
1060
+ // immediately after a single activation.
1061
+ if ( ! isset( $_POST['action'] ) ) { // WPCS: CSRF OK.
1062
+ echo '<div id="message" class="updated"><p>', esc_html( $this->strings['activated_successfully'] ), ' <strong>', esc_html( $this->plugins[ $slug ]['name'] ), '.</strong></p></div>';
1063
+ }
1064
+ } else {
1065
+ // Simpler message layout for use on the plugin install page.
1066
+ echo '<p>', esc_html( $this->strings['plugin_activated'] ), '</p>';
1067
+ }
1068
+ }
1069
+ } elseif ( $this->is_plugin_active( $slug ) ) {
1070
+ // No simpler message format provided as this message should never be encountered
1071
+ // on the plugin install page.
1072
+ echo '<div id="message" class="error"><p>',
1073
+ sprintf(
1074
+ esc_html( $this->strings['plugin_already_active'] ),
1075
+ '<strong>' . esc_html( $this->plugins[ $slug ]['name'] ) . '</strong>'
1076
+ ),
1077
+ '</p></div>';
1078
+ } elseif ( $this->does_plugin_require_update( $slug ) ) {
1079
+ if ( ! $automatic ) {
1080
+ // Make sure message doesn't display again if bulk activation is performed
1081
+ // immediately after a single activation.
1082
+ if ( ! isset( $_POST['action'] ) ) { // WPCS: CSRF OK.
1083
+ echo '<div id="message" class="error"><p>',
1084
+ sprintf(
1085
+ esc_html( $this->strings['plugin_needs_higher_version'] ),
1086
+ '<strong>' . esc_html( $this->plugins[ $slug ]['name'] ) . '</strong>'
1087
+ ),
1088
+ '</p></div>';
1089
+ }
1090
+ } else {
1091
+ // Simpler message layout for use on the plugin install page.
1092
+ echo '<p>', sprintf( esc_html( $this->strings['plugin_needs_higher_version'] ), esc_html( $this->plugins[ $slug ]['name'] ) ), '</p>';
1093
+ }
1094
+ }
1095
+
1096
+ return true;
1097
+ }
1098
+
1099
+ /**
1100
+ * Echoes required plugin notice.
1101
+ *
1102
+ * Outputs a message telling users that a specific plugin is required for
1103
+ * their theme. If appropriate, it includes a link to the form page where
1104
+ * users can install and activate the plugin.
1105
+ *
1106
+ * Returns early if we're on the Install page.
1107
+ *
1108
+ * @since 1.0.0
1109
+ *
1110
+ * @global object $current_screen
1111
+ *
1112
+ * @return null Returns early if we're on the Install page.
1113
+ */
1114
+ public function notices() {
1115
+ // Remove nag on the install page / Return early if the nag message has been dismissed or user < author.
1116
+ if ( ( $this->is_tgmpa_page() || $this->is_core_update_page() ) || get_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice_' . $this->id, true ) || ! current_user_can( apply_filters( 'tgmpa_show_admin_notice_capability', 'publish_posts' ) ) ) {
1117
+ return;
1118
+ }
1119
+
1120
+ // Store for the plugin slugs by message type.
1121
+ $message = array();
1122
+
1123
+ // Initialize counters used to determine plurality of action link texts.
1124
+ $install_link_count = 0;
1125
+ $update_link_count = 0;
1126
+ $activate_link_count = 0;
1127
+ $total_required_action_count = 0;
1128
+
1129
+ foreach ( $this->plugins as $slug => $plugin ) {
1130
+ if ( $this->is_plugin_active( $slug ) && false === $this->does_plugin_have_update( $slug ) ) {
1131
+ continue;
1132
+ }
1133
+
1134
+ if ( ! $this->is_plugin_installed( $slug ) ) {
1135
+ if ( current_user_can( 'install_plugins' ) ) {
1136
+ $install_link_count++;
1137
+
1138
+ if ( true === $plugin['required'] ) {
1139
+ $message['notice_can_install_required'][] = $slug;
1140
+ } else {
1141
+ $message['notice_can_install_recommended'][] = $slug;
1142
+ }
1143
+ }
1144
+ if ( true === $plugin['required'] ) {
1145
+ $total_required_action_count++;
1146
+ }
1147
+ } else {
1148
+ if ( ! $this->is_plugin_active( $slug ) && $this->can_plugin_activate( $slug ) ) {
1149
+ if ( current_user_can( 'activate_plugins' ) ) {
1150
+ $activate_link_count++;
1151
+
1152
+ if ( true === $plugin['required'] ) {
1153
+ $message['notice_can_activate_required'][] = $slug;
1154
+ } else {
1155
+ $message['notice_can_activate_recommended'][] = $slug;
1156
+ }
1157
+ }
1158
+ if ( true === $plugin['required'] ) {
1159
+ $total_required_action_count++;
1160
+ }
1161
+ }
1162
+
1163
+ if ( $this->does_plugin_require_update( $slug ) || false !== $this->does_plugin_have_update( $slug ) ) {
1164
+
1165
+ if ( current_user_can( 'update_plugins' ) ) {
1166
+ $update_link_count++;
1167
+
1168
+ if ( $this->does_plugin_require_update( $slug ) ) {
1169
+ $message['notice_ask_to_update'][] = $slug;
1170
+ } elseif ( false !== $this->does_plugin_have_update( $slug ) ) {
1171
+ $message['notice_ask_to_update_maybe'][] = $slug;
1172
+ }
1173
+ }
1174
+ if ( true === $plugin['required'] ) {
1175
+ $total_required_action_count++;
1176
+ }
1177
+ }
1178
+ }
1179
+ }
1180
+ unset( $slug, $plugin );
1181
+
1182
+ // If we have notices to display, we move forward.
1183
+ if ( ! empty( $message ) || $total_required_action_count > 0 ) {
1184
+ krsort( $message ); // Sort messages.
1185
+ $rendered = '';
1186
+
1187
+ // As add_settings_error() wraps the final message in a <p> and as the final message can't be
1188
+ // filtered, using <p>'s in our html would render invalid html output.
1189
+ $line_template = '<span style="display: block; margin: 0.5em 0.5em 0 0; clear: both;">%s</span>' . "\n";
1190
+
1191
+ if ( ! current_user_can( 'activate_plugins' ) && ! current_user_can( 'install_plugins' ) && ! current_user_can( 'update_plugins' ) ) {
1192
+ $rendered = esc_html( $this->strings['notice_cannot_install_activate'] ) . ' ' . esc_html( $this->strings['contact_admin'] );
1193
+ $rendered .= $this->create_user_action_links_for_notice( 0, 0, 0, $line_template );
1194
+ } else {
1195
+
1196
+ // If dismissable is false and a message is set, output it now.
1197
+ if ( ! $this->dismissable && ! empty( $this->dismiss_msg ) ) {
1198
+ $rendered .= sprintf( $line_template, wp_kses_post( $this->dismiss_msg ) );
1199
+ }
1200
+
1201
+ // Render the individual message lines for the notice.
1202
+ foreach ( $message as $type => $plugin_group ) {
1203
+ $linked_plugins = array();
1204
+
1205
+ // Get the external info link for a plugin if one is available.
1206
+ foreach ( $plugin_group as $plugin_slug ) {
1207
+ $linked_plugins[] = $this->get_info_link( $plugin_slug );
1208
+ }
1209
+ unset( $plugin_slug );
1210
+
1211
+ $count = count( $plugin_group );
1212
+ $linked_plugins = array_map( array( 'TGMPA_Utils', 'wrap_in_em' ), $linked_plugins );
1213
+ $last_plugin = array_pop( $linked_plugins ); // Pop off last name to prep for readability.
1214
+ $imploded = empty( $linked_plugins ) ? $last_plugin : ( implode( ', ', $linked_plugins ) . ' ' . esc_html_x( 'and', 'plugin A *and* plugin B', 'tgmpa' ) . ' ' . $last_plugin );
1215
+
1216
+ $rendered .= sprintf(
1217
+ $line_template,
1218
+ sprintf(
1219
+ translate_nooped_plural( $this->strings[ $type ], $count, 'tgmpa' ),
1220
+ $imploded,
1221
+ $count
1222
+ )
1223
+ );
1224
+
1225
+ }
1226
+ unset( $type, $plugin_group, $linked_plugins, $count, $last_plugin, $imploded );
1227
+
1228
+ $rendered .= $this->create_user_action_links_for_notice( $install_link_count, $update_link_count, $activate_link_count, $line_template );
1229
+ }
1230
+
1231
+ // Register the nag messages and prepare them to be processed.
1232
+ add_settings_error( 'tgmpa', 'tgmpa', $rendered, $this->get_admin_notice_class() );
1233
+ }
1234
+
1235
+ // Admin options pages already output settings_errors, so this is to avoid duplication.
1236
+ if ( 'options-general' !== $GLOBALS['current_screen']->parent_base ) {
1237
+ $this->display_settings_errors();
1238
+ }
1239
+ }
1240
+
1241
+ /**
1242
+ * Generate the user action links for the admin notice.
1243
+ *
1244
+ * @since 2.6.0
1245
+ *
1246
+ * @param int $install_count Number of plugins to install.
1247
+ * @param int $update_count Number of plugins to update.
1248
+ * @param int $activate_count Number of plugins to activate.
1249
+ * @param int $line_template Template for the HTML tag to output a line.
1250
+ * @return string Action links.
1251
+ */
1252
+ protected function create_user_action_links_for_notice( $install_count, $update_count, $activate_count, $line_template ) {
1253
+ // Setup action links.
1254
+ $action_links = array(
1255
+ 'install' => '',
1256
+ 'update' => '',
1257
+ 'activate' => '',
1258
+ 'dismiss' => $this->dismissable ? '<a href="' . esc_url( wp_nonce_url( add_query_arg( 'tgmpa-dismiss', 'dismiss_admin_notices' ), 'tgmpa-dismiss-' . get_current_user_id() ) ) . '" class="dismiss-notice" target="_parent">' . esc_html( $this->strings['dismiss'] ) . '</a>' : '',
1259
+ );
1260
+
1261
+ $link_template = '<a href="%2$s">%1$s</a>';
1262
+
1263
+ if ( current_user_can( 'install_plugins' ) ) {
1264
+ if ( $install_count > 0 ) {
1265
+ $action_links['install'] = sprintf(
1266
+ $link_template,
1267
+ translate_nooped_plural( $this->strings['install_link'], $install_count, 'tgmpa' ),
1268
+ esc_url( $this->get_tgmpa_status_url( 'install' ) )
1269
+ );
1270
+ }
1271
+ if ( $update_count > 0 ) {
1272
+ $action_links['update'] = sprintf(
1273
+ $link_template,
1274
+ translate_nooped_plural( $this->strings['update_link'], $update_count, 'tgmpa' ),
1275
+ esc_url( $this->get_tgmpa_status_url( 'update' ) )
1276
+ );
1277
+ }
1278
+ }
1279
+
1280
+ if ( current_user_can( 'activate_plugins' ) && $activate_count > 0 ) {
1281
+ $action_links['activate'] = sprintf(
1282
+ $link_template,
1283
+ translate_nooped_plural( $this->strings['activate_link'], $activate_count, 'tgmpa' ),
1284
+ esc_url( $this->get_tgmpa_status_url( 'activate' ) )
1285
+ );
1286
+ }
1287
+
1288
+ $action_links = apply_filters( 'tgmpa_notice_action_links', $action_links );
1289
+
1290
+ $action_links = array_filter( (array) $action_links ); // Remove any empty array items.
1291
+
1292
+ if ( ! empty( $action_links ) ) {
1293
+ $action_links = sprintf( $line_template, implode( ' | ', $action_links ) );
1294
+ return apply_filters( 'tgmpa_notice_rendered_action_links', $action_links );
1295
+ } else {
1296
+ return '';
1297
+ }
1298
+ }
1299
+
1300
+ /**
1301
+ * Get admin notice class.
1302
+ *
1303
+ * Work around all the changes to the various admin notice classes between WP 4.4 and 3.7
1304
+ * (lowest supported version by TGMPA).
1305
+ *
1306
+ * @since 2.6.0
1307
+ *
1308
+ * @return string
1309
+ */
1310
+ protected function get_admin_notice_class() {
1311
+ if ( ! empty( $this->strings['nag_type'] ) ) {
1312
+ return sanitize_html_class( strtolower( $this->strings['nag_type'] ) );
1313
+ } else {
1314
+ if ( version_compare( $this->wp_version, '4.2', '>=' ) ) {
1315
+ return 'notice-warning';
1316
+ } elseif ( version_compare( $this->wp_version, '4.1', '>=' ) ) {
1317
+ return 'notice';
1318
+ } else {
1319
+ return 'updated';
1320
+ }
1321
+ }
1322
+ }
1323
+
1324
+ /**
1325
+ * Display settings errors and remove those which have been displayed to avoid duplicate messages showing
1326
+ *
1327
+ * @since 2.5.0
1328
+ */
1329
+ protected function display_settings_errors() {
1330
+ global $wp_settings_errors;
1331
+
1332
+ settings_errors( 'tgmpa' );
1333
+
1334
+ foreach ( (array) $wp_settings_errors as $key => $details ) {
1335
+ if ( 'tgmpa' === $details['setting'] ) {
1336
+ unset( $wp_settings_errors[ $key ] );
1337
+ break;
1338
+ }
1339
+ }
1340
+ }
1341
+
1342
+ /**
1343
+ * Register dismissal of admin notices.
1344
+ *
1345
+ * Acts on the dismiss link in the admin nag messages.
1346
+ * If clicked, the admin notice disappears and will no longer be visible to this user.
1347
+ *
1348
+ * @since 2.1.0
1349
+ */
1350
+ public function dismiss() {
1351
+ if ( isset( $_GET['tgmpa-dismiss'] ) && check_admin_referer( 'tgmpa-dismiss-' . get_current_user_id() ) ) {
1352
+ update_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice_' . $this->id, 1 );
1353
+ }
1354
+ }
1355
+
1356
+ /**
1357
+ * Add individual plugin to our collection of plugins.
1358
+ *
1359
+ * If the required keys are not set or the plugin has already
1360
+ * been registered, the plugin is not added.
1361
+ *
1362
+ * @since 2.0.0
1363
+ *
1364
+ * @param array|null $plugin Array of plugin arguments or null if invalid argument.
1365
+ * @return null Return early if incorrect argument.
1366
+ */
1367
+ public function register( $plugin ) {
1368
+ if ( empty( $plugin['slug'] ) || empty( $plugin['name'] ) ) {
1369
+ return;
1370
+ }
1371
+
1372
+ if ( empty( $plugin['slug'] ) || ! is_string( $plugin['slug'] ) || isset( $this->plugins[ $plugin['slug'] ] ) ) {
1373
+ return;
1374
+ }
1375
+
1376
+ $defaults = array(
1377
+ 'name' => '', // String
1378
+ 'slug' => '', // String
1379
+ 'source' => 'repo', // String
1380
+ 'required' => false, // Boolean
1381
+ 'version' => '', // String
1382
+ 'force_activation' => false, // Boolean
1383
+ 'force_deactivation' => false, // Boolean
1384
+ 'external_url' => '', // String
1385
+ 'is_callable' => '', // String|Array.
1386
+ );
1387
+
1388
+ // Prepare the received data.
1389
+ $plugin = wp_parse_args( $plugin, $defaults );
1390
+
1391
+ // Standardize the received slug.
1392
+ $plugin['slug'] = $this->sanitize_key( $plugin['slug'] );
1393
+
1394
+ // Forgive users for using string versions of booleans or floats for version number.
1395
+ $plugin['version'] = (string) $plugin['version'];
1396
+ $plugin['source'] = empty( $plugin['source'] ) ? 'repo' : $plugin['source'];
1397
+ $plugin['required'] = TGMPA_Utils::validate_bool( $plugin['required'] );
1398
+ $plugin['force_activation'] = TGMPA_Utils::validate_bool( $plugin['force_activation'] );
1399
+ $plugin['force_deactivation'] = TGMPA_Utils::validate_bool( $plugin['force_deactivation'] );
1400
+
1401
+ // Enrich the received data.
1402
+ $plugin['file_path'] = $this->_get_plugin_basename_from_slug( $plugin['slug'] );
1403
+ $plugin['source_type'] = $this->get_plugin_source_type( $plugin['source'] );
1404
+
1405
+ // Set the class properties.
1406
+ $this->plugins[ $plugin['slug'] ] = $plugin;
1407
+ $this->sort_order[ $plugin['slug'] ] = $plugin['name'];
1408
+
1409
+ // Should we add the force activation hook ?
1410
+ if ( true === $plugin['force_activation'] ) {
1411
+ $this->has_forced_activation = true;
1412
+ }
1413
+
1414
+ // Should we add the force deactivation hook ?
1415
+ if ( true === $plugin['force_deactivation'] ) {
1416
+ $this->has_forced_deactivation = true;
1417
+ }
1418
+ }
1419
+
1420
+ /**
1421
+ * Determine what type of source the plugin comes from.
1422
+ *
1423
+ * @since 2.5.0
1424
+ *
1425
+ * @param string $source The source of the plugin as provided, either empty (= WP repo), a file path
1426
+ * (= bundled) or an external URL.
1427
+ * @return string 'repo', 'external', or 'bundled'
1428
+ */
1429
+ protected function get_plugin_source_type( $source ) {
1430
+ if ( 'repo' === $source || preg_match( self::WP_REPO_REGEX, $source ) ) {
1431
+ return 'repo';
1432
+ } elseif ( preg_match( self::IS_URL_REGEX, $source ) ) {
1433
+ return 'external';
1434
+ } else {
1435
+ return 'bundled';
1436
+ }
1437
+ }
1438
+
1439
+ /**
1440
+ * Sanitizes a string key.
1441
+ *
1442
+ * Near duplicate of WP Core `sanitize_key()`. The difference is that uppercase characters *are*
1443
+ * allowed, so as not to break upgrade paths from non-standard bundled plugins using uppercase
1444
+ * characters in the plugin directory path/slug. Silly them.
1445
+ *
1446
+ * @see https://developer.wordpress.org/reference/hooks/sanitize_key/
1447
+ *
1448
+ * @since 2.5.0
1449
+ *
1450
+ * @param string $key String key.
1451
+ * @return string Sanitized key
1452
+ */
1453
+ public function sanitize_key( $key ) {
1454
+ $raw_key = $key;
1455
+ $key = preg_replace( '`[^A-Za-z0-9_-]`', '', $key );
1456
+
1457
+ /**
1458
+ * Filter a sanitized key string.
1459
+ *
1460
+ * @since 2.5.0
1461
+ *
1462
+ * @param string $key Sanitized key.
1463
+ * @param string $raw_key The key prior to sanitization.
1464
+ */
1465
+ return apply_filters( 'tgmpa_sanitize_key', $key, $raw_key );
1466
+ }
1467
+
1468
+ /**
1469
+ * Amend default configuration settings.
1470
+ *
1471
+ * @since 2.0.0
1472
+ *
1473
+ * @param array $config Array of config options to pass as class properties.
1474
+ */
1475
+ public function config( $config ) {
1476
+ $keys = array(
1477
+ 'id',
1478
+ 'default_path',
1479
+ 'has_notices',
1480
+ 'dismissable',
1481
+ 'dismiss_msg',
1482
+ 'menu',
1483
+ 'parent_slug',
1484
+ 'capability',
1485
+ 'is_automatic',
1486
+ 'message',
1487
+ 'strings',
1488
+ );
1489
+
1490
+ foreach ( $keys as $key ) {
1491
+ if ( isset( $config[ $key ] ) ) {
1492
+ if ( is_array( $config[ $key ] ) ) {
1493
+ $this->$key = array_merge( $this->$key, $config[ $key ] );
1494
+ } else {
1495
+ $this->$key = $config[ $key ];
1496
+ }
1497
+ }
1498
+ }
1499
+ }
1500
+
1501
+ /**
1502
+ * Amend action link after plugin installation.
1503
+ *
1504
+ * @since 2.0.0
1505
+ *
1506
+ * @param array $install_actions Existing array of actions.
1507
+ * @return false|array Amended array of actions.
1508
+ */
1509
+ public function actions( $install_actions ) {
1510
+ // Remove action links on the TGMPA install page.
1511
+ if ( $this->is_tgmpa_page() ) {
1512
+ return false;
1513
+ }
1514
+
1515
+ return $install_actions;
1516
+ }
1517
+
1518
+ /**
1519
+ * Flushes the plugins cache on theme switch to prevent stale entries
1520
+ * from remaining in the plugin table.
1521
+ *
1522
+ * @since 2.4.0
1523
+ *
1524
+ * @param bool $clear_update_cache Optional. Whether to clear the Plugin updates cache.
1525
+ * Parameter added in v2.5.0.
1526
+ */
1527
+ public function flush_plugins_cache( $clear_update_cache = true ) {
1528
+ wp_clean_plugins_cache( $clear_update_cache );
1529
+ }
1530
+
1531
+ /**
1532
+ * Set file_path key for each installed plugin.
1533
+ *
1534
+ * @since 2.1.0
1535
+ *
1536
+ * @param string $plugin_slug Optional. If set, only (re-)populates the file path for that specific plugin.
1537
+ * Parameter added in v2.5.0.
1538
+ */
1539
+ public function populate_file_path( $plugin_slug = '' ) {
1540
+ if ( ! empty( $plugin_slug ) && is_string( $plugin_slug ) && isset( $this->plugins[ $plugin_slug ] ) ) {
1541
+ $this->plugins[ $plugin_slug ]['file_path'] = $this->_get_plugin_basename_from_slug( $plugin_slug );
1542
+ } else {
1543
+ // Add file_path key for all plugins.
1544
+ foreach ( $this->plugins as $slug => $values ) {
1545
+ $this->plugins[ $slug ]['file_path'] = $this->_get_plugin_basename_from_slug( $slug );
1546
+ }
1547
+ }
1548
+ }
1549
+
1550
+ /**
1551
+ * Helper function to extract the file path of the plugin file from the
1552
+ * plugin slug, if the plugin is installed.
1553
+ *
1554
+ * @since 2.0.0
1555
+ *
1556
+ * @param string $slug Plugin slug (typically folder name) as provided by the developer.
1557
+ * @return string Either file path for plugin if installed, or just the plugin slug.
1558
+ */
1559
+ protected function _get_plugin_basename_from_slug( $slug ) {
1560
+ $keys = array_keys( $this->get_plugins() );
1561
+
1562
+ foreach ( $keys as $key ) {
1563
+ if ( preg_match( '|^' . $slug . '/|', $key ) ) {
1564
+ return $key;
1565
+ }
1566
+ }
1567
+
1568
+ return $slug;
1569
+ }
1570
+
1571
+ /**
1572
+ * Retrieve plugin data, given the plugin name.
1573
+ *
1574
+ * Loops through the registered plugins looking for $name. If it finds it,
1575
+ * it returns the $data from that plugin. Otherwise, returns false.
1576
+ *
1577
+ * @since 2.1.0
1578
+ *
1579
+ * @param string $name Name of the plugin, as it was registered.
1580
+ * @param string $data Optional. Array key of plugin data to return. Default is slug.
1581
+ * @return string|boolean Plugin slug if found, false otherwise.
1582
+ */
1583
+ public function _get_plugin_data_from_name( $name, $data = 'slug' ) {
1584
+ foreach ( $this->plugins as $values ) {
1585
+ if ( $name === $values['name'] && isset( $values[ $data ] ) ) {
1586
+ return $values[ $data ];
1587
+ }
1588
+ }
1589
+
1590
+ return false;
1591
+ }
1592
+
1593
+ /**
1594
+ * Retrieve the download URL for a package.
1595
+ *
1596
+ * @since 2.5.0
1597
+ *
1598
+ * @param string $slug Plugin slug.
1599
+ * @return string Plugin download URL or path to local file or empty string if undetermined.
1600
+ */
1601
+ public function get_download_url( $slug ) {
1602
+ $dl_source = '';
1603
+
1604
+ switch ( $this->plugins[ $slug ]['source_type'] ) {
1605
+ case 'repo':
1606
+ return $this->get_wp_repo_download_url( $slug );
1607
+ case 'external':
1608
+ return $this->plugins[ $slug ]['source'];
1609
+ case 'bundled':
1610
+ return $this->default_path . $this->plugins[ $slug ]['source'];
1611
+ }
1612
+
1613
+ return $dl_source; // Should never happen.
1614
+ }
1615
+
1616
+ /**
1617
+ * Retrieve the download URL for a WP repo package.
1618
+ *
1619
+ * @since 2.5.0
1620
+ *
1621
+ * @param string $slug Plugin slug.
1622
+ * @return string Plugin download URL.
1623
+ */
1624
+ protected function get_wp_repo_download_url( $slug ) {
1625
+ $source = '';
1626
+ $api = $this->get_plugins_api( $slug );
1627
+
1628
+ if ( false !== $api && isset( $api->download_link ) ) {
1629
+ $source = $api->download_link;
1630
+ }
1631
+
1632
+ return $source;
1633
+ }
1634
+
1635
+ /**
1636
+ * Try to grab information from WordPress API.
1637
+ *
1638
+ * @since 2.5.0
1639
+ *
1640
+ * @param string $slug Plugin slug.
1641
+ * @return object Plugins_api response object on success, WP_Error on failure.
1642
+ */
1643
+ protected function get_plugins_api( $slug ) {
1644
+ static $api = array(); // Cache received responses.
1645
+
1646
+ if ( ! isset( $api[ $slug ] ) ) {
1647
+ if ( ! function_exists( 'plugins_api' ) ) {
1648
+ require_once ABSPATH . 'wp-admin/includes/plugin-install.php';
1649
+ }
1650
+
1651
+ $response = plugins_api( 'plugin_information', array( 'slug' => $slug, 'fields' => array( 'sections' => false ) ) );
1652
+
1653
+ $api[ $slug ] = false;
1654
+
1655
+ if ( is_wp_error( $response ) ) {
1656
+ wp_die( esc_html( $this->strings['oops'] ) );
1657
+ } else {
1658
+ $api[ $slug ] = $response;
1659
+ }
1660
+ }
1661
+
1662
+ return $api[ $slug ];
1663
+ }
1664
+
1665
+ /**
1666
+ * Retrieve a link to a plugin information page.
1667
+ *
1668
+ * @since 2.5.0
1669
+ *
1670
+ * @param string $slug Plugin slug.
1671
+ * @return string Fully formed html link to a plugin information page if available
1672
+ * or the plugin name if not.
1673
+ */
1674
+ public function get_info_link( $slug ) {
1675
+ if ( ! empty( $this->plugins[ $slug ]['external_url'] ) && preg_match( self::IS_URL_REGEX, $this->plugins[ $slug ]['external_url'] ) ) {
1676
+ $link = sprintf(
1677
+ '<a href="%1$s" target="_blank">%2$s</a>',
1678
+ esc_url( $this->plugins[ $slug ]['external_url'] ),
1679
+ esc_html( $this->plugins[ $slug ]['name'] )
1680
+ );
1681
+ } elseif ( 'repo' === $this->plugins[ $slug ]['source_type'] ) {
1682
+ $url = add_query_arg(
1683
+ array(
1684
+ 'tab' => 'plugin-information',
1685
+ 'plugin' => urlencode( $slug ),
1686
+ 'TB_iframe' => 'true',
1687
+ 'width' => '640',
1688
+ 'height' => '500',
1689
+ ),
1690
+ self_admin_url( 'plugin-install.php' )
1691
+ );
1692
+
1693
+ $link = sprintf(
1694
+ '<a href="%1$s" class="thickbox">%2$s</a>',
1695
+ esc_url( $url ),
1696
+ esc_html( $this->plugins[ $slug ]['name'] )
1697
+ );
1698
+ } else {
1699
+ $link = esc_html( $this->plugins[ $slug ]['name'] ); // No hyperlink.
1700
+ }
1701
+
1702
+ return $link;
1703
+ }
1704
+
1705
+ /**
1706
+ * Determine if we're on the TGMPA Install page.
1707
+ *
1708
+ * @since 2.1.0
1709
+ *
1710
+ * @return boolean True when on the TGMPA page, false otherwise.
1711
+ */
1712
+ protected function is_tgmpa_page() {
1713
+ return isset( $_GET['page'] ) && $this->menu === $_GET['page'];
1714
+ }
1715
+
1716
+ /**
1717
+ * Determine if we're on a WP Core installation/upgrade page.
1718
+ *
1719
+ * @since 2.6.0
1720
+ *
1721
+ * @return boolean True when on a WP Core installation/upgrade page, false otherwise.
1722
+ */
1723
+ protected function is_core_update_page() {
1724
+ // Current screen is not always available, most notably on the customizer screen.
1725
+ if ( ! function_exists( 'get_current_screen' ) ) {
1726
+ return false;
1727
+ }
1728
+
1729
+ $screen = get_current_screen();
1730
+
1731
+ if ( 'update-core' === $screen->base ) {
1732
+ // Core update screen.
1733
+ return true;
1734
+ } elseif ( 'plugins' === $screen->base && ! empty( $_POST['action'] ) ) { // WPCS: CSRF ok.
1735
+ // Plugins bulk update screen.
1736
+ return true;
1737
+ } elseif ( 'update' === $screen->base && ! empty( $_POST['action'] ) ) { // WPCS: CSRF ok.
1738
+ // Individual updates (ajax call).
1739
+ return true;
1740
+ }
1741
+
1742
+ return false;
1743
+ }
1744
+
1745
+ /**
1746
+ * Retrieve the URL to the TGMPA Install page.
1747
+ *
1748
+ * I.e. depending on the config settings passed something along the lines of:
1749
+ * http://example.com/wp-admin/themes.php?page=tgmpa-install-plugins
1750
+ *
1751
+ * @since 2.5.0
1752
+ *
1753
+ * @return string Properly encoded URL (not escaped).
1754
+ */
1755
+ public function get_tgmpa_url() {
1756
+ static $url;
1757
+
1758
+ if ( ! isset( $url ) ) {
1759
+ $parent = $this->parent_slug;
1760
+ if ( false === strpos( $parent, '.php' ) ) {
1761
+ $parent = 'admin.php';
1762
+ }
1763
+ $url = add_query_arg(
1764
+ array(
1765
+ 'page' => urlencode( $this->menu ),
1766
+ ),
1767
+ self_admin_url( $parent )
1768
+ );
1769
+ }
1770
+
1771
+ return $url;
1772
+ }
1773
+
1774
+ /**
1775
+ * Retrieve the URL to the TGMPA Install page for a specific plugin status (view).
1776
+ *
1777
+ * I.e. depending on the config settings passed something along the lines of:
1778
+ * http://example.com/wp-admin/themes.php?page=tgmpa-install-plugins&plugin_status=install
1779
+ *
1780
+ * @since 2.5.0
1781
+ *
1782
+ * @param string $status Plugin status - either 'install', 'update' or 'activate'.
1783
+ * @return string Properly encoded URL (not escaped).
1784
+ */
1785
+ public function get_tgmpa_status_url( $status ) {
1786
+ return add_query_arg(
1787
+ array(
1788
+ 'plugin_status' => urlencode( $status ),
1789
+ ),
1790
+ $this->get_tgmpa_url()
1791
+ );
1792
+ }
1793
+
1794
+ /**
1795
+ * Determine whether there are open actions for plugins registered with TGMPA.
1796
+ *
1797
+ * @since 2.5.0
1798
+ *
1799
+ * @return bool True if complete, i.e. no outstanding actions. False otherwise.
1800
+ */
1801
+ public function is_tgmpa_complete() {
1802
+ $complete = true;
1803
+ foreach ( $this->plugins as $slug => $plugin ) {
1804
+ if ( ! $this->is_plugin_active( $slug ) || false !== $this->does_plugin_have_update( $slug ) ) {
1805
+ $complete = false;
1806
+ break;
1807
+ }
1808
+ }
1809
+
1810
+ return $complete;
1811
+ }
1812
+
1813
+ /**
1814
+ * Check if a plugin is installed. Does not take must-use plugins into account.
1815
+ *
1816
+ * @since 2.5.0
1817
+ *
1818
+ * @param string $slug Plugin slug.
1819
+ * @return bool True if installed, false otherwise.
1820
+ */
1821
+ public function is_plugin_installed( $slug ) {
1822
+ $installed_plugins = $this->get_plugins(); // Retrieve a list of all installed plugins (WP cached).
1823
+
1824
+ return ( ! empty( $installed_plugins[ $this->plugins[ $slug ]['file_path'] ] ) );
1825
+ }
1826
+
1827
+ /**
1828
+ * Check if a plugin is active.
1829
+ *
1830
+ * @since 2.5.0
1831
+ *
1832
+ * @param string $slug Plugin slug.
1833
+ * @return bool True if active, false otherwise.
1834
+ */
1835
+ public function is_plugin_active( $slug ) {
1836
+ return ( ( ! empty( $this->plugins[ $slug ]['is_callable'] ) && is_callable( $this->plugins[ $slug ]['is_callable'] ) ) || is_plugin_active( $this->plugins[ $slug ]['file_path'] ) );
1837
+ }
1838
+
1839
+ /**
1840
+ * Check if a plugin can be updated, i.e. if we have information on the minimum WP version required
1841
+ * available, check whether the current install meets them.
1842
+ *
1843
+ * @since 2.5.0
1844
+ *
1845
+ * @param string $slug Plugin slug.
1846
+ * @return bool True if OK to update, false otherwise.
1847
+ */
1848
+ public function can_plugin_update( $slug ) {
1849
+ // We currently can't get reliable info on non-WP-repo plugins - issue #380.
1850
+ if ( 'repo' !== $this->plugins[ $slug ]['source_type'] ) {
1851
+ return true;
1852
+ }
1853
+
1854
+ $api = $this->get_plugins_api( $slug );
1855
+
1856
+ if ( false !== $api && isset( $api->requires ) ) {
1857
+ return version_compare( $this->wp_version, $api->requires, '>=' );
1858
+ }
1859
+
1860
+ // No usable info received from the plugins API, presume we can update.
1861
+ return true;
1862
+ }
1863
+
1864
+ /**
1865
+ * Check to see if the plugin is 'updatetable', i.e. installed, with an update available
1866
+ * and no WP version requirements blocking it.
1867
+ *
1868
+ * @since 2.6.0
1869
+ *
1870
+ * @param string $slug Plugin slug.
1871
+ * @return bool True if OK to proceed with update, false otherwise.
1872
+ */
1873
+ public function is_plugin_updatetable( $slug ) {
1874
+ if ( ! $this->is_plugin_installed( $slug ) ) {
1875
+ return false;
1876
+ } else {
1877
+ return ( false !== $this->does_plugin_have_update( $slug ) && $this->can_plugin_update( $slug ) );
1878
+ }
1879
+ }
1880
+
1881
+ /**
1882
+ * Check if a plugin can be activated, i.e. is not currently active and meets the minimum
1883
+ * plugin version requirements set in TGMPA (if any).
1884
+ *
1885
+ * @since 2.5.0
1886
+ *
1887
+ * @param string $slug Plugin slug.
1888
+ * @return bool True if OK to activate, false otherwise.
1889
+ */
1890
+ public function can_plugin_activate( $slug ) {
1891
+ return ( ! $this->is_plugin_active( $slug ) && ! $this->does_plugin_require_update( $slug ) );
1892
+ }
1893
+
1894
+ /**
1895
+ * Retrieve the version number of an installed plugin.
1896
+ *
1897
+ * @since 2.5.0
1898
+ *
1899
+ * @param string $slug Plugin slug.
1900
+ * @return string Version number as string or an empty string if the plugin is not installed
1901
+ * or version unknown (plugins which don't comply with the plugin header standard).
1902
+ */
1903
+ public function get_installed_version( $slug ) {
1904
+ $installed_plugins = $this->get_plugins(); // Retrieve a list of all installed plugins (WP cached).
1905
+
1906
+ if ( ! empty( $installed_plugins[ $this->plugins[ $slug ]['file_path'] ]['Version'] ) ) {
1907
+ return $installed_plugins[ $this->plugins[ $slug ]['file_path'] ]['Version'];
1908
+ }
1909
+
1910
+ return '';
1911
+ }
1912
+
1913
+ /**
1914
+ * Check whether a plugin complies with the minimum version requirements.
1915
+ *
1916
+ * @since 2.5.0
1917
+ *
1918
+ * @param string $slug Plugin slug.
1919
+ * @return bool True when a plugin needs to be updated, otherwise false.
1920
+ */
1921
+ public function does_plugin_require_update( $slug ) {
1922
+ $installed_version = $this->get_installed_version( $slug );
1923
+ $minimum_version = $this->plugins[ $slug ]['version'];
1924
+
1925
+ return version_compare( $minimum_version, $installed_version, '>' );
1926
+ }
1927
+
1928
+ /**
1929
+ * Check whether there is an update available for a plugin.
1930
+ *
1931
+ * @since 2.5.0
1932
+ *
1933
+ * @param string $slug Plugin slug.
1934
+ * @return false|string Version number string of the available update or false if no update available.
1935
+ */
1936
+ public function does_plugin_have_update( $slug ) {
1937
+ // Presume bundled and external plugins will point to a package which meets the minimum required version.
1938
+ if ( 'repo' !== $this->plugins[ $slug ]['source_type'] ) {
1939
+ if ( $this->does_plugin_require_update( $slug ) ) {
1940
+ return $this->plugins[ $slug ]['version'];
1941
+ }
1942
+
1943
+ return false;
1944
+ }
1945
+
1946
+ $repo_updates = get_site_transient( 'update_plugins' );
1947
+
1948
+ if ( isset( $repo_updates->response[ $this->plugins[ $slug ]['file_path'] ]->new_version ) ) {
1949
+ return $repo_updates->response[ $this->plugins[ $slug ]['file_path'] ]->new_version;
1950
+ }
1951
+
1952
+ return false;
1953
+ }
1954
+
1955
+ /**
1956
+ * Retrieve potential upgrade notice for a plugin.
1957
+ *
1958
+ * @since 2.5.0
1959
+ *
1960
+ * @param string $slug Plugin slug.
1961
+ * @return string The upgrade notice or an empty string if no message was available or provided.
1962
+ */
1963
+ public function get_upgrade_notice( $slug ) {
1964
+ // We currently can't get reliable info on non-WP-repo plugins - issue #380.
1965
+ if ( 'repo' !== $this->plugins[ $slug ]['source_type'] ) {
1966
+ return '';
1967
+ }
1968
+
1969
+ $repo_updates = get_site_transient( 'update_plugins' );
1970
+
1971
+ if ( ! empty( $repo_updates->response[ $this->plugins[ $slug ]['file_path'] ]->upgrade_notice ) ) {
1972
+ return $repo_updates->response[ $this->plugins[ $slug ]['file_path'] ]->upgrade_notice;
1973
+ }
1974
+
1975
+ return '';
1976
+ }
1977
+
1978
+ /**
1979
+ * Wrapper around the core WP get_plugins function, making sure it's actually available.
1980
+ *
1981
+ * @since 2.5.0
1982
+ *
1983
+ * @param string $plugin_folder Optional. Relative path to single plugin folder.
1984
+ * @return array Array of installed plugins with plugin information.
1985
+ */
1986
+ public function get_plugins( $plugin_folder = '' ) {
1987
+ if ( ! function_exists( 'get_plugins' ) ) {
1988
+ require_once ABSPATH . 'wp-admin/includes/plugin.php';
1989
+ }
1990
+
1991
+ return get_plugins( $plugin_folder );
1992
+ }
1993
+
1994
+ /**
1995
+ * Delete dismissable nag option when theme is switched.
1996
+ *
1997
+ * This ensures that the user(s) is/are again reminded via nag of required
1998
+ * and/or recommended plugins if they re-activate the theme.
1999
+ *
2000
+ * @since 2.1.1
2001
+ */
2002
+ public function update_dismiss() {
2003
+ delete_metadata( 'user', null, 'tgmpa_dismissed_notice_' . $this->id, null, true );
2004
+ }
2005
+
2006
+ /**
2007
+ * Forces plugin activation if the parameter 'force_activation' is
2008
+ * set to true.
2009
+ *
2010
+ * This allows theme authors to specify certain plugins that must be
2011
+ * active at all times while using the current theme.
2012
+ *
2013
+ * Please take special care when using this parameter as it has the
2014
+ * potential to be harmful if not used correctly. Setting this parameter
2015
+ * to true will not allow the specified plugin to be deactivated unless
2016
+ * the user switches themes.
2017
+ *
2018
+ * @since 2.2.0
2019
+ */
2020
+ public function force_activation() {
2021
+ foreach ( $this->plugins as $slug => $plugin ) {
2022
+ if ( true === $plugin['force_activation'] ) {
2023
+ if ( ! $this->is_plugin_installed( $slug ) ) {
2024
+ // Oops, plugin isn't there so iterate to next condition.
2025
+ continue;
2026
+ } elseif ( $this->can_plugin_activate( $slug ) ) {
2027
+ // There we go, activate the plugin.
2028
+ activate_plugin( $plugin['file_path'] );
2029
+ }
2030
+ }
2031
+ }
2032
+ }
2033
+
2034
+ /**
2035
+ * Forces plugin deactivation if the parameter 'force_deactivation'
2036
+ * is set to true and adds the plugin to the 'recently active' plugins list.
2037
+ *
2038
+ * This allows theme authors to specify certain plugins that must be
2039
+ * deactivated upon switching from the current theme to another.
2040
+ *
2041
+ * Please take special care when using this parameter as it has the
2042
+ * potential to be harmful if not used correctly.
2043
+ *
2044
+ * @since 2.2.0
2045
+ */
2046
+ public function force_deactivation() {
2047
+ $deactivated = array();
2048
+
2049
+ foreach ( $this->plugins as $slug => $plugin ) {
2050
+ /*
2051
+ * Only proceed forward if the parameter is set to true and plugin is active
2052
+ * as a 'normal' (not must-use) plugin.
2053
+ */
2054
+ if ( true === $plugin['force_deactivation'] && is_plugin_active( $plugin['file_path'] ) ) {
2055
+ deactivate_plugins( $plugin['file_path'] );
2056
+ $deactivated[ $plugin['file_path'] ] = time();
2057
+ }
2058
+ }
2059
+
2060
+ if ( ! empty( $deactivated ) ) {
2061
+ update_option( 'recently_activated', $deactivated + (array) get_option( 'recently_activated' ) );
2062
+ }
2063
+ }
2064
+
2065
+ /**
2066
+ * Echo the current TGMPA version number to the page.
2067
+ *
2068
+ * @since 2.5.0
2069
+ */
2070
+ public function show_tgmpa_version() {
2071
+ echo '<p style="float: right; padding: 0em 1.5em 0.5em 0;"><strong><small>',
2072
+ esc_html(
2073
+ sprintf(
2074
+ /* translators: %s: version number */
2075
+ __( 'TGMPA v%s', 'tgmpa' ),
2076
+ self::TGMPA_VERSION
2077
+ )
2078
+ ),
2079
+ '</small></strong></p>';
2080
+ }
2081
+
2082
+ /**
2083
+ * Returns the singleton instance of the class.
2084
+ *
2085
+ * @since 2.4.0
2086
+ *
2087
+ * @return \TGM_Plugin_Activation The TGM_Plugin_Activation object.
2088
+ */
2089
+ public static function get_instance() {
2090
+ if ( ! isset( self::$instance ) && ! ( self::$instance instanceof self ) ) {
2091
+ self::$instance = new self();
2092
+ }
2093
+
2094
+ return self::$instance;
2095
+ }
2096
+ }
2097
+
2098
+ if ( ! function_exists( 'load_tgm_plugin_activation' ) ) {
2099
+ /**
2100
+ * Ensure only one instance of the class is ever invoked.
2101
+ *
2102
+ * @since 2.5.0
2103
+ */
2104
+ function load_tgm_plugin_activation() {
2105
+ $GLOBALS['tgmpa'] = TGM_Plugin_Activation::get_instance();
2106
+ }
2107
+ }
2108
+
2109
+ if ( did_action( 'plugins_loaded' ) ) {
2110
+ load_tgm_plugin_activation();
2111
+ } else {
2112
+ add_action( 'plugins_loaded', 'load_tgm_plugin_activation' );
2113
+ }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2114
  }
2115
 
2116
  if ( ! function_exists( 'tgmpa' ) ) {
2117
+ /**
2118
+ * Helper function to register a collection of required plugins.
2119
+ *
2120
+ * @since 2.0.0
2121
+ * @api
2122
+ *
2123
+ * @param array $plugins An array of plugin arrays.
2124
+ * @param array $config Optional. An array of configuration values.
2125
+ */
2126
+ function tgmpa( $plugins, $config = array() ) {
2127
+ $instance = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
2128
+
2129
+ foreach ( $plugins as $plugin ) {
2130
+ call_user_func( array( $instance, 'register' ), $plugin );
2131
+ }
2132
+
2133
+ if ( ! empty( $config ) && is_array( $config ) ) {
2134
+ // Send out notices for deprecated arguments passed.
2135
+ if ( isset( $config['notices'] ) ) {
2136
+ _deprecated_argument( __FUNCTION__, '2.2.0', 'The `notices` config parameter was renamed to `has_notices` in TGMPA 2.2.0. Please adjust your configuration.' );
2137
+ if ( ! isset( $config['has_notices'] ) ) {
2138
+ $config['has_notices'] = $config['notices'];
2139
+ }
2140
+ }
2141
+
2142
+ if ( isset( $config['parent_menu_slug'] ) ) {
2143
+ _deprecated_argument( __FUNCTION__, '2.4.0', 'The `parent_menu_slug` config parameter was removed in TGMPA 2.4.0. In TGMPA 2.5.0 an alternative was (re-)introduced. Please adjust your configuration. For more information visit the website: http://tgmpluginactivation.com/configuration/#h-configuration-options.' );
2144
+ }
2145
+ if ( isset( $config['parent_url_slug'] ) ) {
2146
+ _deprecated_argument( __FUNCTION__, '2.4.0', 'The `parent_url_slug` config parameter was removed in TGMPA 2.4.0. In TGMPA 2.5.0 an alternative was (re-)introduced. Please adjust your configuration. For more information visit the website: http://tgmpluginactivation.com/configuration/#h-configuration-options.' );
2147
+ }
2148
+
2149
+ call_user_func( array( $instance, 'config' ), $config );
2150
+ }
2151
+ }
2152
  }
2153
 
2154
  /**
2158
  * @since 2.2.0
2159
  */
2160
  if ( ! class_exists( 'WP_List_Table' ) ) {
2161
+ require_once ABSPATH . 'wp-admin/includes/class-wp-list-table.php';
2162
  }
2163
 
2164
  if ( ! class_exists( 'TGMPA_List_Table' ) ) {
2165
 
2166
+ /**
2167
+ * List table class for handling plugins.
2168
+ *
2169
+ * Extends the WP_List_Table class to provide a future-compatible
2170
+ * way of listing out all required/recommended plugins.
2171
+ *
2172
+ * Gives users an interface similar to the Plugin Administration
2173
+ * area with similar (albeit stripped down) capabilities.
2174
+ *
2175
+ * This class also allows for the bulk install of plugins.
2176
+ *
2177
+ * @since 2.2.0
2178
+ *
2179
+ * @package TGM-Plugin-Activation
2180
+ * @author Thomas Griffin
2181
+ * @author Gary Jones
2182
+ */
2183
+ class TGMPA_List_Table extends WP_List_Table {
2184
+ /**
2185
+ * TGMPA instance.
2186
+ *
2187
+ * @since 2.5.0
2188
+ *
2189
+ * @var object
2190
+ */
2191
+ protected $tgmpa;
2192
+
2193
+ /**
2194
+ * The currently chosen view.
2195
+ *
2196
+ * @since 2.5.0
2197
+ *
2198
+ * @var string One of: 'all', 'install', 'update', 'activate'
2199
+ */
2200
+ public $view_context = 'all';
2201
+
2202
+ /**
2203
+ * The plugin counts for the various views.
2204
+ *
2205
+ * @since 2.5.0
2206
+ *
2207
+ * @var array
2208
+ */
2209
+ protected $view_totals = array(
2210
+ 'all' => 0,
2211
+ 'install' => 0,
2212
+ 'update' => 0,
2213
+ 'activate' => 0,
2214
+ );
2215
+
2216
+ /**
2217
+ * References parent constructor and sets defaults for class.
2218
+ *
2219
+ * @since 2.2.0
2220
+ */
2221
+ public function __construct() {
2222
+ $this->tgmpa = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
2223
+
2224
+ parent::__construct(
2225
+ array(
2226
+ 'singular' => 'plugin',
2227
+ 'plural' => 'plugins',
2228
+ 'ajax' => false,
2229
+ )
2230
+ );
2231
+
2232
+ if ( isset( $_REQUEST['plugin_status'] ) && in_array( $_REQUEST['plugin_status'], array( 'install', 'update', 'activate' ), true ) ) {
2233
+ $this->view_context = sanitize_key( $_REQUEST['plugin_status'] );
2234
+ }
2235
+
2236
+ add_filter( 'tgmpa_table_data_items', array( $this, 'sort_table_items' ) );
2237
+ }
2238
+
2239
+ /**
2240
+ * Get a list of CSS classes for the <table> tag.
2241
+ *
2242
+ * Overruled to prevent the 'plural' argument from being added.
2243
+ *
2244
+ * @since 2.5.0
2245
+ *
2246
+ * @return array CSS classnames.
2247
+ */
2248
+ public function get_table_classes() {
2249
+ return array( 'widefat', 'fixed' );
2250
+ }
2251
+
2252
+ /**
2253
+ * Gathers and renames all of our plugin information to be used by WP_List_Table to create our table.
2254
+ *
2255
+ * @since 2.2.0
2256
+ *
2257
+ * @return array $table_data Information for use in table.
2258
+ */
2259
+ protected function _gather_plugin_data() {
2260
+ // Load thickbox for plugin links.
2261
+ $this->tgmpa->admin_init();
2262
+ $this->tgmpa->thickbox();
2263
+
2264
+ // Categorize the plugins which have open actions.
2265
+ $plugins = $this->categorize_plugins_to_views();
2266
+
2267
+ // Set the counts for the view links.
2268
+ $this->set_view_totals( $plugins );
2269
+
2270
+ // Prep variables for use and grab list of all installed plugins.
2271
+ $table_data = array();
2272
+ $i = 0;
2273
+
2274
+ // Redirect to the 'all' view if no plugins were found for the selected view context.
2275
+ if ( empty( $plugins[ $this->view_context ] ) ) {
2276
+ $this->view_context = 'all';
2277
+ }
2278
+
2279
+ foreach ( $plugins[ $this->view_context ] as $slug => $plugin ) {
2280
+ $table_data[ $i ]['sanitized_plugin'] = $plugin['name'];
2281
+ $table_data[ $i ]['slug'] = $slug;
2282
+ $table_data[ $i ]['plugin'] = '<strong>' . $this->tgmpa->get_info_link( $slug ) . '</strong>';
2283
+ $table_data[ $i ]['source'] = $this->get_plugin_source_type_text( $plugin['source_type'] );
2284
+ $table_data[ $i ]['type'] = $this->get_plugin_advise_type_text( $plugin['required'] );
2285
+ $table_data[ $i ]['status'] = $this->get_plugin_status_text( $slug );
2286
+ $table_data[ $i ]['installed_version'] = $this->tgmpa->get_installed_version( $slug );
2287
+ $table_data[ $i ]['minimum_version'] = $plugin['version'];
2288
+ $table_data[ $i ]['available_version'] = $this->tgmpa->does_plugin_have_update( $slug );
2289
+
2290
+ // Prep the upgrade notice info.
2291
+ $upgrade_notice = $this->tgmpa->get_upgrade_notice( $slug );
2292
+ if ( ! empty( $upgrade_notice ) ) {
2293
+ $table_data[ $i ]['upgrade_notice'] = $upgrade_notice;
2294
+
2295
+ add_action( "tgmpa_after_plugin_row_{$slug}", array( $this, 'wp_plugin_update_row' ), 10, 2 );
2296
+ }
2297
+
2298
+ $table_data[ $i ] = apply_filters( 'tgmpa_table_data_item', $table_data[ $i ], $plugin );
2299
+
2300
+ $i++;
2301
+ }
2302
+
2303
+ return $table_data;
2304
+ }
2305
+
2306
+ /**
2307
+ * Categorize the plugins which have open actions into views for the TGMPA page.
2308
+ *
2309
+ * @since 2.5.0
2310
+ */
2311
+ protected function categorize_plugins_to_views() {
2312
+ $plugins = array(
2313
+ 'all' => array(), // Meaning: all plugins which still have open actions.
2314
+ 'install' => array(),
2315
+ 'update' => array(),
2316
+ 'activate' => array(),
2317
+ );
2318
+
2319
+ foreach ( $this->tgmpa->plugins as $slug => $plugin ) {
2320
+ if ( $this->tgmpa->is_plugin_active( $slug ) && false === $this->tgmpa->does_plugin_have_update( $slug ) ) {
2321
+ // No need to display plugins if they are installed, up-to-date and active.
2322
+ continue;
2323
+ } else {
2324
+ $plugins['all'][ $slug ] = $plugin;
2325
+
2326
+ if ( ! $this->tgmpa->is_plugin_installed( $slug ) ) {
2327
+ $plugins['install'][ $slug ] = $plugin;
2328
+ } else {
2329
+ if ( false !== $this->tgmpa->does_plugin_have_update( $slug ) ) {
2330
+ $plugins['update'][ $slug ] = $plugin;
2331
+ }
2332
+
2333
+ if ( $this->tgmpa->can_plugin_activate( $slug ) ) {
2334
+ $plugins['activate'][ $slug ] = $plugin;
2335
+ }
2336
+ }
2337
+ }
2338
+ }
2339
+
2340
+ return $plugins;
2341
+ }
2342
+
2343
+ /**
2344
+ * Set the counts for the view links.
2345
+ *
2346
+ * @since 2.5.0
2347
+ *
2348
+ * @param array $plugins Plugins order by view.
2349
+ */
2350
+ protected function set_view_totals( $plugins ) {
2351
+ foreach ( $plugins as $type => $list ) {
2352
+ $this->view_totals[ $type ] = count( $list );
2353
+ }
2354
+ }
2355
+
2356
+ /**
2357
+ * Get the plugin required/recommended text string.
2358
+ *
2359
+ * @since 2.5.0
2360
+ *
2361
+ * @param string $required Plugin required setting.
2362
+ * @return string
2363
+ */
2364
+ protected function get_plugin_advise_type_text( $required ) {
2365
+ if ( true === $required ) {
2366
+ return __( 'Required', 'tgmpa' );
2367
+ }
2368
+
2369
+ return __( 'Recommended', 'tgmpa' );
2370
+ }
2371
+
2372
+ /**
2373
+ * Get the plugin source type text string.
2374
+ *
2375
+ * @since 2.5.0
2376
+ *
2377
+ * @param string $type Plugin type.
2378
+ * @return string
2379
+ */
2380
+ protected function get_plugin_source_type_text( $type ) {
2381
+ $string = '';
2382
+
2383
+ switch ( $type ) {
2384
+ case 'repo':
2385
+ $string = __( 'WordPress Repository', 'tgmpa' );
2386
+ break;
2387
+ case 'external':
2388
+ $string = __( 'External Source', 'tgmpa' );
2389
+ break;
2390
+ case 'bundled':
2391
+ $string = __( 'Pre-Packaged', 'tgmpa' );
2392
+ break;
2393
+ }
2394
+
2395
+ return $string;
2396
+ }
2397
+
2398
+ /**
2399
+ * Determine the plugin status message.
2400
+ *
2401
+ * @since 2.5.0
2402
+ *
2403
+ * @param string $slug Plugin slug.
2404
+ * @return string
2405
+ */
2406
+ protected function get_plugin_status_text( $slug ) {
2407
+ if ( ! $this->tgmpa->is_plugin_installed( $slug ) ) {
2408
+ return __( 'Not Installed', 'tgmpa' );
2409
+ }
2410
+
2411
+ if ( ! $this->tgmpa->is_plugin_active( $slug ) ) {
2412
+ $install_status = __( 'Installed But Not Activated', 'tgmpa' );
2413
+ } else {
2414
+ $install_status = __( 'Active', 'tgmpa' );
2415
+ }
2416
+
2417
+ $update_status = '';
2418
+
2419
+ if ( $this->tgmpa->does_plugin_require_update( $slug ) && false === $this->tgmpa->does_plugin_have_update( $slug ) ) {
2420
+ $update_status = __( 'Required Update not Available', 'tgmpa' );
2421
+
2422
+ } elseif ( $this->tgmpa->does_plugin_require_update( $slug ) ) {
2423
+ $update_status = __( 'Requires Update', 'tgmpa' );
2424
+
2425
+ } elseif ( false !== $this->tgmpa->does_plugin_have_update( $slug ) ) {
2426
+ $update_status = __( 'Update recommended', 'tgmpa' );
2427
+ }
2428
+
2429
+ if ( '' === $update_status ) {
2430
+ return $install_status;
2431
+ }
2432
+
2433
+ return sprintf(
2434
+ /* translators: 1: install status, 2: update status */
2435
+ _x( '%1$s, %2$s', 'Install/Update Status', 'tgmpa' ),
2436
+ $install_status,
2437
+ $update_status
2438
+ );
2439
+ }
2440
+
2441
+ /**
2442
+ * Sort plugins by Required/Recommended type and by alphabetical plugin name within each type.
2443
+ *
2444
+ * @since 2.5.0
2445
+ *
2446
+ * @param array $items Prepared table items.
2447
+ * @return array Sorted table items.
2448
+ */
2449
+ public function sort_table_items( $items ) {
2450
+ $type = array();
2451
+ $name = array();
2452
+
2453
+ foreach ( $items as $i => $plugin ) {
2454
+ $type[ $i ] = $plugin['type']; // Required / recommended.
2455
+ $name[ $i ] = $plugin['sanitized_plugin'];
2456
+ }
2457
+
2458
+ array_multisort( $type, SORT_DESC, $name, SORT_ASC, $items );
2459
+
2460
+ return $items;
2461
+ }
2462
+
2463
+ /**
2464
+ * Get an associative array ( id => link ) of the views available on this table.
2465
+ *
2466
+ * @since 2.5.0
2467
+ *
2468
+ * @return array
2469
+ */
2470
+ public function get_views() {
2471
+ $status_links = array();
2472
+
2473
+ foreach ( $this->view_totals as $type => $count ) {
2474
+ if ( $count < 1 ) {
2475
+ continue;
2476
+ }
2477
+
2478
+ switch ( $type ) {
2479
+ case 'all':
2480
+ /* translators: 1: number of plugins. */
2481
+ $text = _nx( 'All <span class="count">(%s)</span>', 'All <span class="count">(%s)</span>', $count, 'plugins', 'tgmpa' );
2482
+ break;
2483
+ case 'install':
2484
+ /* translators: 1: number of plugins. */
2485
+ $text = _n( 'To Install <span class="count">(%s)</span>', 'To Install <span class="count">(%s)</span>', $count, 'tgmpa' );
2486
+ break;
2487
+ case 'update':
2488
+ /* translators: 1: number of plugins. */
2489
+ $text = _n( 'Update Available <span class="count">(%s)</span>', 'Update Available <span class="count">(%s)</span>', $count, 'tgmpa' );
2490
+ break;
2491
+ case 'activate':
2492
+ /* translators: 1: number of plugins. */
2493
+ $text = _n( 'To Activate <span class="count">(%s)</span>', 'To Activate <span class="count">(%s)</span>', $count, 'tgmpa' );
2494
+ break;
2495
+ default:
2496
+ $text = '';
2497
+ break;
2498
+ }
2499
+
2500
+ if ( ! empty( $text ) ) {
2501
+
2502
+ $status_links[ $type ] = sprintf(
2503
+ '<a href="%s"%s>%s</a>',
2504
+ esc_url( $this->tgmpa->get_tgmpa_status_url( $type ) ),
2505
+ ( $type === $this->view_context ) ? ' class="current"' : '',
2506
+ sprintf( $text, number_format_i18n( $count ) )
2507
+ );
2508
+ }
2509
+ }
2510
+
2511
+ return $status_links;
2512
+ }
2513
+
2514
+ /**
2515
+ * Create default columns to display important plugin information
2516
+ * like type, action and status.
2517
+ *
2518
+ * @since 2.2.0
2519
+ *
2520
+ * @param array $item Array of item data.
2521
+ * @param string $column_name The name of the column.
2522
+ * @return string
2523
+ */
2524
+ public function column_default( $item, $column_name ) {
2525
+ return $item[ $column_name ];
2526
+ }
2527
+
2528
+ /**
2529
+ * Required for bulk installing.
2530
+ *
2531
+ * Adds a checkbox for each plugin.
2532
+ *
2533
+ * @since 2.2.0
2534
+ *
2535
+ * @param array $item Array of item data.
2536
+ * @return string The input checkbox with all necessary info.
2537
+ */
2538
+ public function column_cb( $item ) {
2539
+ return sprintf(
2540
+ '<input type="checkbox" name="%1$s[]" value="%2$s" id="%3$s" />',
2541
+ esc_attr( $this->_args['singular'] ),
2542
+ esc_attr( $item['slug'] ),
2543
+ esc_attr( $item['sanitized_plugin'] )
2544
+ );
2545
+ }
2546
+
2547
+ /**
2548
+ * Create default title column along with the action links.
2549
+ *
2550
+ * @since 2.2.0
2551
+ *
2552
+ * @param array $item Array of item data.
2553
+ * @return string The plugin name and action links.
2554
+ */
2555
+ public function column_plugin( $item ) {
2556
+ return sprintf(
2557
+ '%1$s %2$s',
2558
+ $item['plugin'],
2559
+ $this->row_actions( $this->get_row_actions( $item ), true )
2560
+ );
2561
+ }
2562
+
2563
+ /**
2564
+ * Create version information column.
2565
+ *
2566
+ * @since 2.5.0
2567
+ *
2568
+ * @param array $item Array of item data.
2569
+ * @return string HTML-formatted version information.
2570
+ */
2571
+ public function column_version( $item ) {
2572
+ $output = array();
2573
+
2574
+ if ( $this->tgmpa->is_plugin_installed( $item['slug'] ) ) {
2575
+ $installed = ! empty( $item['installed_version'] ) ? $item['installed_version'] : _x( 'unknown', 'as in: "version nr unknown"', 'tgmpa' );
2576
+
2577
+ $color = '';
2578
+ if ( ! empty( $item['minimum_version'] ) && $this->tgmpa->does_plugin_require_update( $item['slug'] ) ) {
2579
+ $color = ' color: #ff0000; font-weight: bold;';
2580
+ }
2581
+
2582
+ $output[] = sprintf(
2583
+ '<p><span style="min-width: 32px; text-align: right; float: right;%1$s">%2$s</span>' . __( 'Installed version:', 'tgmpa' ) . '</p>',
2584
+ $color,
2585
+ $installed
2586
+ );
2587
+ }
2588
+
2589
+ if ( ! empty( $item['minimum_version'] ) ) {
2590
+ $output[] = sprintf(
2591
+ '<p><span style="min-width: 32px; text-align: right; float: right;">%1$s</span>' . __( 'Minimum required version:', 'tgmpa' ) . '</p>',
2592
+ $item['minimum_version']
2593
+ );
2594
+ }
2595
+
2596
+ if ( ! empty( $item['available_version'] ) ) {
2597
+ $color = '';
2598
+ if ( ! empty( $item['minimum_version'] ) && version_compare( $item['available_version'], $item['minimum_version'], '>=' ) ) {
2599
+ $color = ' color: #71C671; font-weight: bold;';
2600
+ }
2601
+
2602
+ $output[] = sprintf(
2603
+ '<p><span style="min-width: 32px; text-align: right; float: right;%1$s">%2$s</span>' . __( 'Available version:', 'tgmpa' ) . '</p>',
2604
+ $color,
2605
+ $item['available_version']
2606
+ );
2607
+ }
2608
+
2609
+ if ( empty( $output ) ) {
2610
+ return '&nbsp;'; // Let's not break the table layout.
2611
+ } else {
2612
+ return implode( "\n", $output );
2613
+ }
2614
+ }
2615
+
2616
+ /**
2617
+ * Sets default message within the plugins table if no plugins
2618
+ * are left for interaction.
2619
+ *
2620
+ * Hides the menu item to prevent the user from clicking and
2621
+ * getting a permissions error.
2622
+ *
2623
+ * @since 2.2.0
2624
+ */
2625
+ public function no_items() {
2626
+ echo esc_html__( 'No plugins to install, update or activate.', 'tgmpa' ) . ' <a href="' . esc_url( self_admin_url() ) . '"> ' . esc_html__( 'Return to the Dashboard', 'tgmpa' ) . '</a>';
2627
+ echo '<style type="text/css">#adminmenu .wp-submenu li.current { display: none !important; }</style>';
2628
+ }
2629
+
2630
+ /**
2631
+ * Output all the column information within the table.
2632
+ *
2633
+ * @since 2.2.0
2634
+ *
2635
+ * @return array $columns The column names.
2636
+ */
2637
+ public function get_columns() {
2638
+ $columns = array(
2639
+ 'cb' => '<input type="checkbox" />',
2640
+ 'plugin' => __( 'Plugin', 'tgmpa' ),
2641
+ 'source' => __( 'Source', 'tgmpa' ),
2642
+ 'type' => __( 'Type', 'tgmpa' ),
2643
+ );
2644
+
2645
+ if ( 'all' === $this->view_context || 'update' === $this->view_context ) {
2646
+ $columns['version'] = __( 'Version', 'tgmpa' );
2647
+ $columns['status'] = __( 'Status', 'tgmpa' );
2648
+ }
2649
+
2650
+ return apply_filters( 'tgmpa_table_columns', $columns );
2651
+ }
2652
+
2653
+ /**
2654
+ * Get name of default primary column
2655
+ *
2656
+ * @since 2.5.0 / WP 4.3+ compatibility
2657
+ * @access protected
2658
+ *
2659
+ * @return string
2660
+ */
2661
+ protected function get_default_primary_column_name() {
2662
+ return 'plugin';
2663
+ }
2664
+
2665
+ /**
2666
+ * Get the name of the primary column.
2667
+ *
2668
+ * @since 2.5.0 / WP 4.3+ compatibility
2669
+ * @access protected
2670
+ *
2671
+ * @return string The name of the primary column.
2672
+ */
2673
+ protected function get_primary_column_name() {
2674
+ if ( method_exists( 'WP_List_Table', 'get_primary_column_name' ) ) {
2675
+ return parent::get_primary_column_name();
2676
+ } else {
2677
+ return $this->get_default_primary_column_name();
2678
+ }
2679
+ }
2680
+
2681
+ /**
2682
+ * Get the actions which are relevant for a specific plugin row.
2683
+ *
2684
+ * @since 2.5.0
2685
+ *
2686
+ * @param array $item Array of item data.
2687
+ * @return array Array with relevant action links.
2688
+ */
2689
+ protected function get_row_actions( $item ) {
2690
+ $actions = array();
2691
+ $action_links = array();
2692
+
2693
+ // Display the 'Install' action link if the plugin is not yet available.
2694
+ if ( ! $this->tgmpa->is_plugin_installed( $item['slug'] ) ) {
2695
+ /* translators: %2$s: plugin name in screen reader markup */
2696
+ $actions['install'] = __( 'Install %2$s', 'tgmpa' );
2697
+ } else {
2698
+ // Display the 'Update' action link if an update is available and WP complies with plugin minimum.
2699
+ if ( false !== $this->tgmpa->does_plugin_have_update( $item['slug'] ) && $this->tgmpa->can_plugin_update( $item['slug'] ) ) {
2700
+ /* translators: %2$s: plugin name in screen reader markup */
2701
+ $actions['update'] = __( 'Update %2$s', 'tgmpa' );
2702
+ }
2703
+
2704
+ // Display the 'Activate' action link, but only if the plugin meets the minimum version.
2705
+ if ( $this->tgmpa->can_plugin_activate( $item['slug'] ) ) {
2706
+ /* translators: %2$s: plugin name in screen reader markup */
2707
+ $actions['activate'] = __( 'Activate %2$s', 'tgmpa' );
2708
+ }
2709
+ }
2710
+
2711
+ // Create the actual links.
2712
+ foreach ( $actions as $action => $text ) {
2713
+ $nonce_url = wp_nonce_url(
2714
+ add_query_arg(
2715
+ array(
2716
+ 'plugin' => urlencode( $item['slug'] ),
2717
+ 'tgmpa-' . $action => $action . '-plugin',
2718
+ ),
2719
+ $this->tgmpa->get_tgmpa_url()
2720
+ ),
2721
+ 'tgmpa-' . $action,
2722
+ 'tgmpa-nonce'
2723
+ );
2724
+
2725
+ $action_links[ $action ] = sprintf(
2726
+ '<a href="%1$s">' . esc_html( $text ) . '</a>', // $text contains the second placeholder.
2727
+ esc_url( $nonce_url ),
2728
+ '<span class="screen-reader-text">' . esc_html( $item['sanitized_plugin'] ) . '</span>'
2729
+ );
2730
+ }
2731
+
2732
+ $prefix = ( defined( 'WP_NETWORK_ADMIN' ) && WP_NETWORK_ADMIN ) ? 'network_admin_' : '';
2733
+ return apply_filters( "tgmpa_{$prefix}plugin_action_links", array_filter( $action_links ), $item['slug'], $item, $this->view_context );
2734
+ }
2735
+
2736
+ /**
2737
+ * Generates content for a single row of the table.
2738
+ *
2739
+ * @since 2.5.0
2740
+ *
2741
+ * @param object $item The current item.
2742
+ */
2743
+ public function single_row( $item ) {
2744
+ parent::single_row( $item );
2745
+
2746
+ /**
2747
+ * Fires after each specific row in the TGMPA Plugins list table.
2748
+ *
2749
+ * The dynamic portion of the hook name, `$item['slug']`, refers to the slug
2750
+ * for the plugin.
2751
+ *
2752
+ * @since 2.5.0
2753
+ */
2754
+ do_action( "tgmpa_after_plugin_row_{$item['slug']}", $item['slug'], $item, $this->view_context );
2755
+ }
2756
+
2757
+ /**
2758
+ * Show the upgrade notice below a plugin row if there is one.
2759
+ *
2760
+ * @since 2.5.0
2761
+ *
2762
+ * @see /wp-admin/includes/update.php
2763
+ *
2764
+ * @param string $slug Plugin slug.
2765
+ * @param array $item The information available in this table row.
2766
+ * @return null Return early if upgrade notice is empty.
2767
+ */
2768
+ public function wp_plugin_update_row( $slug, $item ) {
2769
+ if ( empty( $item['upgrade_notice'] ) ) {
2770
+ return;
2771
+ }
2772
+
2773
+ echo '
2774
+ <tr class="plugin-update-tr">
2775
+ <td colspan="', absint( $this->get_column_count() ), '" class="plugin-update colspanchange">
2776
+ <div class="update-message">',
2777
+ esc_html__( 'Upgrade message from the plugin author:', 'tgmpa' ),
2778
+ ' <strong>', wp_kses_data( $item['upgrade_notice'] ), '</strong>
2779
+ </div>
2780
+ </td>
2781
+ </tr>';
2782
+ }
2783
+
2784
+ /**
2785
+ * Extra controls to be displayed between bulk actions and pagination.
2786
+ *
2787
+ * @since 2.5.0
2788
+ *
2789
+ * @param string $which 'top' or 'bottom' table navigation.
2790
+ */
2791
+ public function extra_tablenav( $which ) {
2792
+ if ( 'bottom' === $which ) {
2793
+ $this->tgmpa->show_tgmpa_version();
2794
+ }
2795
+ }
2796
+
2797
+ /**
2798
+ * Defines the bulk actions for handling registered plugins.
2799
+ *
2800
+ * @since 2.2.0
2801
+ *
2802
+ * @return array $actions The bulk actions for the plugin install table.
2803
+ */
2804
+ public function get_bulk_actions() {
2805
+
2806
+ $actions = array();
2807
+
2808
+ if ( 'update' !== $this->view_context && 'activate' !== $this->view_context ) {
2809
+ if ( current_user_can( 'install_plugins' ) ) {
2810
+ $actions['tgmpa-bulk-install'] = __( 'Install', 'tgmpa' );
2811
+ }
2812
+ }
2813
+
2814
+ if ( 'install' !== $this->view_context ) {
2815
+ if ( current_user_can( 'update_plugins' ) ) {
2816
+ $actions['tgmpa-bulk-update'] = __( 'Update', 'tgmpa' );
2817
+ }
2818
+ if ( current_user_can( 'activate_plugins' ) ) {
2819
+ $actions['tgmpa-bulk-activate'] = __( 'Activate', 'tgmpa' );
2820
+ }
2821
+ }
2822
+
2823
+ return $actions;
2824
+ }
2825
+
2826
+ /**
2827
+ * Processes bulk installation and activation actions.
2828
+ *
2829
+ * The bulk installation process looks for the $_POST information and passes that
2830
+ * through if a user has to use WP_Filesystem to enter their credentials.
2831
+ *
2832
+ * @since 2.2.0
2833
+ */
2834
+ public function process_bulk_actions() {
2835
+ // Bulk installation process.
2836
+ if ( 'tgmpa-bulk-install' === $this->current_action() || 'tgmpa-bulk-update' === $this->current_action() ) {
2837
+
2838
+ check_admin_referer( 'bulk-' . $this->_args['plural'] );
2839
+
2840
+ $install_type = 'install';
2841
+ if ( 'tgmpa-bulk-update' === $this->current_action() ) {
2842
+ $install_type = 'update';
2843
+ }
2844
+
2845
+ $plugins_to_install = array();
2846
+
2847
+ // Did user actually select any plugins to install/update ?
2848
+ if ( empty( $_POST['plugin'] ) ) {
2849
+ if ( 'install' === $install_type ) {
2850
+ $message = __( 'No plugins were selected to be installed. No action taken.', 'tgmpa' );
2851
+ } else {
2852
+ $message = __( 'No plugins were selected to be updated. No action taken.', 'tgmpa' );
2853
+ }
2854
+
2855
+ echo '<div id="message" class="error"><p>', esc_html( $message ), '</p></div>';
2856
+
2857
+ return false;
2858
+ }
2859
+
2860
+ if ( is_array( $_POST['plugin'] ) ) {
2861
+ $plugins_to_install = (array) $_POST['plugin'];
2862
+ } elseif ( is_string( $_POST['plugin'] ) ) {
2863
+ // Received via Filesystem page - un-flatten array (WP bug #19643).
2864
+ $plugins_to_install = explode( ',', $_POST['plugin'] );
2865
+ }
2866
+
2867
+ // Sanitize the received input.
2868
+ $plugins_to_install = array_map( 'urldecode', $plugins_to_install );
2869
+ $plugins_to_install = array_map( array( $this->tgmpa, 'sanitize_key' ), $plugins_to_install );
2870
+
2871
+ // Validate the received input.
2872
+ foreach ( $plugins_to_install as $key => $slug ) {
2873
+ // Check if the plugin was registered with TGMPA and remove if not.
2874
+ if ( ! isset( $this->tgmpa->plugins[ $slug ] ) ) {
2875
+ unset( $plugins_to_install[ $key ] );
2876
+ continue;
2877
+ }
2878
+
2879
+ // For install: make sure this is a plugin we *can* install and not one already installed.
2880
+ if ( 'install' === $install_type && true === $this->tgmpa->is_plugin_installed( $slug ) ) {
2881
+ unset( $plugins_to_install[ $key ] );
2882
+ }
2883
+
2884
+ // For updates: make sure this is a plugin we *can* update (update available and WP version ok).
2885
+ if ( 'update' === $install_type && false === $this->tgmpa->is_plugin_updatetable( $slug ) ) {
2886
+ unset( $plugins_to_install[ $key ] );
2887
+ }
2888
+ }
2889
+
2890
+ // No need to proceed further if we have no plugins to handle.
2891
+ if ( empty( $plugins_to_install ) ) {
2892
+ if ( 'install' === $install_type ) {
2893
+ $message = __( 'No plugins are available to be installed at this time.', 'tgmpa' );
2894
+ } else {
2895
+ $message = __( 'No plugins are available to be updated at this time.', 'tgmpa' );
2896
+ }
2897
+
2898
+ echo '<div id="message" class="error"><p>', esc_html( $message ), '</p></div>';
2899
+
2900
+ return false;
2901
+ }
2902
+
2903
+ // Pass all necessary information if WP_Filesystem is needed.
2904
+ $url = wp_nonce_url(
2905
+ $this->tgmpa->get_tgmpa_url(),
2906
+ 'bulk-' . $this->_args['plural']
2907
+ );
2908
+
2909
+ // Give validated data back to $_POST which is the only place the filesystem looks for extra fields.
2910
+ $_POST['plugin'] = implode( ',', $plugins_to_install ); // Work around for WP bug #19643.
2911
+
2912
+ $method = ''; // Leave blank so WP_Filesystem can populate it as necessary.
2913
+ $fields = array_keys( $_POST ); // Extra fields to pass to WP_Filesystem.
2914
+
2915
+ if ( false === ( $creds = request_filesystem_credentials( esc_url_raw( $url ), $method, false, false, $fields ) ) ) {
2916
+ return true; // Stop the normal page form from displaying, credential request form will be shown.
2917
+ }
2918
+
2919
+ // Now we have some credentials, setup WP_Filesystem.
2920
+ if ( ! WP_Filesystem( $creds ) ) {
2921
+ // Our credentials were no good, ask the user for them again.
2922
+ request_filesystem_credentials( esc_url_raw( $url ), $method, true, false, $fields );
2923
+
2924
+ return true;
2925
+ }
2926
+
2927
+ /* If we arrive here, we have the filesystem */
2928
+
2929
+ // Store all information in arrays since we are processing a bulk installation.
2930
+ $names = array();
2931
+ $sources = array(); // Needed for installs.
2932
+ $file_paths = array(); // Needed for upgrades.
2933
+ $to_inject = array(); // Information to inject into the update_plugins transient.
2934
+
2935
+ // Prepare the data for validated plugins for the install/upgrade.
2936
+ foreach ( $plugins_to_install as $slug ) {
2937
+ $name = $this->tgmpa->plugins[ $slug ]['name'];
2938
+ $source = $this->tgmpa->get_download_url( $slug );
2939
+
2940
+ if ( ! empty( $name ) && ! empty( $source ) ) {
2941
+ $names[] = $name;
2942
+
2943
+ switch ( $install_type ) {
2944
+
2945
+ case 'install':
2946
+ $sources[] = $source;
2947
+ break;
2948
+
2949
+ case 'update':
2950
+ $file_paths[] = $this->tgmpa->plugins[ $slug ]['file_path'];
2951
+ $to_inject[ $slug ] = $this->tgmpa->plugins[ $slug ];
2952
+ $to_inject[ $slug ]['source'] = $source;
2953
+ break;
2954
+ }
2955
+ }
2956
+ }
2957
+ unset( $slug, $name, $source );
2958
+
2959
+ // Create a new instance of TGMPA_Bulk_Installer.
2960
+ $installer = new TGMPA_Bulk_Installer(
2961
+ new TGMPA_Bulk_Installer_Skin(
2962
+ array(
2963
+ 'url' => esc_url_raw( $this->tgmpa->get_tgmpa_url() ),
2964
+ 'nonce' => 'bulk-' . $this->_args['plural'],
2965
+ 'names' => $names,
2966
+ 'install_type' => $install_type,
2967
+ )
2968
+ )
2969
+ );
2970
+
2971
+ // Wrap the install process with the appropriate HTML.
2972
+ echo '<div class="tgmpa">',
2973
+ '<h2 style="font-size: 23px; font-weight: 400; line-height: 29px; margin: 0; padding: 9px 15px 4px 0;">', esc_html( get_admin_page_title() ), '</h2>
2974
+ <div class="update-php" style="width: 100%; height: 98%; min-height: 850px; padding-top: 1px;">';
2975
+
2976
+ // Process the bulk installation submissions.
2977
+ add_filter( 'upgrader_source_selection', array( $this->tgmpa, 'maybe_adjust_source_dir' ), 1, 3 );
2978
+
2979
+ if ( 'tgmpa-bulk-update' === $this->current_action() ) {
2980
+ // Inject our info into the update transient.
2981
+ $this->tgmpa->inject_update_info( $to_inject );
2982
+
2983
+ $installer->bulk_upgrade( $file_paths );
2984
+ } else {
2985
+ $installer->bulk_install( $sources );
2986
+ }
2987
+
2988
+ remove_filter( 'upgrader_source_selection', array( $this->tgmpa, 'maybe_adjust_source_dir' ), 1 );
2989
+
2990
+ echo '</div></div>';
2991
+
2992
+ return true;
2993
+ }
2994
+
2995
+ // Bulk activation process.
2996
+ if ( 'tgmpa-bulk-activate' === $this->current_action() ) {
2997
+ check_admin_referer( 'bulk-' . $this->_args['plural'] );
2998
+
2999
+ // Did user actually select any plugins to activate ?
3000
+ if ( empty( $_POST['plugin'] ) ) {
3001
+ echo '<div id="message" class="error"><p>', esc_html__( 'No plugins were selected to be activated. No action taken.', 'tgmpa' ), '</p></div>';
3002
+
3003
+ return false;
3004
+ }
3005
+
3006
+ // Grab plugin data from $_POST.
3007
+ $plugins = array();
3008
+ if ( isset( $_POST['plugin'] ) ) {
3009
+ $plugins = array_map( 'urldecode', (array) $_POST['plugin'] );
3010
+ $plugins = array_map( array( $this->tgmpa, 'sanitize_key' ), $plugins );
3011
+ }
3012
+
3013
+ $plugins_to_activate = array();
3014
+ $plugin_names = array();
3015
+
3016
+ // Grab the file paths for the selected & inactive plugins from the registration array.
3017
+ foreach ( $plugins as $slug ) {
3018
+ if ( $this->tgmpa->can_plugin_activate( $slug ) ) {
3019
+ $plugins_to_activate[] = $this->tgmpa->plugins[ $slug ]['file_path'];
3020
+ $plugin_names[] = $this->tgmpa->plugins[ $slug ]['name'];
3021
+ }
3022
+ }
3023
+ unset( $slug );
3024
+
3025
+ // Return early if there are no plugins to activate.
3026
+ if ( empty( $plugins_to_activate ) ) {
3027
+ echo '<div id="message" class="error"><p>', esc_html__( 'No plugins are available to be activated at this time.', 'tgmpa' ), '</p></div>';
3028
+
3029
+ return false;
3030
+ }
3031
+
3032
+ // Now we are good to go - let's start activating plugins.
3033
+ $activate = activate_plugins( $plugins_to_activate );
3034
+
3035
+ if ( is_wp_error( $activate ) ) {
3036
+ echo '<div id="message" class="error"><p>', wp_kses_post( $activate->get_error_message() ), '</p></div>';
3037
+ } else {
3038
+ $count = count( $plugin_names ); // Count so we can use _n function.
3039
+ $plugin_names = array_map( array( 'TGMPA_Utils', 'wrap_in_strong' ), $plugin_names );
3040
+ $last_plugin = array_pop( $plugin_names ); // Pop off last name to prep for readability.
3041
+ $imploded = empty( $plugin_names ) ? $last_plugin : ( implode( ', ', $plugin_names ) . ' ' . esc_html_x( 'and', 'plugin A *and* plugin B', 'tgmpa' ) . ' ' . $last_plugin );
3042
+
3043
+ printf( // WPCS: xss ok.
3044
+ '<div id="message" class="updated"><p>%1$s %2$s.</p></div>',
3045
+ esc_html( _n( 'The following plugin was activated successfully:', 'The following plugins were activated successfully:', $count, 'tgmpa' ) ),
3046
+ $imploded
3047
+ );
3048
+
3049
+ // Update recently activated plugins option.
3050
+ $recent = (array) get_option( 'recently_activated' );
3051
+ foreach ( $plugins_to_activate as $plugin => $time ) {
3052
+ if ( isset( $recent[ $plugin ] ) ) {
3053
+ unset( $recent[ $plugin ] );
3054
+ }
3055
+ }
3056
+ update_option( 'recently_activated', $recent );
3057
+ }
3058
+
3059
+ unset( $_POST ); // Reset the $_POST variable in case user wants to perform one action after another.
3060
+
3061
+ return true;
3062
+ }
3063
+
3064
+ return false;
3065
+ }
3066
+
3067
+ /**
3068
+ * Prepares all of our information to be outputted into a usable table.
3069
+ *
3070
+ * @since 2.2.0
3071
+ */
3072
+ public function prepare_items() {
3073
+ $columns = $this->get_columns(); // Get all necessary column information.
3074
+ $hidden = array(); // No columns to hide, but we must set as an array.
3075
+ $sortable = array(); // No reason to make sortable columns.
3076
+ $primary = $this->get_primary_column_name(); // Column which has the row actions.
3077
+ $this->_column_headers = array( $columns, $hidden, $sortable, $primary ); // Get all necessary column headers.
3078
+
3079
+ // Process our bulk activations here.
3080
+ if ( 'tgmpa-bulk-activate' === $this->current_action() ) {
3081
+ $this->process_bulk_actions();
3082
+ }
3083
+
3084
+ // Store all of our plugin data into $items array so WP_List_Table can use it.
3085
+ $this->items = apply_filters( 'tgmpa_table_data_items', $this->_gather_plugin_data() );
3086
+ }
3087
+
3088
+ /* *********** DEPRECATED METHODS *********** */
3089
+
3090
+ /**
3091
+ * Retrieve plugin data, given the plugin name.
3092
+ *
3093
+ * @since 2.2.0
3094
+ * @deprecated 2.5.0 use {@see TGM_Plugin_Activation::_get_plugin_data_from_name()} instead.
3095
+ * @see TGM_Plugin_Activation::_get_plugin_data_from_name()
3096
+ *
3097
+ * @param string $name Name of the plugin, as it was registered.
3098
+ * @param string $data Optional. Array key of plugin data to return. Default is slug.
3099
+ * @return string|boolean Plugin slug if found, false otherwise.
3100
+ */
3101
+ protected function _get_plugin_data_from_name( $name, $data = 'slug' ) {
3102
+ _deprecated_function( __FUNCTION__, 'TGMPA 2.5.0', 'TGM_Plugin_Activation::_get_plugin_data_from_name()' );
3103
+
3104
+ return $this->tgmpa->_get_plugin_data_from_name( $name, $data );
3105
+ }
3106
+ }
3107
  }
3108
 
3109
 
3110
  if ( ! class_exists( 'TGM_Bulk_Installer' ) ) {
3111
 
3112
+ /**
3113
+ * Hack: Prevent TGMPA v2.4.1- bulk installer class from being loaded if 2.4.1- is loaded after 2.5+.
3114
+ *
3115
+ * @since 2.5.2
3116
+ *
3117
+ * {@internal The TGMPA_Bulk_Installer class was originally called TGM_Bulk_Installer.
3118
+ * For more information, see that class.}}
3119
+ */
3120
+ class TGM_Bulk_Installer {
3121
+ }
3122
  }
3123
  if ( ! class_exists( 'TGM_Bulk_Installer_Skin' ) ) {
3124
 
3125
+ /**
3126
+ * Hack: Prevent TGMPA v2.4.1- bulk installer skin class from being loaded if 2.4.1- is loaded after 2.5+.
3127
+ *
3128
+ * @since 2.5.2
3129
+ *
3130
+ * {@internal The TGMPA_Bulk_Installer_Skin class was originally called TGM_Bulk_Installer_Skin.
3131
+ * For more information, see that class.}}
3132
+ */
3133
+ class TGM_Bulk_Installer_Skin {
3134
+ }
3135
  }
3136
 
3137
  /**
3146
  */
3147
  add_action( 'admin_init', 'tgmpa_load_bulk_installer' );
3148
  if ( ! function_exists( 'tgmpa_load_bulk_installer' ) ) {
3149
+ /**
3150
+ * Load bulk installer
3151
+ */
3152
+ function tgmpa_load_bulk_installer() {
3153
+ // Silently fail if 2.5+ is loaded *after* an older version.
3154
+ if ( ! isset( $GLOBALS['tgmpa'] ) ) {
3155
+ return;
3156
+ }
3157
+
3158
+ // Get TGMPA class instance.
3159
+ $tgmpa_instance = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
3160
+
3161
+ if ( isset( $_GET['page'] ) && $tgmpa_instance->menu === $_GET['page'] ) {
3162
+ if ( ! class_exists( 'Plugin_Upgrader', false ) ) {
3163
+ require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
3164
+ }
3165
+
3166
+ if ( ! class_exists( 'TGMPA_Bulk_Installer' ) ) {
3167
+
3168
+ /**
3169
+ * Installer class to handle bulk plugin installations.
3170
+ *
3171
+ * Extends WP_Upgrader and customizes to suit the installation of multiple
3172
+ * plugins.
3173
+ *
3174
+ * @since 2.2.0
3175
+ *
3176
+ * {@internal Since 2.5.0 the class is an extension of Plugin_Upgrader rather than WP_Upgrader.}}
3177
+ * {@internal Since 2.5.2 the class has been renamed from TGM_Bulk_Installer to TGMPA_Bulk_Installer.
3178
+ * This was done to prevent backward compatibility issues with v2.3.6.}}
3179
+ *
3180
+ * @package TGM-Plugin-Activation
3181
+ * @author Thomas Griffin
3182
+ * @author Gary Jones
3183
+ */
3184
+ class TGMPA_Bulk_Installer extends Plugin_Upgrader {
3185
+ /**
3186
+ * Holds result of bulk plugin installation.
3187
+ *
3188
+ * @since 2.2.0
3189
+ *
3190
+ * @var string
3191
+ */
3192
+ public $result;
3193
+
3194
+ /**
3195
+ * Flag to check if bulk installation is occurring or not.
3196
+ *
3197
+ * @since 2.2.0
3198
+ *
3199
+ * @var boolean
3200
+ */
3201
+ public $bulk = false;
3202
+
3203
+ /**
3204
+ * TGMPA instance
3205
+ *
3206
+ * @since 2.5.0
3207
+ *
3208
+ * @var object
3209
+ */
3210
+ protected $tgmpa;
3211
+
3212
+ /**
3213
+ * Whether or not the destination directory needs to be cleared ( = on update).
3214
+ *
3215
+ * @since 2.5.0
3216
+ *
3217
+ * @var bool
3218
+ */
3219
+ protected $clear_destination = false;
3220
+
3221
+ /**
3222
+ * References parent constructor and sets defaults for class.
3223
+ *
3224
+ * @since 2.2.0
3225
+ *
3226
+ * @param \Bulk_Upgrader_Skin|null $skin Installer skin.
3227
+ */
3228
+ public function __construct( $skin = null ) {
3229
+ // Get TGMPA class instance.
3230
+ $this->tgmpa = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
3231
+
3232
+ parent::__construct( $skin );
3233
+
3234
+ if ( isset( $this->skin->options['install_type'] ) && 'update' === $this->skin->options['install_type'] ) {
3235
+ $this->clear_destination = true;
3236
+ }
3237
+
3238
+ if ( $this->tgmpa->is_automatic ) {
3239
+ $this->activate_strings();
3240
+ }
3241
+
3242
+ add_action( 'upgrader_process_complete', array( $this->tgmpa, 'populate_file_path' ) );
3243
+ }
3244
+
3245
+ /**
3246
+ * Sets the correct activation strings for the installer skin to use.
3247
+ *
3248
+ * @since 2.2.0
3249
+ */
3250
+ public function activate_strings() {
3251
+ $this->strings['activation_failed'] = __( 'Plugin activation failed.', 'tgmpa' );
3252
+ $this->strings['activation_success'] = __( 'Plugin activated successfully.', 'tgmpa' );
3253
+ }
3254
+
3255
+ /**
3256
+ * Performs the actual installation of each plugin.
3257
+ *
3258
+ * @since 2.2.0
3259
+ *
3260
+ * @see WP_Upgrader::run()
3261
+ *
3262
+ * @param array $options The installation config options.
3263
+ * @return null|array Return early if error, array of installation data on success.
3264
+ */
3265
+ public function run( $options ) {
3266
+ $result = parent::run( $options );
3267
+
3268
+ // Reset the strings in case we changed one during automatic activation.
3269
+ if ( $this->tgmpa->is_automatic ) {
3270
+ if ( 'update' === $this->skin->options['install_type'] ) {
3271
+ $this->upgrade_strings();
3272
+ } else {
3273
+ $this->install_strings();
3274
+ }
3275
+ }
3276
+
3277
+ return $result;
3278
+ }
3279
+
3280
+ /**
3281
+ * Processes the bulk installation of plugins.
3282
+ *
3283
+ * @since 2.2.0
3284
+ *
3285
+ * {@internal This is basically a near identical copy of the WP Core
3286
+ * Plugin_Upgrader::bulk_upgrade() method, with minor adjustments to deal with
3287
+ * new installs instead of upgrades.
3288
+ * For ease of future synchronizations, the adjustments are clearly commented, but no other
3289
+ * comments are added. Code style has been made to comply.}}
3290
+ *
3291
+ * @see Plugin_Upgrader::bulk_upgrade()
3292
+ * @see https://core.trac.wordpress.org/browser/tags/4.2.1/src/wp-admin/includes/class-wp-upgrader.php#L838
3293
+ * (@internal Last synced: Dec 31st 2015 against https://core.trac.wordpress.org/browser/trunk?rev=36134}}
3294
+ *
3295
+ * @param array $plugins The plugin sources needed for installation.
3296
+ * @param array $args Arbitrary passed extra arguments.
3297
+ * @return array|false Install confirmation messages on success, false on failure.
3298
+ */
3299
+ public function bulk_install( $plugins, $args = array() ) {
3300
+ // [TGMPA + ] Hook auto-activation in.
3301
+ add_filter( 'upgrader_post_install', array( $this, 'auto_activate' ), 10 );
3302
+
3303
+ $defaults = array(
3304
+ 'clear_update_cache' => true,
3305
+ );
3306
+ $parsed_args = wp_parse_args( $args, $defaults );
3307
+
3308
+ $this->init();
3309
+ $this->bulk = true;
3310
+
3311
+ $this->install_strings(); // [TGMPA + ] adjusted.
3312
+
3313
+ /* [TGMPA - ] $current = get_site_transient( 'update_plugins' ); */
3314
+
3315
+ /* [TGMPA - ] add_filter('upgrader_clear_destination', array($this, 'delete_old_plugin'), 10, 4); */
3316
+
3317
+ $this->skin->header();
3318
+
3319
+ // Connect to the Filesystem first.
3320
+ $res = $this->fs_connect( array( WP_CONTENT_DIR, WP_PLUGIN_DIR ) );
3321
+ if ( ! $res ) {
3322
+ $this->skin->footer();
3323
+ return false;
3324
+ }
3325
+
3326
+ $this->skin->bulk_header();
3327
+
3328
+ /*
3329
+ * Only start maintenance mode if:
3330
+ * - running Multisite and there are one or more plugins specified, OR
3331
+ * - a plugin with an update available is currently active.
3332
+ * @TODO: For multisite, maintenance mode should only kick in for individual sites if at all possible.
3333
+ */
3334
+ $maintenance = ( is_multisite() && ! empty( $plugins ) );
3335
+
3336
+ /*
3337
+ [TGMPA - ]
3338
+ foreach ( $plugins as $plugin )
3339
+ $maintenance = $maintenance || ( is_plugin_active( $plugin ) && isset( $current->response[ $plugin] ) );
3340
+ */
3341
+ if ( $maintenance ) {
3342
+ $this->maintenance_mode( true );
3343
+ }
3344
+
3345
+ $results = array();
3346
+
3347
+ $this->update_count = count( $plugins );
3348
+ $this->update_current = 0;
3349
+ foreach ( $plugins as $plugin ) {
3350
+ $this->update_current++;
3351
+
3352
+ /*
3353
+ [TGMPA - ]
3354
+ $this->skin->plugin_info = get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin, false, true);
3355
+
3356
+ if ( !isset( $current->response[ $plugin ] ) ) {
3357
+ $this->skin->set_result('up_to_date');
3358
+ $this->skin->before();
3359
+ $this->skin->feedback('up_to_date');
3360
+ $this->skin->after();
3361
+ $results[$plugin] = true;
3362
+ continue;
3363
+ }
3364
+
3365
+ // Get the URL to the zip file.
3366
+ $r = $current->response[ $plugin ];
3367
+
3368
+ $this->skin->plugin_active = is_plugin_active($plugin);
3369
+ */
3370
+
3371
+ $result = $this->run(
3372
+ array(
3373
+ 'package' => $plugin, // [TGMPA + ] adjusted.
3374
+ 'destination' => WP_PLUGIN_DIR,
3375
+ 'clear_destination' => false, // [TGMPA + ] adjusted.
3376
+ 'clear_working' => true,
3377
+ 'is_multi' => true,
3378
+ 'hook_extra' => array(
3379
+ 'plugin' => $plugin,
3380
+ ),
3381
+ )
3382
+ );
3383
+
3384
+ $results[ $plugin ] = $this->result;
3385
+
3386
+ // Prevent credentials auth screen from displaying multiple times.
3387
+ if ( false === $result ) {
3388
+ break;
3389
+ }
3390
+ } //end foreach $plugins
3391
+
3392
+ $this->maintenance_mode( false );
3393
+
3394
+ /**
3395
+ * Fires when the bulk upgrader process is complete.
3396
+ *
3397
+ * @since WP 3.6.0 / TGMPA 2.5.0
3398
+ *
3399
+ * @param Plugin_Upgrader $this Plugin_Upgrader instance. In other contexts, $this, might
3400
+ * be a Theme_Upgrader or Core_Upgrade instance.
3401
+ * @param array $data {
3402
+ * Array of bulk item update data.
3403
+ *
3404
+ * @type string $action Type of action. Default 'update'.
3405
+ * @type string $type Type of update process. Accepts 'plugin', 'theme', or 'core'.
3406
+ * @type bool $bulk Whether the update process is a bulk update. Default true.
3407
+ * @type array $packages Array of plugin, theme, or core packages to update.
3408
+ * }
3409
+ */
3410
+ do_action( 'upgrader_process_complete', $this, array(
3411
+ 'action' => 'install', // [TGMPA + ] adjusted.
3412
+ 'type' => 'plugin',
3413
+ 'bulk' => true,
3414
+ 'plugins' => $plugins,
3415
+ ) );
3416
+
3417
+ $this->skin->bulk_footer();
3418
+
3419
+ $this->skin->footer();
3420
+
3421
+ // Cleanup our hooks, in case something else does a upgrade on this connection.
3422
+ /* [TGMPA - ] remove_filter('upgrader_clear_destination', array($this, 'delete_old_plugin')); */
3423
+
3424
+ // [TGMPA + ] Remove our auto-activation hook.
3425
+ remove_filter( 'upgrader_post_install', array( $this, 'auto_activate' ), 10 );
3426
+
3427
+ // Force refresh of plugin update information.
3428
+ wp_clean_plugins_cache( $parsed_args['clear_update_cache'] );
3429
+
3430
+ return $results;
3431
+ }
3432
+
3433
+ /**
3434
+ * Handle a bulk upgrade request.
3435
+ *
3436
+ * @since 2.5.0
3437
+ *
3438
+ * @see Plugin_Upgrader::bulk_upgrade()
3439
+ *
3440
+ * @param array $plugins The local WP file_path's of the plugins which should be upgraded.
3441
+ * @param array $args Arbitrary passed extra arguments.
3442
+ * @return string|bool Install confirmation messages on success, false on failure.
3443
+ */
3444
+ public function bulk_upgrade( $plugins, $args = array() ) {
3445
+
3446
+ add_filter( 'upgrader_post_install', array( $this, 'auto_activate' ), 10 );
3447
+
3448
+ $result = parent::bulk_upgrade( $plugins, $args );
3449
+
3450
+ remove_filter( 'upgrader_post_install', array( $this, 'auto_activate' ), 10 );
3451
+
3452
+ return $result;
3453
+ }
3454
+
3455
+ /**
3456
+ * Abuse a filter to auto-activate plugins after installation.
3457
+ *
3458
+ * Hooked into the 'upgrader_post_install' filter hook.
3459
+ *
3460
+ * @since 2.5.0
3461
+ *
3462
+ * @param bool $bool The value we need to give back (true).
3463
+ * @return bool
3464
+ */
3465
+ public function auto_activate( $bool ) {
3466
+ // Only process the activation of installed plugins if the automatic flag is set to true.
3467
+ if ( $this->tgmpa->is_automatic ) {
3468
+ // Flush plugins cache so the headers of the newly installed plugins will be read correctly.
3469
+ wp_clean_plugins_cache();
3470
+
3471
+ // Get the installed plugin file.
3472
+ $plugin_info = $this->plugin_info();
3473
+
3474
+ // Don't try to activate on upgrade of active plugin as WP will do this already.
3475
+ if ( ! is_plugin_active( $plugin_info ) ) {
3476
+ $activate = activate_plugin( $plugin_info );
3477
+
3478
+ // Adjust the success string based on the activation result.
3479
+ $this->strings['process_success'] = $this->strings['process_success'] . "<br />\n";
3480
+
3481
+ if ( is_wp_error( $activate ) ) {
3482
+ $this->skin->error( $activate );
3483
+ $this->strings['process_success'] .= $this->strings['activation_failed'];
3484
+ } else {
3485
+ $this->strings['process_success'] .= $this->strings['activation_success'];
3486
+ }
3487
+ }
3488
+ }
3489
+
3490
+ return $bool;
3491
+ }
3492
+ }
3493
+ }
3494
+
3495
+ if ( ! class_exists( 'TGMPA_Bulk_Installer_Skin' ) ) {
3496
+
3497
+ /**
3498
+ * Installer skin to set strings for the bulk plugin installations..
3499
+ *
3500
+ * Extends Bulk_Upgrader_Skin and customizes to suit the installation of multiple
3501
+ * plugins.
3502
+ *
3503
+ * @since 2.2.0
3504
+ *
3505
+ * {@internal Since 2.5.2 the class has been renamed from TGM_Bulk_Installer_Skin to
3506
+ * TGMPA_Bulk_Installer_Skin.
3507
+ * This was done to prevent backward compatibility issues with v2.3.6.}}
3508
+ *
3509
+ * @see https://core.trac.wordpress.org/browser/trunk/src/wp-admin/includes/class-wp-upgrader-skins.php
3510
+ *
3511
+ * @package TGM-Plugin-Activation
3512
+ * @author Thomas Griffin
3513
+ * @author Gary Jones
3514
+ */
3515
+ class TGMPA_Bulk_Installer_Skin extends Bulk_Upgrader_Skin {
3516
+ /**
3517
+ * Holds plugin info for each individual plugin installation.
3518
+ *
3519
+ * @since 2.2.0
3520
+ *
3521
+ * @var array
3522
+ */
3523
+ public $plugin_info = array();
3524
+
3525
+ /**
3526
+ * Holds names of plugins that are undergoing bulk installations.
3527
+ *
3528
+ * @since 2.2.0
3529
+ *
3530
+ * @var array
3531
+ */
3532
+ public $plugin_names = array();
3533
+
3534
+ /**
3535
+ * Integer to use for iteration through each plugin installation.
3536
+ *
3537
+ * @since 2.2.0
3538
+ *
3539
+ * @var integer
3540
+ */
3541
+ public $i = 0;
3542
+
3543
+ /**
3544
+ * TGMPA instance
3545
+ *
3546
+ * @since 2.5.0
3547
+ *
3548
+ * @var object
3549
+ */
3550
+ protected $tgmpa;
3551
+
3552
+ /**
3553
+ * Constructor. Parses default args with new ones and extracts them for use.
3554
+ *
3555
+ * @since 2.2.0
3556
+ *
3557
+ * @param array $args Arguments to pass for use within the class.
3558
+ */
3559
+ public function __construct( $args = array() ) {
3560
+ // Get TGMPA class instance.
3561
+ $this->tgmpa = call_user_func( array( get_class( $GLOBALS['tgmpa'] ), 'get_instance' ) );
3562
+
3563
+ // Parse default and new args.
3564
+ $defaults = array(
3565
+ 'url' => '',
3566
+ 'nonce' => '',
3567
+ 'names' => array(),
3568
+ 'install_type' => 'install',
3569
+ );
3570
+ $args = wp_parse_args( $args, $defaults );
3571
+
3572
+ // Set plugin names to $this->plugin_names property.
3573
+ $this->plugin_names = $args['names'];
3574
+
3575
+ // Extract the new args.
3576
+ parent::__construct( $args );
3577
+ }
3578
+
3579
+ /**
3580
+ * Sets install skin strings for each individual plugin.
3581
+ *
3582
+ * Checks to see if the automatic activation flag is set and uses the
3583
+ * the proper strings accordingly.
3584
+ *
3585
+ * @since 2.2.0
3586
+ */
3587
+ public function add_strings() {
3588
+ if ( 'update' === $this->options['install_type'] ) {
3589
+ parent::add_strings();
3590
+ /* translators: 1: plugin name, 2: action number 3: total number of actions. */
3591
+ $this->upgrader->strings['skin_before_update_header'] = __( 'Updating Plugin %1$s (%2$d/%3$d)', 'tgmpa' );
3592
+ } else {
3593
+ /* translators: 1: plugin name, 2: error message. */
3594
+ $this->upgrader->strings['skin_update_failed_error'] = __( 'An error occurred while installing %1$s: <strong>%2$s</strong>.', 'tgmpa' );
3595
+ /* translators: 1: plugin name. */
3596
+ $this->upgrader->strings['skin_update_failed'] = __( 'The installation of %1$s failed.', 'tgmpa' );
3597
+
3598
+ if ( $this->tgmpa->is_automatic ) {
3599
+ // Automatic activation strings.
3600
+ $this->upgrader->strings['skin_upgrade_start'] = __( 'The installation and activation process is starting. This process may take a while on some hosts, so please be patient.', 'tgmpa' );
3601
+ /* translators: 1: plugin name. */
3602
+ $this->upgrader->strings['skin_update_successful'] = __( '%1$s installed and activated successfully.', 'tgmpa' ) . ' <a href="#" class="hide-if-no-js" onclick="%2$s"><span>' . esc_html__( 'Show Details', 'tgmpa' ) . '</span><span class="hidden">' . esc_html__( 'Hide Details', 'tgmpa' ) . '</span>.</a>';
3603
+ $this->upgrader->strings['skin_upgrade_end'] = __( 'All installations and activations have been completed.', 'tgmpa' );
3604
+ /* translators: 1: plugin name, 2: action number 3: total number of actions. */
3605
+ $this->upgrader->strings['skin_before_update_header'] = __( 'Installing and Activating Plugin %1$s (%2$d/%3$d)', 'tgmpa' );
3606
+ } else {
3607
+ // Default installation strings.
3608
+ $this->upgrader->strings['skin_upgrade_start'] = __( 'The installation process is starting. This process may take a while on some hosts, so please be patient.', 'tgmpa' );
3609
+ /* translators: 1: plugin name. */
3610
+ $this->upgrader->strings['skin_update_successful'] = esc_html__( '%1$s installed successfully.', 'tgmpa' ) . ' <a href="#" class="hide-if-no-js" onclick="%2$s"><span>' . esc_html__( 'Show Details', 'tgmpa' ) . '</span><span class="hidden">' . esc_html__( 'Hide Details', 'tgmpa' ) . '</span>.</a>';
3611
+ $this->upgrader->strings['skin_upgrade_end'] = __( 'All installations have been completed.', 'tgmpa' );
3612
+ /* translators: 1: plugin name, 2: action number 3: total number of actions. */
3613
+ $this->upgrader->strings['skin_before_update_header'] = __( 'Installing Plugin %1$s (%2$d/%3$d)', 'tgmpa' );
3614
+ }
3615
+ }
3616
+ }
3617
+
3618
+ /**
3619
+ * Outputs the header strings and necessary JS before each plugin installation.
3620
+ *
3621
+ * @since 2.2.0
3622
+ *
3623
+ * @param string $title Unused in this implementation.
3624
+ */
3625
+ public function before( $title = '' ) {
3626
+ if ( empty( $title ) ) {
3627
+ $title = esc_html( $this->plugin_names[ $this->i ] );
3628
+ }
3629
+ parent::before( $title );
3630
+ }
3631
+
3632
+ /**
3633
+ * Outputs the footer strings and necessary JS after each plugin installation.
3634
+ *
3635
+ * Checks for any errors and outputs them if they exist, else output
3636
+ * success strings.
3637
+ *
3638
+ * @since 2.2.0
3639
+ *
3640
+ * @param string $title Unused in this implementation.
3641
+ */
3642
+ public function after( $title = '' ) {
3643
+ if ( empty( $title ) ) {
3644
+ $title = esc_html( $this->plugin_names[ $this->i ] );
3645
+ }
3646
+ parent::after( $title );
3647
+
3648
+ $this->i++;
3649
+ }
3650
+
3651
+ /**
3652
+ * Outputs links after bulk plugin installation is complete.
3653
+ *
3654
+ * @since 2.2.0
3655
+ */
3656
+ public function bulk_footer() {
3657
+ // Serve up the string to say installations (and possibly activations) are complete.
3658
+ parent::bulk_footer();
3659
+
3660
+ // Flush plugins cache so we can make sure that the installed plugins list is always up to date.
3661
+ wp_clean_plugins_cache();
3662
+
3663
+ $this->tgmpa->show_tgmpa_version();
3664
+
3665
+ // Display message based on if all plugins are now active or not.
3666
+ $update_actions = array();
3667
+
3668
+ if ( $this->tgmpa->is_tgmpa_complete() ) {
3669
+ // All plugins are active, so we display the complete string and hide the menu to protect users.
3670
+ echo '<style type="text/css">#adminmenu .wp-submenu li.current { display: none !important; }</style>';
3671
+ $update_actions['dashboard'] = sprintf(
3672
+ esc_html( $this->tgmpa->strings['complete'] ),
3673
+ '<a href="' . esc_url( self_admin_url() ) . '">' . esc_html__( 'Return to the Dashboard', 'tgmpa' ) . '</a>'
3674
+ );
3675
+ } else {
3676
+ $update_actions['tgmpa_page'] = '<a href="' . esc_url( $this->tgmpa->get_tgmpa_url() ) . '" target="_parent">' . esc_html( $this->tgmpa->strings['return'] ) . '</a>';
3677
+ }
3678
+
3679
+ /**
3680
+ * Filter the list of action links available following bulk plugin installs/updates.
3681
+ *
3682
+ * @since 2.5.0
3683
+ *
3684
+ * @param array $update_actions Array of plugin action links.
3685
+ * @param array $plugin_info Array of information for the last-handled plugin.
3686
+ */
3687
+ $update_actions = apply_filters( 'tgmpa_update_bulk_plugins_complete_actions', $update_actions, $this->plugin_info );
3688
+
3689
+ if ( ! empty( $update_actions ) ) {
3690
+ $this->feedback( implode( ' | ', (array) $update_actions ) );
3691
+ }
3692
+ }
3693
+
3694
+ /* *********** DEPRECATED METHODS *********** */
3695
+
3696
+ /**
3697
+ * Flush header output buffer.
3698
+ *
3699
+ * @since 2.2.0
3700
+ * @deprecated 2.5.0 use {@see Bulk_Upgrader_Skin::flush_output()} instead
3701
+ * @see Bulk_Upgrader_Skin::flush_output()
3702
+ */
3703
+ public function before_flush_output() {
3704
+ _deprecated_function( __FUNCTION__, 'TGMPA 2.5.0', 'Bulk_Upgrader_Skin::flush_output()' );
3705
+ $this->flush_output();
3706
+ }
3707
+
3708
+ /**
3709
+ * Flush footer output buffer and iterate $this->i to make sure the
3710
+ * installation strings reference the correct plugin.
3711
+ *
3712
+ * @since 2.2.0
3713
+ * @deprecated 2.5.0 use {@see Bulk_Upgrader_Skin::flush_output()} instead
3714
+ * @see Bulk_Upgrader_Skin::flush_output()
3715
+ */
3716
+ public function after_flush_output() {
3717
+ _deprecated_function( __FUNCTION__, 'TGMPA 2.5.0', 'Bulk_Upgrader_Skin::flush_output()' );
3718
+ $this->flush_output();
3719
+ $this->i++;
3720
+ }
3721
+ }
3722
+ }
3723
+ }
3724
+ }
 
 
 
 
3725
  }
3726
 
3727
  if ( ! class_exists( 'TGMPA_Utils' ) ) {
3728
 
3729
+ /**
3730
+ * Generic utilities for TGMPA.
3731
+ *
3732
+ * All methods are static, poor-dev name-spacing class wrapper.
3733
+ *
3734
+ * Class was called TGM_Utils in 2.5.0 but renamed TGMPA_Utils in 2.5.1 as this was conflicting with Soliloquy.
3735
+ *
3736
+ * @since 2.5.0
3737
+ *
3738
+ * @package TGM-Plugin-Activation
3739
+ * @author Juliette Reinders Folmer
3740
+ */
3741
+ class TGMPA_Utils {
3742
+ /**
3743
+ * Whether the PHP filter extension is enabled.
3744
+ *
3745
+ * @see http://php.net/book.filter
3746
+ *
3747
+ * @since 2.5.0
3748
+ *
3749
+ * @static
3750
+ *
3751
+ * @var bool $has_filters True is the extension is enabled.
3752
+ */
3753
+ public static $has_filters;
3754
+
3755
+ /**
3756
+ * Wrap an arbitrary string in <em> tags. Meant to be used in combination with array_map().
3757
+ *
3758
+ * @since 2.5.0
3759
+ *
3760
+ * @static
3761
+ *
3762
+ * @param string $string Text to be wrapped.
3763
+ * @return string
3764
+ */
3765
+ public static function wrap_in_em( $string ) {
3766
+ return '<em>' . wp_kses_post( $string ) . '</em>';
3767
+ }
3768
+
3769
+ /**
3770
+ * Wrap an arbitrary string in <strong> tags. Meant to be used in combination with array_map().
3771
+ *
3772
+ * @since 2.5.0
3773
+ *
3774
+ * @static
3775
+ *
3776
+ * @param string $string Text to be wrapped.
3777
+ * @return string
3778
+ */
3779
+ public static function wrap_in_strong( $string ) {
3780
+ return '<strong>' . wp_kses_post( $string ) . '</strong>';
3781
+ }
3782
+
3783
+ /**
3784
+ * Helper function: Validate a value as boolean
3785
+ *
3786
+ * @since 2.5.0
3787
+ *
3788
+ * @static
3789
+ *
3790
+ * @param mixed $value Arbitrary value.
3791
+ * @return bool
3792
+ */
3793
+ public static function validate_bool( $value ) {
3794
+ if ( ! isset( self::$has_filters ) ) {
3795
+ self::$has_filters = extension_loaded( 'filter' );
3796
+ }
3797
+
3798
+ if ( self::$has_filters ) {
3799
+ return filter_var( $value, FILTER_VALIDATE_BOOLEAN );
3800
+ } else {
3801
+ return self::emulate_filter_bool( $value );
3802
+ }
3803
+ }
3804
+
3805
+ /**
3806
+ * Helper function: Cast a value to bool
3807
+ *
3808
+ * @since 2.5.0
3809
+ *
3810
+ * @static
3811
+ *
3812
+ * @param mixed $value Value to cast.
3813
+ * @return bool
3814
+ */
3815
+ protected static function emulate_filter_bool( $value ) {
3816
+ // @codingStandardsIgnoreStart
3817
+ static $true = array(
3818
+ '1',
3819
+ 'true', 'True', 'TRUE',
3820
+ 'y', 'Y',
3821
+ 'yes', 'Yes', 'YES',
3822
+ 'on', 'On', 'ON',
3823
+ );
3824
+ static $false = array(
3825
+ '0',
3826
+ 'false', 'False', 'FALSE',
3827
+ 'n', 'N',
3828
+ 'no', 'No', 'NO',
3829
+ 'off', 'Off', 'OFF',
3830
+ );
3831
+ // @codingStandardsIgnoreEnd
3832
+
3833
+ if ( is_bool( $value ) ) {
3834
+ return $value;
3835
+ } elseif ( is_int( $value ) && ( 0 === $value || 1 === $value ) ) {
3836
+ return (bool) $value;
3837
+ } elseif ( ( is_float( $value ) && ! is_nan( $value ) ) && ( (float) 0 === $value || (float) 1 === $value ) ) {
3838
+ return (bool) $value;
3839
+ } elseif ( is_string( $value ) ) {
3840
+ $value = trim( $value );
3841
+ if ( in_array( $value, $true, true ) ) {
3842
+ return true;
3843
+ } elseif ( in_array( $value, $false, true ) ) {
3844
+ return false;
3845
+ } else {
3846
+ return false;
3847
+ }
3848
+ }
3849
+
3850
+ return false;
3851
+ }
3852
+ } // End of class TGMPA_Utils
3853
+ } // End of class_exists wrapper
modules/sportspress-birthdays.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Modules
7
  * @package SportsPress/Modules
8
- * @version 2.7.9
9
  */
10
 
11
  // Exit if accessed directly
@@ -74,7 +74,7 @@ if ( ! class_exists( 'SportsPress_Birthdays' ) ) :
74
  case 'Published on: <b>%1$s</b>':
75
  case 'Schedule for: <b>%1$s</b>':
76
  case 'Publish on: <b>%1$s</b>':
77
- return esc_attr__( 'Birthday: <b>%1$s</b>', 'sportspress' );
78
  case 'Publish <b>immediately</b>':
79
  return esc_attr__( 'Birthday', 'sportspress' );
80
  case 'M j, Y @ G:i':
5
  * @author ThemeBoy
6
  * @category Modules
7
  * @package SportsPress/Modules
8
+ * @version 2.7.13
9
  */
10
 
11
  // Exit if accessed directly
74
  case 'Published on: <b>%1$s</b>':
75
  case 'Schedule for: <b>%1$s</b>':
76
  case 'Publish on: <b>%1$s</b>':
77
+ return wp_kses_post( __( 'Birthday: <b>%1$s</b>', 'sportspress' ) );
78
  case 'Publish <b>immediately</b>':
79
  return esc_attr__( 'Birthday', 'sportspress' );
80
  case 'M j, Y @ G:i':
modules/sportspress-comments-scheduled-events.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Modules
7
  * @package SportsPress/Modules
8
- * @version 2.7.9
9
  */
10
 
11
  // Exit if accessed directly
@@ -88,16 +88,16 @@ if ( ! class_exists( 'SportsPress_Comments_Scheduled_Events' ) ) :
88
  if ( get_option( 'require_name_email' ) && ! $user->exists() ) {
89
  if ( '' == $comment_author_email || '' == $comment_author ) {
90
  // return new WP_Error( 'require_name_email', esc_attr__( '<strong>ERROR</strong>: please fill the required fields (name, email).' ), 200 );
91
- wp_die( esc_attr__( '<strong>ERROR</strong>: please fill the required fields (name, email).' ), esc_attr__( 'ERROR: please fill the required fields (name, email).' ), array( 'back_link' => true ) );
92
  } elseif ( ! is_email( $comment_author_email ) ) {
93
  // return new WP_Error( 'require_valid_email', esc_attr__( '<strong>ERROR</strong>: please enter a valid email address.' ), 200 );
94
- wp_die( esc_attr__( '<strong>ERROR</strong>: please enter a valid email address.' ), esc_attr__( 'ERROR: please enter a valid email address.' ), array( 'back_link' => true ) );
95
  }
96
  }
97
 
98
  if ( '' == $comment_content ) {
99
  // return new WP_Error( 'require_valid_comment', esc_attr__( '<strong>ERROR</strong>: please type a comment.' ), 200 );
100
- wp_die( esc_attr__( '<strong>ERROR</strong>: please type a comment.' ), esc_attr__( 'ERROR: please type a comment.' ), array( 'back_link' => true ) );
101
  }
102
 
103
  $comment_parent = isset( $_POST['comment_parent'] ) ? absint( $_POST['comment_parent'] ) : 0;
@@ -125,7 +125,7 @@ if ( ! class_exists( 'SportsPress_Comments_Scheduled_Events' ) ) :
125
 
126
  if ( ! $comment_id ) {
127
  // return new WP_Error( 'comment_save_error', esc_attr__( '<strong>ERROR</strong>: The comment could not be saved. Please try again later.' ), 500 );
128
- wp_die( esc_attr__( '<strong>ERROR</strong>: The comment could not be saved. Please try again later.' ), esc_attr__( 'ERROR: The comment could not be saved. Please try again later.' ), array( 'back_link' => true ) );
129
  }
130
 
131
  $comment = get_comment( $comment_id );
5
  * @author ThemeBoy
6
  * @category Modules
7
  * @package SportsPress/Modules
8
+ * @version 2.7.13
9
  */
10
 
11
  // Exit if accessed directly
88
  if ( get_option( 'require_name_email' ) && ! $user->exists() ) {
89
  if ( '' == $comment_author_email || '' == $comment_author ) {
90
  // return new WP_Error( 'require_name_email', esc_attr__( '<strong>ERROR</strong>: please fill the required fields (name, email).' ), 200 );
91
+ wp_die( wp_kses_post( __( '<strong>ERROR</strong>: please fill the required fields (name, email).' ) ), esc_attr__( 'ERROR: please fill the required fields (name, email).' ), array( 'back_link' => true ) );
92
  } elseif ( ! is_email( $comment_author_email ) ) {
93
  // return new WP_Error( 'require_valid_email', esc_attr__( '<strong>ERROR</strong>: please enter a valid email address.' ), 200 );
94
+ wp_die( wp_kses_post( __( '<strong>ERROR</strong>: please enter a valid email address.' ) ), esc_attr__( 'ERROR: please enter a valid email address.' ), array( 'back_link' => true ) );
95
  }
96
  }
97
 
98
  if ( '' == $comment_content ) {
99
  // return new WP_Error( 'require_valid_comment', esc_attr__( '<strong>ERROR</strong>: please type a comment.' ), 200 );
100
+ wp_die( wp_kses_post( __( '<strong>ERROR</strong>: please type a comment.' ) ), esc_attr__( 'ERROR: please type a comment.' ), array( 'back_link' => true ) );
101
  }
102
 
103
  $comment_parent = isset( $_POST['comment_parent'] ) ? absint( $_POST['comment_parent'] ) : 0;
125
 
126
  if ( ! $comment_id ) {
127
  // return new WP_Error( 'comment_save_error', esc_attr__( '<strong>ERROR</strong>: The comment could not be saved. Please try again later.' ), 500 );
128
+ wp_die( wp_kses_post( __( '<strong>ERROR</strong>: The comment could not be saved. Please try again later.' ) ), esc_attr__( 'ERROR: The comment could not be saved. Please try again later.' ), array( 'back_link' => true ) );
129
  }
130
 
131
  $comment = get_comment( $comment_id );
modules/sportspress-officials.php CHANGED
@@ -5,7 +5,7 @@
5
  * @author ThemeBoy
6
  * @category Modules
7
  * @package SportsPress/Modules
8
- * @version 2.7.9
9
  */
10
 
11
  // Exit if accessed directly
@@ -423,7 +423,7 @@ if ( ! class_exists( 'SportsPress_Officials' ) ) :
423
  public function register_importer( $importers = array() ) {
424
  $importers['sp_official_csv'] = array(
425
  'name' => esc_attr__( 'SportsPress Officials (CSV)', 'sportspress' ),
426
- 'description' => esc_attr__( 'Import <strong>officials</strong> from a csv file.', 'sportspress' ),
427
  'callback' => array( $this, 'officials_importer' ),
428
  );
429
  return $importers;
5
  * @author ThemeBoy
6
  * @category Modules
7
  * @package SportsPress/Modules
8
+ * @version 2.7.13
9
  */
10
 
11
  // Exit if accessed directly
423
  public function register_importer( $importers = array() ) {
424
  $importers['sp_official_csv'] = array(
425
  'name' => esc_attr__( 'SportsPress Officials (CSV)', 'sportspress' ),
426
+ 'description' => wp_kses_post( __( 'Import <strong>officials</strong> from a csv file.', 'sportspress' ) ),
427
  'callback' => array( $this, 'officials_importer' ),
428
  );
429
  return $importers;
readme.txt CHANGED
@@ -4,7 +4,7 @@ Tags: calendars, club, club management, esports, events, fixtures, leagues, leag
4
  Donate link: http://tboy.co/donate
5
  Requires at least: 3.8
6
  Tested up to: 5.8.1
7
- Stable tag: 2.7.12
8
  License: GPLv3
9
  License URI: http://www.gnu.org/licenses/gpl-3.0.html
10
 
@@ -240,6 +240,13 @@ When you upgrade to one of the SportsPress Pro licenses, you can simply activate
240
 
241
  == Changelog ==
242
 
 
 
 
 
 
 
 
243
  = 2.7.12 =
244
  * Fix - OpenStreetMap not displaying map after update.
245
 
4
  Donate link: http://tboy.co/donate
5
  Requires at least: 3.8
6
  Tested up to: 5.8.1
7
+ Stable tag: 2.7.13
8
  License: GPLv3
9
  License URI: http://www.gnu.org/licenses/gpl-3.0.html
10
 
240
 
241
  == Changelog ==
242
 
243
+ = 2.7.13 =
244
+ * Fix - Theme notice escaping.
245
+ * Fix - Timezone dropdown selection now shown in general settings.
246
+ * Fix - Double header when multiple player lists are displayed in team.
247
+ * Fix - Dropdown options not saving in settings.
248
+ * Fix - Setup page conflict with WooCommerce.
249
+
250
  = 2.7.12 =
251
  * Fix - OpenStreetMap not displaying map after update.
252
 
sportspress.php CHANGED
@@ -3,7 +3,7 @@
3
  * Plugin Name: SportsPress
4
  * Plugin URI: http://themeboy.com/sportspress/
5
  * Description: Manage your club and its players, staff, events, league tables, and player lists.
6
- * Version: 2.7.12
7
  * Author: ThemeBoy
8
  * Author URI: http://themeboy.com
9
  * Requires at least: 3.8
@@ -26,14 +26,14 @@ if ( ! class_exists( 'SportsPress' ) ) :
26
  * Main SportsPress Class
27
  *
28
  * @class SportsPress
29
- * @version 2.7.12
30
  */
31
  final class SportsPress {
32
 
33
  /**
34
  * @var string
35
  */
36
- public $version = '2.7.12';
37
 
38
  /**
39
  * @var SportsPress The single instance of the class
3
  * Plugin Name: SportsPress
4
  * Plugin URI: http://themeboy.com/sportspress/
5
  * Description: Manage your club and its players, staff, events, league tables, and player lists.
6
+ * Version: 2.7.13
7
  * Author: ThemeBoy
8
  * Author URI: http://themeboy.com
9
  * Requires at least: 3.8
26
  * Main SportsPress Class
27
  *
28
  * @class SportsPress
29
+ * @version 2.7.13
30
  */
31
  final class SportsPress {
32
 
33
  /**
34
  * @var string
35
  */
36
+ public $version = '2.7.13';
37
 
38
  /**
39
  * @var SportsPress The single instance of the class
templates/team-lists.php CHANGED
@@ -4,7 +4,7 @@
4
  *
5
  * @author ThemeBoy
6
  * @package SportsPress/Templates
7
- * @version 1.1
8
  */
9
 
10
  if ( ! defined( 'ABSPATH' ) ) {
@@ -22,7 +22,7 @@ foreach ( $lists as $list ) :
22
  $id = $list->ID;
23
  $grouping = get_post_meta( $id, 'sp_grouping', true );
24
 
25
- if ( $grouping == 0 && sizeof( $lists ) > 1 ) :
26
  ?>
27
  <h4 class="sp-table-caption"><?php echo wp_kses_post( $list->post_title ); ?></h4>
28
  <?php
4
  *
5
  * @author ThemeBoy
6
  * @package SportsPress/Templates
7
+ * @version 2.7.13
8
  */
9
 
10
  if ( ! defined( 'ABSPATH' ) ) {
22
  $id = $list->ID;
23
  $grouping = get_post_meta( $id, 'sp_grouping', true );
24
 
25
+ if ( $grouping == 'position' && sizeof( $lists ) > 1 ) :
26
  ?>
27
  <h4 class="sp-table-caption"><?php echo wp_kses_post( $list->post_title ); ?></h4>
28
  <?php