PageRenderTime 43ms CodeModel.GetById 10ms RepoModel.GetById 0ms app.codeStats 0ms

/wp-content/themes/lifeline/framework/library/tgm-plugin-activation/class-tgm-plugin-activation.php

https://bitbucket.org/acipriani/madeinapulia.com
PHP | 2093 lines | 975 code | 350 blank | 768 comment | 181 complexity | 8a0d78a282bb060a16052b63c0b344c3 MD5 | raw file
Possible License(s): GPL-3.0, MIT, BSD-3-Clause, LGPL-2.1, GPL-2.0, Apache-2.0

Large files files are truncated, but you can click here to view the full file

    

  1. <?php

    2. 

  2. /**

    3. 

  3.  * Plugin installation and activation for WordPress themes.

    4. 

  4.  *

    5. 

  5.  * @package   TGM-Plugin-Activation

    6. 

  6.  * @version   2.3.6

    7. 

  7.  * @author    Thomas Griffin <thomas@thomasgriffinmedia.com>

    8. 

  8.  * @author    Gary Jones <gamajo@gamajo.com>

    9. 

  9.  * @copyright Copyright (c) 2012, Thomas Griffin

    10. 

  10.  * @license   http://opensource.org/licenses/gpl-2.0.php GPL v2 or later

    11. 

  11.  * @link      https://github.com/thomasgriffin/TGM-Plugin-Activation

    12. 

  12.  */

    13. 

  13. 

    14. 

  14. /*

    15. 

  15.     Copyright 2012  Thomas Griffin  (email : thomas@thomasgriffinmedia.com)

    16. 

  16. 

    17. 

  17.     This program is free software; you can redistribute it and/or modify

    18. 

  18.     it under the terms of the GNU General Public License, version 3, as

    19. 

  19.     published by the Free Software Foundation.

    20. 

  20. 

    21. 

  21.     This program is distributed in the hope that it will be useful,

    22. 

  22.     but WITHOUT ANY WARRANTY; without even the implied warranty of

    23. 

  23.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    24. 

  24.     GNU General Public License for more details.

    25. 

  25. 

    26. 

  26.     You should have received a copy of the GNU General Public License

    27. 

  27.     along with this program; if not, write to the Free Software

    28. 

  28.     Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

    29. 

  29. */

    30. 

  30. 

    31. 

  31. if ( ! class_exists( 'TGM_Plugin_Activation' ) ) {

    32. 

  32. 	/**

    33. 

  33.  	 * Automatic plugin installation and activation library.

    34. 

  34.  	 *

    35. 

  35.  	 * Creates a way to automatically install and activate plugins from within themes.

    36. 

  36.  	 * The plugins can be either pre-packaged, downloaded from the WordPress

    37. 

  37.  	 * Plugin Repository or downloaded from a private repository.

    38. 

  38.  	 *

    39. 

  39.  	 * @since 1.0.0

    40. 

  40.  	 *

    41. 

  41.  	 * @package TGM-Plugin-Activation

    42. 

  42.  	 * @author Thomas Griffin <thomas@thomasgriffinmedia.com>

    43. 

  43.  	 * @author Gary Jones <gamajo@gamajo.com>

    44. 

  44.  	 */

    45. 

  45. 	class TGM_Plugin_Activation {

    46. 

  46. 

    47. 

  47. 		/**

    48. 

  48. 	 	 * Holds a copy of itself, so it can be referenced by the class name.

    49. 

  49. 	 	 *

    50. 

  50. 	 	 * @since 1.0.0

    51. 

  51. 	 	 *

    52. 

  52. 	 	 * @var TGM_Plugin_Activation

    53. 

  53. 	 	 */

    54. 

  54. 		static $instance;

    55. 

  55. 

    56. 

  56. 		/**

    57. 

  57. 	 	 * Holds arrays of plugin details.

    58. 

  58. 	 	 *

    59. 

  59. 	 	 * @since 1.0.0

    60. 

  60. 	 	 *

    61. 

  61. 	 	 * @var array

    62. 

  62. 	 	 */

    63. 

  63. 		public $plugins = array();

    64. 

  64. 

    65. 

  65. 		/**

    66. 

  66. 	 	 * Parent menu slug for plugins page.

    67. 

  67. 	 	 *

    68. 

  68. 	 	 * @since 2.2.0

    69. 

  69. 	 	 *

    70. 

  70. 	 	 * @var string Parent menu slug. Defaults to 'themes.php'.

    71. 

  71. 	 	 */

    72. 

  72. 		public $parent_menu_slug = 'themes.php';

    73. 

  73. 

    74. 

  74. 		/**

    75. 

  75. 	 	 * Parent URL slug for URL references.

    76. 

  76. 	 	 *

    77. 

  77. 	 	 * This is useful if you want to place the custom plugins page as a

    78. 

  78. 	 	 * submenu item under a custom parent menu.

    79. 

  79. 	 	 *

    80. 

  80. 	 	 * @since 2.2.0

    81. 

  81. 	 	 *

    82. 

  82. 	 	 * @var string Parent URL slug. Defaults to 'themes.php'.

    83. 

  83. 	 	 */

    84. 

  84. 		public $parent_url_slug = 'themes.php';

    85. 

  85. 

    86. 

  86. 		/**

    87. 

  87. 	 	 * Name of the querystring argument for the admin page.

    88. 

  88. 	 	 *

    89. 

  89. 	 	 * @since 1.0.0

    90. 

  90. 	 	 *

    91. 

  91. 	 	 * @var string

    92. 

  92. 	 	 */

    93. 

  93. 		public $menu = 'install-required-plugins';

    94. 

  94. 

    95. 

  95. 		/**

    96. 

  96. 		 * Text domain for localization support.

    97. 

  97. 		 *

    98. 

  98. 		 * @since 1.1.0

    99. 

  99. 		 *

    100. 

  100. 		 * @var string

    101. 

  101. 		 */

    102. 

  102. 		public $domain = 'tgmpa';

    103. 

  103. 

    104. 

  104. 		/**

    105. 

  105. 		 * Default absolute path to folder containing pre-packaged plugin zip files.

    106. 

  106. 		 *

    107. 

  107. 		 * @since 2.0.0

    108. 

  108. 		 *

    109. 

  109. 		 * @var string Absolute path prefix to packaged zip file location. Default is empty string.

    110. 

  110. 		 */

    111. 

  111. 		public $default_path = '';

    112. 

  112. 

    113. 

  113. 		/**

    114. 

  114. 		 * Flag to show admin notices or not.

    115. 

  115. 		 *

    116. 

  116. 		 * @since 2.1.0

    117. 

  117. 		 *

    118. 

  118. 		 * @var boolean

    119. 

  119. 		 */

    120. 

  120. 		public $has_notices = true;

    121. 

  121. 

    122. 

  122. 		/**

    123. 

  123. 		 * Flag to set automatic activation of plugins. Off by default.

    124. 

  124. 		 *

    125. 

  125. 		 * @since 2.2.0

    126. 

  126. 		 *

    127. 

  127. 		 * @var boolean

    128. 

  128. 		 */

    129. 

  129. 		public $is_automatic = false;

    130. 

  130. 

    131. 

  131. 		/**

    132. 

  132. 		 * Optional message to display before the plugins table.

    133. 

  133. 		 *

    134. 

  134. 		 * @since 2.2.0

    135. 

  135. 		 *

    136. 

  136. 		 * @var string Message filtered by wp_kses_post(). Default is empty string.

    137. 

  137. 		 */

    138. 

  138. 		public $message = '';

    139. 

  139. 

    140. 

  140. 		/**

    141. 

  141. 		 * Holds configurable array of strings.

    142. 

  142. 		 *

    143. 

  143. 		 * Default values are added in the constructor.

    144. 

  144. 		 *

    145. 

  145. 		 * @since 2.0.0

    146. 

  146. 		 *

    147. 

  147. 		 * @var array

    148. 

  148. 		 */

    149. 

  149. 		public $strings = array();

    150. 

  150. 

    151. 

  151. 		/**

    152. 

  152. 		 * Adds a reference of this object to $instance, populates default strings,

    153. 

  153. 		 * does the tgmpa_init action hook, and hooks in the interactions to init.

    154. 

  154. 		 *

    155. 

  155. 		 * @since 1.0.0

    156. 

  156. 		 *

    157. 

  157. 		 * @see TGM_Plugin_Activation::init()

    158. 

  158. 		 */

    159. 

  159. 		public function __construct() {

    160. 

  160. 

    161. 

  161. 			self::$instance =& $this;

    162. 

  162. 

    163. 

  163. 			$this->strings = array(

    164. 

  164. 				'page_title'                      => __( 'Install Required Plugins', SH_NAME ),

    165. 

  165. 				'menu_title'                      => __( 'Install Plugins', SH_NAME ),

    166. 

  166. 				'installing'                      => __( 'Installing Plugin: %s', SH_NAME ),

    167. 

  167. 				'oops'                            => __( 'Something went wrong.', SH_NAME ),

    168. 

  168. 				'notice_can_install_required'     => _n_noop( 'This theme requires the following plugin: %1$s.', 'This theme requires the following plugins: %1$s.' ),

    169. 

  169. 				'notice_can_install_recommended'  => _n_noop( 'This theme recommends the following plugin: %1$s.', 'This theme recommends the following plugins: %1$s.' ),

    170. 

  170. 				'notice_cannot_install'           => _n_noop( 'Sorry, but you do not have the correct permissions to install the %s plugin. Contact the administrator of this site for help on getting the plugin installed.', 'Sorry, but you do not have the correct permissions to install the %s plugins. Contact the administrator of this site for help on getting the plugins installed.' ),

    171. 

  171. 				'notice_can_activate_required'    => _n_noop( 'The following required plugin is currently inactive: %1$s.', 'The following required plugins are currently inactive: %1$s.' ),

    172. 

  172. 				'notice_can_activate_recommended' => _n_noop( 'The following recommended plugin is currently inactive: %1$s.', 'The following recommended plugins are currently inactive: %1$s.' ),

    173. 

  173. 				'notice_cannot_activate'          => _n_noop( 'Sorry, but you do not have the correct permissions to activate the %s plugin. Contact the administrator of this site for help on getting the plugin activated.', 'Sorry, but you do not have the correct permissions to activate the %s plugins. Contact the administrator of this site for help on getting the plugins activated.' ),

    174. 

  174. 				'notice_ask_to_update'            => _n_noop( 'The following plugin needs to be updated to its latest version to ensure maximum compatibility with this theme: %1$s.', 'The following plugins need to be updated to their latest version to ensure maximum compatibility with this theme: %1$s.' ),

    175. 

  175. 				'notice_cannot_update'            => _n_noop( 'Sorry, but you do not have the correct permissions to update the %s plugin. Contact the administrator of this site for help on getting the plugin updated.', 'Sorry, but you do not have the correct permissions to update the %s plugins. Contact the administrator of this site for help on getting the plugins updated.' ),

    176. 

  176. 				'install_link' 					  => _n_noop( 'Begin installing plugin', 'Begin installing plugins' ),

    177. 

  177. 				'activate_link' 				  => _n_noop( 'Activate installed plugin', 'Activate installed plugins' ),

    178. 

  178. 				'return'                          => __( 'Return to Required Plugins Installer', SH_NAME ),

    179. 

  179. 				'plugin_activated'                => __( 'Plugin activated successfully.', SH_NAME ),

    180. 

  180. 				'complete'                        => __( 'All plugins installed and activated successfully. %1$s', SH_NAME ),

    181. 

  181. 			);

    182. 

  182. 

    183. 

  183. 			/** Annouce that the class is ready, and pass the object (for advanced use) */

    184. 

  184. 			do_action_ref_array( 'tgmpa_init', array( &$this ) );

    185. 

  185. 

    186. 

  186. 			/** When the rest of WP has loaded, kick-start the rest of the class */

    187. 

  187. 			add_action( 'init', array( &$this, 'init' ) );

    188. 

  188. 

    189. 

  189. 		}

    190. 

  190. 

    191. 

  191. 		/**

    192. 

  192. 		 * Initialise the interactions between this class and WordPress.

    193. 

  193. 		 *

    194. 

  194. 		 * Hooks in three new methods for the class: admin_menu, notices and styles.

    195. 

  195. 		 *

    196. 

  196. 		 * @since 2.0.0

    197. 

  197. 		 *

    198. 

  198. 		 * @see TGM_Plugin_Activation::admin_menu()

    199. 

  199. 		 * @see TGM_Plugin_Activation::notices()

    200. 

  200. 		 * @see TGM_Plugin_Activation::styles()

    201. 

  201. 		 */

    202. 

  202. 		public function init() {

    203. 

  203. 

    204. 

  204. 			do_action( 'tgmpa_register' );

    205. 

  205. 			/** After this point, the plugins should be registered and the configuration set */

    206. 

  206. 

    207. 

  207. 			/** Proceed only if we have plugins to handle */

    208. 

  208. 			if ( $this->plugins ) {

    209. 

  209. 				$sorted = array(); // Prepare variable for sorting

    210. 

  210. 

    211. 

  211. 				foreach ( $this->plugins as $plugin )

    212. 

  212. 					$sorted[] = $plugin['name'];

    213. 

  213. 

    214. 

  214. 				array_multisort( $sorted, SORT_ASC, $this->plugins ); // Sort plugins alphabetically by name

    215. 

  215. 

    216. 

  216. 				add_action( 'admin_menu', array( &$this, 'admin_menu' ) );

    217. 

  217. 				add_action( 'admin_head', array( &$this, 'dismiss' ) );

    218. 

  218. 				add_filter( 'install_plugin_complete_actions', array( &$this, 'actions' ) );

    219. 

  219. 

    220. 

  220. 				/** Load admin bar in the header to remove flash when installing plugins */

    221. 

  221. 				if ( $this->is_tgmpa_page() ) {

    222. 

  222. 					remove_action( 'wp_footer', 'wp_admin_bar_render', 1000 );

    223. 

  223. 					remove_action( 'admin_footer', 'wp_admin_bar_render', 1000 );

    224. 

  224. 					add_action( 'wp_head', 'wp_admin_bar_render', 1000 );

    225. 

  225. 					add_action( 'admin_head', 'wp_admin_bar_render', 1000 );

    226. 

  226. 				}

    227. 

  227. 

    228. 

  228. 				if ( $this->has_notices ) {

    229. 

  229. 					add_action( 'admin_notices', array( &$this, 'notices' ) );

    230. 

  230. 					add_action( 'admin_init', array( &$this, 'admin_init' ), 1 );

    231. 

  231. 					add_action( 'admin_enqueue_scripts', array( &$this, 'thickbox' ) );

    232. 

  232. 					add_action( 'switch_theme', array( &$this, 'update_dismiss' ) );

    233. 

  233. 				}

    234. 

  234. 

    235. 

  235. 				/** Setup the force activation hook */

    236. 

  236. 				foreach ( $this->plugins as $plugin ) {

    237. 

  237. 					if ( isset( $plugin['force_activation'] ) && true === $plugin['force_activation'] ) {

    238. 

  238. 						add_action( 'admin_init', array( &$this, 'force_activation' ) );

    239. 

  239. 						break;

    240. 

  240. 					}

    241. 

  241. 				}

    242. 

  242. 

    243. 

  243. 				/** Setup the force deactivation hook */

    244. 

  244. 				foreach ( $this->plugins as $plugin ) {

    245. 

  245. 					if ( isset( $plugin['force_deactivation'] ) && true === $plugin['force_deactivation'] ) {

    246. 

  246. 						add_action( 'switch_theme', array( &$this, 'force_deactivation' ) );

    247. 

  247. 						break;

    248. 

  248. 					}

    249. 

  249. 				}

    250. 

  250. 			}

    251. 

  251. 

    252. 

  252. 		}

    253. 

  253. 

    254. 

  254. 		/**

    255. 

  255. 		 * Handles calls to show plugin information via links in the notices.

    256. 

  256. 		 *

    257. 

  257. 		 * We get the links in the admin notices to point to the TGMPA page, rather

    258. 

  258. 		 * than the typical plugin-install.php file, so we can prepare everything

    259. 

  259. 		 * beforehand.

    260. 

  260. 		 *

    261. 

  261. 		 * WP doesn't make it easy to show the plugin information in the thickbox -

    262. 

  262. 		 * here we have to require a file that includes a function that does the

    263. 

  263. 		 * main work of displaying it, enqueue some styles, set up some globals and

    264. 

  264. 		 * finally call that function before exiting.

    265. 

  265. 		 *

    266. 

  266. 		 * Down right easy once you know how...

    267. 

  267. 		 *

    268. 

  268. 		 * @since 2.1.0

    269. 

  269. 		 *

    270. 

  270. 		 * @global string $tab Used as iframe div class names, helps with styling

    271. 

  271. 		 * @global string $body_id Used as the iframe body ID, helps with styling

    272. 

  272. 		 * @return null Returns early if not the TGMPA page.

    273. 

  273. 		 */

    274. 

  274. 		public function admin_init() {

    275. 

  275. 

    276. 

  276. 			if ( ! $this->is_tgmpa_page() )

    277. 

  277. 				return;

    278. 

  278. 

    279. 

  279. 			if ( isset( $_REQUEST['tab'] ) && 'plugin-information' == $_REQUEST['tab'] ) {

    280. 

  280. 				require_once ABSPATH . 'wp-admin/includes/plugin-install.php'; // Need for install_plugin_information()

    281. 

  281. 

    282. 

  282. 				wp_enqueue_style( 'plugin-install' );

    283. 

  283. 

    284. 

  284. 				global $tab, $body_id;

    285. 

  285. 				$body_id = $tab = 'plugin-information';

    286. 

  286. 

    287. 

  287. 				install_plugin_information();

    288. 

  288. 

    289. 

  289. 				exit;

    290. 

  290. 			}

    291. 

  291. 

    292. 

  292. 		}

    293. 

  293. 

    294. 

  294. 		/**

    295. 

  295. 		 * Enqueues thickbox scripts/styles for plugin info.

    296. 

  296. 		 *

    297. 

  297. 		 * Thickbox is not automatically included on all admin pages, so we must

    298. 

  298. 		 * manually enqueue it for those pages.

    299. 

  299. 		 *

    300. 

  300. 		 * Thickbox is only loaded if the user has not dismissed the admin

    301. 

  301. 		 * notice or if there are any plugins left to install and activate.

    302. 

  302. 		 *

    303. 

  303. 		 * @since 2.1.0

    304. 

  304. 		 */

    305. 

  305. 		public function thickbox() {

    306. 

  306. 

    307. 

  307. 			if ( ! get_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice', true ) )

    308. 

  308. 				add_thickbox();

    309. 

  309. 

    310. 

  310. 		}

    311. 

  311. 

    312. 

  312. 		/**

    313. 

  313. 		 * Adds submenu page under 'Appearance' tab.

    314. 

  314. 		 *

    315. 

  315. 		 * This method adds the submenu page letting users know that a required

    316. 

  316. 		 * plugin needs to be installed.

    317. 

  317. 		 *

    318. 

  318. 		 * This page disappears once the plugin has been installed and activated.

    319. 

  319. 		 *

    320. 

  320. 		 * @since 1.0.0

    321. 

  321. 		 *

    322. 

  322. 		 * @see TGM_Plugin_Activation::init()

    323. 

  323. 		 * @see TGM_Plugin_Activation::install_plugins_page()

    324. 

  324. 		 */

    325. 

  325. 		public function admin_menu() {

    326. 

  326. 

    327. 

  327. 			// Make sure privileges are correct to see the page

    328. 

  328. 			if ( ! current_user_can( 'install_plugins' ) )

    329. 

  329. 				return;

    330. 

  330. 

    331. 

  331. 			$this->populate_file_path();

    332. 

  332. 

    333. 

  333. 			foreach ( $this->plugins as $plugin ) {

    334. 

  334. 				if ( ! is_plugin_active( $plugin['file_path'] ) ) {

    335. 

  335. 					add_theme_page(

    336. 

  336. 						$this->strings['page_title'],           // Page title

    337. 

  337. 						$this->strings['menu_title'],           // Menu title

    338. 

  338. 						'edit_theme_options',                   // Capability

    339. 

  339. 						$this->menu,                            // Menu slug

    340. 

  340. 						array( &$this, 'install_plugins_page' ) // Callback

    341. 

  341. 					);

    342. 

  342. 				break;

    343. 

  343. 				}

    344. 

  344. 			}

    345. 

  345. 

    346. 

  346. 		}

    347. 

  347. 

    348. 

  348. 		/**

    349. 

  349. 		 * Echoes plugin installation form.

    350. 

  350. 		 *

    351. 

  351. 		 * This method is the callback for the admin_menu method function.

    352. 

  352. 		 * This displays the admin page and form area where the user can select to install and activate the plugin.

    353. 

  353. 		 *

    354. 

  354. 		 * @since 1.0.0

    355. 

  355. 		 *

    356. 

  356. 		 * @return null Aborts early if we're processing a plugin installation action

    357. 

  357. 		 */

    358. 

  358. 		public function install_plugins_page() {

    359. 

  359. 

    360. 

  360. 			/** Store new instance of plugin table in object */

    361. 

  361. 			$plugin_table = new TGMPA_List_Table;

    362. 

  362. 

    363. 

  363. 			/** Return early if processing a plugin installation action */

    364. 

  364. 			if ( isset( $_POST[sanitize_key( 'action' )] ) && 'tgmpa-bulk-install' == $_POST[sanitize_key( 'action' )] && $plugin_table->process_bulk_actions() || $this->do_plugin_install() )

    365. 

  365. 				return;

    366. 

  366. 

    367. 

  367. 			?>

    368. 

  368. 			<div class="tgmpa wrap">

    369. 

  369. 

    370. 

  370. 				<?php screen_icon( apply_filters( 'tgmpa_default_screen_icon', 'themes' ) ); ?>

    371. 

  371. 				<h2><?php echo esc_html( get_admin_page_title() ); ?></h2>

    372. 

  372. 				<?php $plugin_table->prepare_items(); ?>

    373. 

  373. 

    374. 

  374. 				<?php if ( isset( $this->message ) ) echo wp_kses_post( $this->message ); ?>

    375. 

  375. 

    376. 

  376. 				<form id="tgmpa-plugins" action="" method="post">

    377. 

  377.             		<input type="hidden" name="tgmpa-page" value="<?php echo $this->menu; ?>" />

    378. 

  378.             		<?php $plugin_table->display(); ?>

    379. 

  379.         		</form>

    380. 

  380. 

    381. 

  381. 			</div>

    382. 

  382. 			<?php

    383. 

  383. 

    384. 

  384. 		}

    385. 

  385. 

    386. 

  386. 		/**

    387. 

  387. 		 * Installs a plugin or activates a plugin depending on the hover

    388. 

  388. 		 * link clicked by the user.

    389. 

  389. 		 *

    390. 

  390. 		 * Checks the $_GET variable to see which actions have been

    391. 

  391. 		 * passed and responds with the appropriate method.

    392. 

  392. 		 *

    393. 

  393. 		 * Uses WP_Filesystem to process and handle the plugin installation

    394. 

  394. 		 * method.

    395. 

  395. 		 *

    396. 

  396. 		 * @since 1.0.0

    397. 

  397. 		 *

    398. 

  398. 		 * @uses WP_Filesystem

    399. 

  399. 		 * @uses WP_Error

    400. 

  400. 		 * @uses WP_Upgrader

    401. 

  401. 		 * @uses Plugin_Upgrader

    402. 

  402. 		 * @uses Plugin_Installer_Skin

    403. 

  403. 		 *

    404. 

  404. 		 * @return boolean True on success, false on failure

    405. 

  405. 		 */

    406. 

  406. 		protected function do_plugin_install() {

    407. 

  407. 

    408. 

  408. 			/** All plugin information will be stored in an array for processing */

    409. 

  409. 			$plugin = array();

    410. 

  410. 

    411. 

  411. 			/** Checks for actions from hover links to process the installation */

    412. 

  412. 			if ( isset( $_GET[sanitize_key( 'plugin' )] ) && ( isset( $_GET[sanitize_key( 'tgmpa-install' )] ) && 'install-plugin' == $_GET[sanitize_key( 'tgmpa-install' )] ) ) {

    413. 

  413. 				check_admin_referer( 'tgmpa-install' );

    414. 

  414. 

    415. 

  415. 				$plugin['name']   = $_GET[sanitize_key( 'plugin_name' )]; // Plugin name

    416. 

  416. 				$plugin['slug']   = $_GET[sanitize_key( 'plugin' )]; // Plugin slug

    417. 

  417. 				$plugin['source'] = $_GET[sanitize_key( 'plugin_source' )]; // Plugin source

    418. 

  418. 

    419. 

  419. 				/** Pass all necessary information via URL if WP_Filesystem is needed */

    420. 

  420. 				$url = wp_nonce_url(

    421. 

  421. 					add_query_arg(

    422. 

  422. 						array(

    423. 

  423. 							'page'          => $this->menu,

    424. 

  424. 							'plugin'        => $plugin['slug'],

    425. 

  425. 							'plugin_name'   => $plugin['name'],

    426. 

  426. 							'plugin_source' => $plugin['source'],

    427. 

  427. 							'tgmpa-install' => 'install-plugin',

    428. 

  428. 						),

    429. 

  429. 						admin_url( $this->parent_url_slug )

    430. 

  430. 					),

    431. 

  431. 					'tgmpa-install'

    432. 

  432. 				);

    433. 

  433. 				$method = ''; // Leave blank so WP_Filesystem can populate it as necessary

    434. 

  434. 				$fields = array( sanitize_key( 'tgmpa-install' ) ); // Extra fields to pass to WP_Filesystem

    435. 

  435. 

    436. 

  436. 				if ( false === ( $creds = request_filesystem_credentials( $url, $method, false, false, $fields ) ) )

    437. 

  437. 					return true;

    438. 

  438. 

    439. 

  439. 				if ( ! WP_Filesystem( $creds ) ) {

    440. 

  440. 					request_filesystem_credentials( $url, $method, true, false, $fields ); // Setup WP_Filesystem

    441. 

  441. 					return true;

    442. 

  442. 				}

    443. 

  443. 

    444. 

  444. 				require_once ABSPATH . 'wp-admin/includes/plugin-install.php'; // Need for plugins_api

    445. 

  445. 				require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php'; // Need for upgrade classes

    446. 

  446. 

    447. 

  447. 				/** Set plugin source to WordPress API link if available */

    448. 

  448. 				if ( isset( $plugin['source'] ) && 'repo' == $plugin['source'] ) {

    449. 

  449. 					$api = plugins_api( 'plugin_information', array( 'slug' => $plugin['slug'], 'fields' => array( 'sections' => false ) ) );

    450. 

  450. 					

    451. 

  451. 					if ( is_wp_error( $api ) )

    452. 

  452. 						wp_die( $this->strings['oops'] . var_dump( $api ) );

    453. 

  453. 						

    454. 

  454. 					if ( isset( $api->download_link ) )

    455. 

  455. 						$plugin['source'] = $api->download_link;

    456. 

  456. 				}

    457. 

  457. 

    458. 

  458. 				/** Set type, based on whether the source starts with http:// or https:// */

    459. 

  459. 				$type = preg_match( '|^http(s)?://|', $plugin['source'] ) ? 'web' : 'upload';

    460. 

  460. 

    461. 

  461. 				/** Prep variables for Plugin_Installer_Skin class */

    462. 

  462. 				$title = sprintf( $this->strings['installing'], $plugin['name'] );

    463. 

  463. 				$url   = add_query_arg( array( 'action' => 'install-plugin', 'plugin' => $plugin['slug'] ), 'update.php' );

    464. 

  464. 				if ( isset( $_GET['from'] ) )

    465. 

  465. 					$url .= add_query_arg( 'from', urlencode( stripslashes( $_GET['from'] ) ), $url );

    466. 

  466. 

    467. 

  467. 				$nonce = 'install-plugin_' . $plugin['slug'];

    468. 

  468. 

    469. 

  469. 				/** Prefix a default path to pre-packaged plugins */

    470. 

  470. 				$source = ( 'upload' == $type ) ? $this->default_path . $plugin['source'] : $plugin['source'];

    471. 

  471. 

    472. 

  472. 				/** Create a new instance of Plugin_Upgrader */

    473. 

  473. 				$upgrader = new Plugin_Upgrader( $skin = new Plugin_Installer_Skin( compact( 'type', 'title', 'url', 'nonce', 'plugin', 'api' ) ) );

    474. 

  474. 

    475. 

  475. 				/** Perform the action and install the plugin from the $source urldecode() */

    476. 

  476. 				$upgrader->install( $source );

    477. 

  477. 

    478. 

  478. 				/** Flush plugins cache so we can make sure that the installed plugins list is always up to date */

    479. 

  479. 				wp_cache_flush();

    480. 

  480. 

    481. 

  481. 				/** Only activate plugins if the config option is set to true */

    482. 

  482. 				if ( $this->is_automatic ) {

    483. 

  483. 					$plugin_activate = $upgrader->plugin_info(); // Grab the plugin info from the Plugin_Upgrader method

    484. 

  484. 					$activate = activate_plugin( $plugin_activate ); // Activate the plugin

    485. 

  485. 					$this->populate_file_path(); // Re-populate the file path now that the plugin has been installed and activated

    486. 

  486. 

    487. 

  487. 					if ( is_wp_error( $activate ) ) {

    488. 

  488. 						echo '<div id="message" class="error"><p>' . $activate->get_error_message() . '</p></div>';

    489. 

  489. 						echo '<p><a href="' . add_query_arg( 'page', $this->menu, admin_url( $this->parent_url_slug ) ) . '" title="' . esc_attr( $this->strings['return'] ) . '" target="_parent">' . __( 'Return to Required Plugins Installer', SH_NAME ) . '</a></p>';

    490. 

  490. 						return true; // End it here if there is an error with automatic activation

    491. 

  491. 					}

    492. 

  492. 					else {

    493. 

  493. 						echo '<p>' . $this->strings['plugin_activated'] . '</p>';

    494. 

  494. 					}

    495. 

  495. 				}

    496. 

  496. 

    497. 

  497. 				/** Display message based on if all plugins are now active or not */

    498. 

  498. 				$complete = array();

    499. 

  499. 				foreach ( $this->plugins as $plugin ) {

    500. 

  500. 					if ( ! is_plugin_active( $plugin['file_path'] ) ) {

    501. 

  501. 						echo '<p><a href="' . add_query_arg( 'page', $this->menu, admin_url( $this->parent_url_slug ) ) . '" title="' . esc_attr( $this->strings['return'] ) . '" target="_parent">' . $this->strings['return'] . '</a></p>';

    502. 

  502. 						$complete[] = $plugin;

    503. 

  503. 						break;

    504. 

  504. 					}

    505. 

  505. 					/** Nothing to store */

    506. 

  506. 					else {

    507. 

  507. 						$complete[] = '';

    508. 

  508. 					}

    509. 

  509. 				}

    510. 

  510. 

    511. 

  511. 				/** Filter out any empty entries */

    512. 

  512. 				$complete = array_filter( $complete );

    513. 

  513. 

    514. 

  514. 				/** All plugins are active, so we display the complete string and hide the plugin menu */

    515. 

  515. 				if ( empty( $complete ) ) {

    516. 

  516. 					echo '<p>' .  sprintf( $this->strings['complete'], '<a href="' . admin_url() . '" title="' . __( 'Return to the Dashboard', SH_NAME ) . '">' . __( 'Return to the Dashboard', SH_NAME ) . '</a>' ) . '</p>';

    517. 

  517. 					echo '<style type="text/css">#adminmenu .wp-submenu li.current { display: none !important; }</style>';

    518. 

  518. 				}

    519. 

  519. 

    520. 

  520. 				return true;

    521. 

  521. 			}

    522. 

  522. 			/** Checks for actions from hover links to process the activation */

    523. 

  523. 			elseif ( isset( $_GET[sanitize_key( 'plugin' )] ) && ( isset( $_GET[sanitize_key( 'tgmpa-activate' )] ) && 'activate-plugin' == $_GET[sanitize_key( 'tgmpa-activate' )] ) ) {

    524. 

  524. 				check_admin_referer( 'tgmpa-activate', 'tgmpa-activate-nonce' );

    525. 

  525. 

    526. 

  526. 				/** Populate $plugin array with necessary information */

    527. 

  527. 				$plugin['name']   = $_GET[sanitize_key( 'plugin_name' )];

    528. 

  528. 				$plugin['slug']   = $_GET[sanitize_key( 'plugin' )];

    529. 

  529. 				$plugin['source'] = $_GET[sanitize_key( 'plugin_source' )];

    530. 

  530. 

    531. 

  531. 				$plugin_data = get_plugins( '/' . $plugin['slug'] ); // Retrieve all plugins

    532. 

  532. 				$plugin_file = array_keys( $plugin_data ); // Retrieve all plugin files from installed plugins

    533. 

  533. 				$plugin_to_activate = $plugin['slug'] . '/' . $plugin_file[0]; // Match plugin slug with appropriate plugin file

    534. 

  534. 				$activate = activate_plugin( $plugin_to_activate ); // Activate the plugin

    535. 

  535. 

    536. 

  536. 				if ( is_wp_error( $activate ) ) {

    537. 

  537. 					echo '<div id="message" class="error"><p>' . $activate->get_error_message() . '</p></div>';

    538. 

  538. 					echo '<p><a href="' . add_query_arg( 'page', $this->menu, admin_url( $this->parent_url_slug ) ) . '" title="' . esc_attr( $this->strings['return'] ) . '" target="_parent">' . $this->strings['return'] . '</a></p>';

    539. 

  539. 					return true; // End it here if there is an error with activation

    540. 

  540. 				}

    541. 

  541. 				else {

    542. 

  542. 					/** Make sure message doesn't display again if bulk activation is performed immediately after a single activation */

    543. 

  543. 					if ( ! isset( $_POST[sanitize_key( 'action' )] ) ) {

    544. 

  544. 						$msg = sprintf( __( 'The following plugin was activated successfully: %s.', SH_NAME ), '<strong>' . $plugin['name'] . '</strong>' );

    545. 

  545. 						echo '<div id="message" class="updated"><p>' . $msg . '</p></div>';

    546. 

  546. 					}

    547. 

  547. 				}

    548. 

  548. 			}

    549. 

  549. 

    550. 

  550. 			return false;

    551. 

  551. 

    552. 

  552. 		}

    553. 

  553. 

    554. 

  554. 		/**

    555. 

  555. 		 * Echoes required plugin notice.

    556. 

  556. 		 *

    557. 

  557. 		 * Outputs a message telling users that a specific plugin is required for

    558. 

  558. 		 * their theme. If appropriate, it includes a link to the form page where

    559. 

  559. 		 * users can install and activate the plugin.

    560. 

  560. 		 *

    561. 

  561. 		 * @since 1.0.0

    562. 

  562. 		 *

    563. 

  563. 		 * @global object $current_screen

    564. 

  564. 		 * @return null Returns early if we're on the Install page

    565. 

  565. 		 */

    566. 

  566. 		public function notices() {

    567. 

  567. 

    568. 

  568. 			global $current_screen;

    569. 

  569. 

    570. 

  570. 			/** Remove nag on the install page */

    571. 

  571. 			if ( $this->is_tgmpa_page() )

    572. 

  572. 				return;

    573. 

  573. 

    574. 

  574. 			$installed_plugins = get_plugins(); // Retrieve a list of all the plugins

    575. 

  575. 			$this->populate_file_path();

    576. 

  576. 

    577. 

  577. 			$message              = array(); // Store the messages in an array to be outputted after plugins have looped through

    578. 

  578. 			$install_link         = false; // Set to false, change to true in loop if conditions exist, used for action link 'install'

    579. 

  579. 			$install_link_count   = 0; // Used to determine plurality of install action link text

    580. 

  580. 			$activate_link        = false; // Set to false, change to true in loop if conditions exist, used for action link 'activate'

    581. 

  581. 			$activate_link_count  = 0; // Used to determine plurality of activate action link text

    582. 

  582. 

    583. 

  583. 			foreach ( $this->plugins as $plugin ) {

    584. 

  584. 				/** If the plugin is installed and active, check for minimum version argument before moving forward */

    585. 

  585. 				if ( is_plugin_active( $plugin['file_path'] ) ) {

    586. 

  586. 					/** A minimum version has been specified */

    587. 

  587. 					if ( isset( $plugin['version'] ) ) {

    588. 

  588. 						if ( isset( $installed_plugins[$plugin['file_path']]['Version'] ) ) {

    589. 

  589. 							/** If the current version is less than the minimum required version, we display a message */

    590. 

  590. 							if ( version_compare( $installed_plugins[$plugin['file_path']]['Version'], $plugin['version'], '<' ) ) {

    591. 

  591. 								if ( current_user_can( 'install_plugins' ) )

    592. 

  592. 									$message['notice_ask_to_update'][] = $plugin['name'];

    593. 

  593. 								else

    594. 

  594. 									$message['notice_cannot_update'][] = $plugin['name'];

    595. 

  595. 							}

    596. 

  596. 						}

    597. 

  597. 						/** Can't find the plugin, so iterate to the next condition */

    598. 

  598. 						else {

    599. 

  599. 							continue;

    600. 

  600. 						}

    601. 

  601. 					}

    602. 

  602. 					/** No minimum version specified, so iterate over the plugin */

    603. 

  603. 					else {

    604. 

  604. 						continue;

    605. 

  605. 					}

    606. 

  606. 				}

    607. 

  607. 

    608. 

  608. 				/** Not installed */

    609. 

  609. 				if ( ! isset( $installed_plugins[$plugin['file_path']] ) ) {

    610. 

  610. 					$install_link = true; // We need to display the 'install' action link

    611. 

  611. 					$install_link_count++; // Increment the install link count

    612. 

  612. 					if ( current_user_can( 'install_plugins' ) ) {

    613. 

  613. 						if ( $plugin['required'] )

    614. 

  614. 							$message['notice_can_install_required'][] = $plugin['name'];

    615. 

  615. 						/** This plugin is only recommended */

    616. 

  616. 						else

    617. 

  617. 							$message['notice_can_install_recommended'][] = $plugin['name'];

    618. 

  618. 					}

    619. 

  619. 					/** Need higher privileges to install the plugin */

    620. 

  620. 					else {

    621. 

  621. 						$message['notice_cannot_install'][] = $plugin['name'];

    622. 

  622. 					}

    623. 

  623. 				}

    624. 

  624. 				/** Installed but not active */

    625. 

  625. 				elseif ( is_plugin_inactive( $plugin['file_path'] ) ) {

    626. 

  626. 					$activate_link = true; // We need to display the 'activate' action link

    627. 

  627. 					$activate_link_count++; // Increment the activate link count

    628. 

  628. 					if ( current_user_can( 'activate_plugins' ) ) {

    629. 

  629. 						if ( ( isset( $plugin['required'] ) ) && ( $plugin['required'] ) )

    630. 

  630. 							$message['notice_can_activate_required'][] = $plugin['name'];

    631. 

  631. 						/** This plugin is only recommended */

    632. 

  632. 						else {

    633. 

  633. 							$message['notice_can_activate_recommended'][] = $plugin['name'];

    634. 

  634. 						}

    635. 

  635. 					}

    636. 

  636. 					/** Need higher privileges to activate the plugin */

    637. 

  637. 					else {

    638. 

  638. 						$message['notice_cannot_activate'][] = $plugin['name'];

    639. 

  639. 					}

    640. 

  640. 				}

    641. 

  641. 			}

    642. 

  642. 

    643. 

  643. 			/** Only process the nag messages if the user has not dismissed them already */

    644. 

  644. 			if ( ! get_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice', true ) ) {

    645. 

  645. 				/** If we have notices to display, we move forward */

    646. 

  646. 				if ( ! empty( $message ) ) {

    647. 

  647. 					krsort( $message ); // Sort messages

    648. 

  648. 					$rendered = ''; // Display all nag messages as strings

    649. 

  649. 

    650. 

  650. 					/** Grab all plugin names */

    651. 

  651. 					foreach ( $message as $type => $plugin_groups ) {

    652. 

  652. 						$linked_plugin_groups = array();

    653. 

  653. 

    654. 

  654. 						/** Count number of plugins in each message group to calculate singular/plural message */

    655. 

  655. 						$count = count( $plugin_groups );

    656. 

  656. 

    657. 

  657. 						/** Loop through the plugin names to make the ones pulled from the .org repo linked */

    658. 

  658. 						foreach ( $plugin_groups as $plugin_group_single_name ) {

    659. 

  659. 							$external_url = $this->_get_plugin_data_from_name( $plugin_group_single_name, 'external_url' );

    660. 

  660. 							$source = $this->_get_plugin_data_from_name( $plugin_group_single_name, 'source' );

    661. 

  661. 

    662. 

  662. 							if ( $external_url && preg_match( '|^http(s)?://|', $external_url ) ) {

    663. 

  663. 								$linked_plugin_groups[] = '<a href="' . esc_url( $external_url ) . '" title="' . $plugin_group_single_name . '" target="_blank">' . $plugin_group_single_name . '</a>';

    664. 

  664. 							}

    665. 

  665. 							elseif ( ! $source || preg_match( '|^http://wordpress.org/extend/plugins/|', $source ) ) {

    666. 

  666. 								$url = add_query_arg(

    667. 

  667. 									array(

    668. 

  668. 										'tab'       => 'plugin-information',

    669. 

  669. 										'plugin'    => $this->_get_plugin_data_from_name( $plugin_group_single_name ),

    670. 

  670. 										'TB_iframe' => 'true',

    671. 

  671. 										'width'     => '640',

    672. 

  672. 										'height'    => '500',

    673. 

  673. 									),

    674. 

  674. 									admin_url( 'plugin-install.php' )

    675. 

  675. 								);

    676. 

  676. 

    677. 

  677. 								$linked_plugin_groups[] = '<a href="' . esc_url( $url ) . '" class="thickbox" title="' . $plugin_group_single_name . '">' . $plugin_group_single_name . '</a>';

    678. 

  678. 							}

    679. 

  679. 							else {

    680. 

  680. 								$linked_plugin_groups[] = $plugin_group_single_name; // No hyperlink

    681. 

  681. 							}

    682. 

  682. 

    683. 

  683. 							if ( isset( $linked_plugin_groups ) && (array) $linked_plugin_groups )

    684. 

  684. 								$plugin_groups = $linked_plugin_groups;

    685. 

  685. 						}

    686. 

  686. 

    687. 

  687. 						$last_plugin = array_pop( $plugin_groups ); // Pop off last name to prep for readability

    688. 

  688. 						$imploded    = empty( $plugin_groups ) ? '' . $last_plugin . '' : '' . ( implode( ', ', $plugin_groups ) . ' and ' . $last_plugin . '' );

    689. 

  689. 

    690. 

  690. 						$rendered .= '<p>' . sprintf( translate_nooped_plural( $this->strings[$type], $count, SH_NAME ), $imploded, $count ) . '</p>'; // All messages now stored

    691. 

  691. 					}

    692. 

  692. 

    693. 

  693. 					/** Setup variables to determine if action links are needed */

    694. 

  694. 					$show_install_link  = $install_link ? '<a href="' . add_query_arg( 'page', $this->menu, admin_url( $this->parent_url_slug ) ) . '">' . translate_nooped_plural( $this->strings['install_link'], $install_link_count, SH_NAME ) . '</a>' : '';

    695. 

  695. 					$show_activate_link = $activate_link ? '<a href="' . admin_url( 'plugins.php' ) . '">' . translate_nooped_plural( $this->strings['activate_link'], $activate_link_count, SH_NAME ) . '</a>'  : '';

    696. 

  696. 

    697. 

  697. 					/** Define all of the action links */

    698. 

  698. 					$action_links = apply_filters(

    699. 

  699. 						'tgmpa_notice_action_links',

    700. 

  700. 						array(

    701. 

  701. 							'install'  => ( current_user_can( 'install_plugins' ) ) ? $show_install_link : '',

    702. 

  702. 							'activate' => ( current_user_can( 'activate_plugins' ) ) ? $show_activate_link : '',

    703. 

  703. 							'dismiss'  => '<a class="dismiss-notice" href="' . add_query_arg( 'tgmpa-dismiss', 'dismiss_admin_notices' ) . '" target="_parent">' . __( 'Dismiss this notice', SH_NAME ) . '</a>',

    704. 

  704. 						)

    705. 

  705. 					);

    706. 

  706. 

    707. 

  707. 					$action_links = array_filter( $action_links ); // Remove any empty array items

    708. 

  708. 					if ( $action_links )

    709. 

  709. 						$rendered .= '<p>' . implode( ' | ', $action_links ) . '</p>';

    710. 

  710. 

    711. 

  711. 					/** Register the nag messages and prepare them to be processed */

    712. 

  712.                		if ( isset( $this->strings['nag_type'] ) )

    713. 

  713. 						add_settings_error( 'tgmpa', 'tgmpa', $rendered, sanitize_html_class( strtolower( $this->strings['nag_type'] ), 'updated' ) );

    714. 

  714. 					else

    715. 

  715. 						add_settings_error( 'tgmpa', 'tgmpa', $rendered, 'updated' );

    716. 

  716. 				}

    717. 

  717. 			}

    718. 

  718. 

    719. 

  719. 			/** Admin options pages already output settings_errors, so this is to avoid duplication */

    720. 

  720. 			if ( 'options-general' !== $current_screen->parent_base )

    721. 

  721. 				settings_errors( 'tgmpa' );

    722. 

  722. 

    723. 

  723. 		}

    724. 

  724. 

    725. 

  725. 		/**

    726. 

  726. 		 * Add dismissable admin notices.

    727. 

  727. 		 *

    728. 

  728. 		 * Appends a link to the admin nag messages. If clicked, the admin notice disappears and no longer is visible to users.

    729. 

  729. 		 *

    730. 

  730. 		 * @since 2.1.0

    731. 

  731. 		 */

    732. 

  732. 		public function dismiss() {

    733. 

  733. 

    734. 

  734. 			if ( isset( $_GET[sanitize_key( 'tgmpa-dismiss' )] ) )

    735. 

  735. 				update_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice', 1 );

    736. 

  736. 

    737. 

  737. 		}

    738. 

  738. 

    739. 

  739. 		/**

    740. 

  740. 		 * Add individual plugin to our collection of plugins.

    741. 

  741. 		 *

    742. 

  742. 		 * If the required keys are not set, the plugin is not added.

    743. 

  743. 		 *

    744. 

  744. 		 * @since 2.0.0

    745. 

  745. 		 *

    746. 

  746. 		 * @param array $plugin Array of plugin arguments.

    747. 

  747. 		 */

    748. 

  748. 		public function register( $plugin ) {

    749. 

  749. 

    750. 

  750. 			if ( ! isset( $plugin['slug'] ) || ! isset( $plugin['name'] ) )

    751. 

  751. 				return;

    752. 

  752. 

    753. 

  753. 			$this->plugins[] = $plugin;

    754. 

  754. 

    755. 

  755. 		}

    756. 

  756. 

    757. 

  757. 		/**

    758. 

  758. 		 * Amend default configuration settings.

    759. 

  759. 		 *

    760. 

  760. 		 * @since 2.0.0

    761. 

  761. 		 *

    762. 

  762. 		 * @param array $config

    763. 

  763. 		 */

    764. 

  764. 		public function config( $config ) {

    765. 

  765. 

    766. 

  766. 			$keys = array( 'default_path', 'parent_menu_slug', 'parent_url_slug', 'domain', 'has_notices', 'menu', 'is_automatic', 'message', 'strings' );

    767. 

  767. 

    768. 

  768. 			foreach ( $keys as $key ) {

    769. 

  769. 				if ( isset( $config[$key] ) ) {

    770. 

  770. 					if ( is_array( $config[$key] ) ) {

    771. 

  771. 						foreach ( $config[$key] as $subkey => $value )

    772. 

  772. 							$this->{$key}[$subkey] = $value;

    773. 

  773. 					} else {

    774. 

  774. 						$this->$key = $config[$key];

    775. 

  775. 					}

    776. 

  776. 				}

    777. 

  777. 			}

    778. 

  778. 

    779. 

  779. 		}

    780. 

  780. 

    781. 

  781. 		/**

    782. 

  782. 		 * Amend action link after plugin installation.

    783. 

  783. 		 *

    784. 

  784. 		 * @since 2.0.0

    785. 

  785. 		 *

    786. 

  786. 		 * @param array $install_actions Existing array of actions

    787. 

  787. 		 * @return array Amended array of actions

    788. 

  788. 		 */

    789. 

  789. 		public function actions( $install_actions ) {

    790. 

  790. 

    791. 

  791. 			/** Remove action links on the TGMPA install page */

    792. 

  792. 			if ( $this->is_tgmpa_page() )

    793. 

  793. 				return false;

    794. 

  794. 

    795. 

  795. 			return $install_actions;

    796. 

  796. 

    797. 

  797. 		}

    798. 

  798. 

    799. 

  799. 		/**

    800. 

  800. 		 * Set file_path key for each installed plugin.

    801. 

  801. 		 *

    802. 

  802. 		 * @since 2.1.0

    803. 

  803. 		 */

    804. 

  804. 		public function populate_file_path() {

    805. 

  805. 

    806. 

  806. 			/** Add file_path key for all plugins */

    807. 

  807. 			foreach ( $this->plugins as $plugin => $values )

    808. 

  808. 				$this->plugins[$plugin]['file_path'] = $this->_get_plugin_basename_from_slug( $values['slug'] );

    809. 

  809. 

    810. 

  810. 		}

    811. 

  811. 

    812. 

  812. 		/**

    813. 

  813. 		 * Helper function to extract the file path of the plugin file from the

    814. 

  814. 		 * plugin slug, if the plugin is installed.

    815. 

  815. 		 *

    816. 

  816. 		 * @since 2.0.0

    817. 

  817. 		 *

    818. 

  818. 		 * @param string $slug Plugin slug (typically folder name) as provided by the developer

    819. 

  819. 		 * @return string Either file path for plugin if installed, or just the plugin slug

    820. 

  820. 		 */

    821. 

  821. 		protected function _get_plugin_basename_from_slug( $slug ) {

    822. 

  822. 

    823. 

  823. 			$keys = array_keys( get_plugins() );

    824. 

  824. 

    825. 

  825. 			foreach ( $keys as $key ) {

    826. 

  826. 				if ( preg_match( '|^' . $slug .'|', $key ) )

    827. 

  827. 					return $key;

    828. 

  828. 			}

    829. 

  829. 

    830. 

  830. 			return $slug;

    831. 

  831. 

    832. 

  832. 		}

    833. 

  833. 

    834. 

  834. 		/**

    835. 

  835. 		 * Retrieve plugin data, given the plugin name.

    836. 

  836. 		 *

    837. 

  837. 		 * Loops through the registered plugins looking for $name. If it finds it,

    838. 

  838. 		 * it returns the $data from that plugin. Otherwise, returns false.

    839. 

  839. 		 *

    840. 

  840. 		 * @since 2.1.0

    841. 

  841. 		 *

    842. 

  842. 		 * @param string $name Name of the plugin, as it was registered

    843. 

  843. 		 * @param string $data Optional. Array key of plugin data to return. Default is slug

    844. 

  844. 		 * @return string|boolean Plugin slug if found, false otherwise.

    845. 

  845. 		 */

    846. 

  846. 		protected function _get_plugin_data_from_name( $name, $data = 'slug' ) {

    847. 

  847. 

    848. 

  848. 			foreach ( $this->plugins as $plugin => $values ) {

    849. 

  849. 				if ( $name == $values['name'] && isset( $values[$data] ) )

    850. 

  850. 					return $values[$data];

    851. 

  851. 			}

    852. 

  852. 

    853. 

  853. 			return false;

    854. 

  854. 

    855. 

  855. 		}

    856. 

  856. 

    857. 

  857. 		/**

    858. 

  858. 		 * Determine if we're on the TGMPA Install page.

    859. 

  859. 		 *

    860. 

  860. 		 * We use $current_screen when it is available, and a slightly less ideal

    861. 

  861. 		 * conditional when it isn't (like when displaying the plugin information

    862. 

  862. 		 * thickbox).

    863. 

  863. 		 *

    864. 

  864. 		 * @since 2.1.0

    865. 

  865. 		 *

    866. 

  866. 		 * @global object $current_screen

    867. 

  867. 		 * @return boolean True when on the TGMPA page, false otherwise.

    868. 

  868. 		 */

    869. 

  869. 		protected function is_tgmpa_page() {

    870. 

  870. 

    871. 

  871. 			global $current_screen;

    872. 

  872. 

    873. 

  873. 			if ( ! is_null( $current_screen ) && $this->parent_menu_slug == $current_screen->parent_file && isset( $_GET['page'] ) && $this->menu === $_GET['page'] )

    874. 

  874. 				return true;

    875. 

  875. 

    876. 

  876. 			if ( isset( $_GET['page'] ) && $this->menu === $_GET['page'] )

    877. 

  877. 				return true;

    878. 

  878. 

    879. 

  879. 			return false;

    880. 

  880. 

    881. 

  881. 		}

    882. 

  882. 

    883. 

  883. 		/**

    884. 

  884. 		 * Delete dismissable nag option when theme is switched.

    885. 

  885. 		 *

    886. 

  886. 		 * This ensures that the user is again reminded via nag of required

    887. 

  887. 		 * and/or recommended plugins if they re-activate the theme.

    888. 

  888. 		 *

    889. 

  889. 		 * @since 2.1.1

    890. 

  890. 		 */

    891. 

  891. 		public function update_dismiss() {

    892. 

  892. 

    893. 

  893. 			delete_user_meta( get_current_user_id(), 'tgmpa_dismissed_notice' );

    894. 

  894. 

    895. 

  895. 		}

    896. 

  896. 

    897. 

  897. 		/**

    898. 

  898. 		 * Forces plugin activation if the parameter 'force_activation' is

    899. 

  899. 		 * set to true.

    900. 

  900. 		 *

    901. 

  901. 		 * This allows theme authors to specify certain plugins that must be

    902. 

  902. 		 * active at all times while using the current theme.

    903. 

  903. 		 *

    904. 

  904. 		 * Please take special care when using this parameter as it has the

    905. 

  905. 		 * potential to be harmful if not used correctly. Setting this parameter

    906. 

  906. 		 * to true will not allow the specified plugin to be deactivated unless

    907. 

  907. 		 * the user switches themes.

    908. 

  908. 		 *

    909. 

  909. 		 * @since 2.2.0

    910. 

  910. 		 */

    911. 

  911. 		public function force_activation() {

    912. 

  912. 

    913. 

  913. 			/** Set file_path parameter for any installed plugins */

    914. 

  914. 			$this->populate_file_path();

    915. 

  915. 			

    916. 

  916. 			$installed_plugins = get_plugins();

    917. 

  917. 

    918. 

  918. 			foreach ( $this->plugins as $plugin ) {

    919. 

  919. 				/** Oops, plugin isn't there so iterate to next condition */

    920. 

  920. 				if ( isset( $plugin['force_activation'] ) && $plugin['force_activation'] && ! isset( $installed_plugins[$plugin['file_path']] ) )

    921. 

  921. 					continue;

    922. 

  922. 				/** There we go, activate the plugin */

    923. 

  923. 				elseif ( isset( $plugin['force_activation'] ) && $plugin['force_activation'] && is_plugin_inactive( $plugin['file_path'] ) ){

    924. 

  924. 					if( isset($plugin['file_path']) ) activate_plugin( $plugin['file_path'] );

    925. 

  925. 				}

    926. 

  926. 			}

    927. 

  927. 

    928. 

  928. 		}

    929. 

  929. 

    930. 

  930. 		/**

    931. 

  931. 		 * Forces plugin deactivation if the parameter 'force_deactivation'

    932. 

  932. 		 * is set to true.

    933. 

  933. 		 *

    934. 

  934. 		 * This allows theme authors to specify certain plugins that must be

    935. 

  935. 		 * deactived upon switching from the current theme to another.

    936. 

  936. 		 *

    937. 

  937. 		 * Please take special care when using this parameter as it has the

    938. 

  938. 		 * potential to be harmful if not used correctly.

    939. 

  939. 		 *

    940. 

  940. 		 * @since 2.2.0

    941. 

  941. 		 */

    942. 

  942. 		public function force_deactivation() {

    943. 

  943. 

    944. 

  944. 			/** Set file_path parameter for any installed plugins */

    945. 

  945. 			$this->populate_file_path();

    946. 

  946. 

    947. 

  947. 			foreach ( $this->plugins as $plugin ) {

    948. 

  948. 				/** Only proceed forward if the paramter is set to true and plugin is active */

    949. 

  949. 				if ( isset( $plugin['force_deactivation'] ) && $plugin['force_deactivation'] && is_plugin_active( $plugin['file_path'] ) )

    950. 

  950. 					deactivate_plugins( $plugin['file_path'] );

    951. 

  951. 			}

    952. 

  952. 

    953. 

  953. 		}

    954. 

  954. 

    955. 

  955. 	}

    956. 

  956. }

    957. 

  957. 

    958. 

  958. /** Create a new instance of the class */

    959. 

  959. new TGM_Plugin_Activation;

    960. 

  960. 

    961. 

  961. if ( ! function_exists( 'tgmpa' ) ) {

    962. 

  962. 	/**

    963. 

  963. 	 * Helper function to register a collection of required plugins.

    964. 

  964. 	 *

    965. 

  965. 	 * @since 2.0.0

    966. 

  966. 	 * @api

    967. 

  967. 	 *

    968. 

  968. 	 * @param array $plugins An array of plugin arrays

    969. 

  969. 	 * @param array $config Optional. An array of configuration values

    970. 

  970. 	 */

    971. 

  971. 	function tgmpa( $plugins, $config = array() ) {

    972. 

  972. 

    973. 

  973. 		foreach ( $plugins as $plugin )

    974. 

  974. 			TGM_Plugin_Activation::$instance->register( $plugin );

    975. 

  975. 

    976. 

  976. 		if ( $config )

    977. 

  977. 			TGM_Plugin_Activation::$instance->config( $config );

    978. 

  978. 

    979. 

  979. 	}

    980. 

  980. }

    981. 

  981. 

    982. 

  982. /**

    983. 

  983.  * WP_List_Table isn't always available. If it isn't available,

    984. 

  984.  * we load it here.

    985. 

  985.  *

    986. 

  986.  * @since 2.2.0

    987. 

  987.  */

    988. 

  988. if ( ! class_exists( 'WP_List_Table' ) )

    989. 

  989. 	require_once( ABSPATH . 'wp-admin/includes/class-wp-list-table.php' );

    990. 

  990. 

    991. 

  991. if ( ! class_exists( 'TGMPA_List_Table' ) ) {

    992. 

  992. 	/**

    993. 

  993. 	 * List table class for handling plugins.

    994. 

  994. 	 *

    995. 

  995. 	 * Extends the WP_List_Table class to provide a future-compatible

    996. 

  996. 	 * way of listing out all required/recommended plugins.

    997. 

  997. 	 *

    998. 

  998. 	 * Gives users an interface similar to the Plugin Administration

    999. 

  999. 	 * area with similar (albeit stripped down) capabilities.

    1000. 

  1000. 	 *

    1001. 

  1001. 	 * This class also allows for the bulk install of plugins.

    1002. 

  1002. 	 *

    1003. 

  1003. 	 * @since 2.2.0

    1004. 

  1004. 	 *

    1005. 

  1005. 	 * @package TGM-Plugin-Activation

    1006. 

  1006. 	 * @author Thomas Griffin <thomas@thomasgriffinmedia.com>

    1007. 

  1007. 	 * @author Gary Jones <gamajo@gamajo.com>

    1008. 

  1008. 	 */

    1009. 

  1009. 	class TGMPA_List_Table extends WP_List_Table {

    1010. 

  1010. 

    1011. 

  1011. 		/**

    1012. 

  1012. 		 * References parent constructor and sets defaults for class.

    1013. 

  1013. 		 *

    1014. 

  1014. 		 * The constructor also grabs a copy of $instance from the TGMPA class

    1015. 

  1015. 		 * and stores it in the global object TGM_Plugin_Activation::$instance.

    1016. 

  1016. 		 *

    1017. 

  1017. 		 * @since 2.2.0

    1018. 

  1018. 		 *

    1019. 

  1019. 		 * @global unknown $status

    1020. 

  1020. 		 * @global string $page

    1021. 

  1021. 		 */

    1022. 

  1022. 		public function __construct() {

    1023. 

  1023. 

    1024. 

  1024. 			global $status, $page;

    1025. 

  1025. 

    1026. 

  1026. 			parent::__construct(

    1027. 

  1027. 				array(

    1028. 

  1028. 					'singular' => 'plugin',

    1029. 

  1029. 					'plural'   => 'plugins',

    1030. 

  1030. 					'ajax'     => false,

    1031. 

  1031. 				)

    1032. 

  1032. 			);

    1033. 

  1033. 

    1034. 

  1034. 		}

    1035. 

  1035. 

    1036. 

  1036. 		/**

    1037. 

  1037. 		 * Gathers and renames all of our plugin information to be used by

    1038. 

  1038. 		 * WP_List_Table to create our table.

    1039. 

  1039. 		 *

    1040. 

  1040. 		 * @since 2.2.0

    1041. 

  1041. 		 *

    1042. 

  1042. 		 * @return array $table_data Information for use in table

    1043. 

  1043. 		 */

    1044. 

  1044. 		protected function _gather_plugin_data() {

    1045. 

  1045. 

    1046. 

  1046. 			/** Load thickbox for plugin links */

    1047. 

  1047. 			TGM_Plugin_Activation::$instance->admin_init();

    1048. 

  1048. 			TGM_Plugin_Activation::$instance->thickbox();

    1049. 

  1049. 

    1050. 

  1050. 			/** Prep variables for use and grab list of all installed plugins */

    1051. 

  1051. 			$table_data = array();

    1052. 

  1052. 			$i = 0;

    1053. 

  1053. 			$installed_plugins = get_plugins();

    1054. 

  1054. 

    1055. 

  1055. 			foreach ( TGM_Plugin_Activation::$instance->plugins as $plugin ) {

    1056. 

  1056. 				if ( is_plugin_active( $plugin['file_path'] ) )

    1057. 

  1057. 					continue; // No need to display plugins if they are installed and activated

    1058. 

  1058. 

    1059. 

  1059. 				$table_data[$i]['sanitized_plugin'] = $plugin['name'];

    1060. 

  1060. 				$table_data[$i]['slug'] = $this->_get_plugin_data_from_name( $plugin['name'] );

    1061. 

  1061. 

    1062. 

  1062. 				$external_url = $this->_get_plugin_data_from_name( $plugin['name'], 'external_url' );

    1063. 

  1063. 				$source = $this->_get_plugin_data_from_name( $plugin['name'], 'source' );

    1064. 

  1064. 

    1065. 

  1065. 				if ( $external_url && preg_match( '|^http(s)?://|', $external_url ) ) {

    1066. 

  1066. 					$table_data[$i]['plugin'] = '<a href="' . esc_url( $external_url ) . '" title="' . $plugin['name'] . '" target="_blank">' . $plugin['name'] . '</a>';

    1067. 

  1067. 				}

    1068. 

  1068. 				elseif ( ! $source || preg_match( '|^http://wordpress.org/extend/plugins/|', $source ) ) {

    1069. 

  1069. 					$url = add_query_arg(

    1070. 

  1070. 						array(

    1071. 

  1071. 							'tab'       => 'plugin-information',

    1072. 

  1072. 							'plugin'    => $this->_get_plugin_data_from_name( $plugin['name'] ),

    1073. 

  1073. 							'TB_iframe' => 'true',

    1074. 

  1074. 							'width'     => '640',

    1075. 

  1075. 							'height'    => '500',

    1076. 

  1076. 						),

    1077. 

  1077. 						admin_url( 'plugin-install.php' )

    1078. 

  1078. 					);

    1079. 

  1079. 

    1080. 

  1080. 					$table_data[$i]['plugin'] = '<a href="' . esc_url( $url ) . '" class="thickbox" title="' . $plugin['name'] . '">' . $plugin['name'] . '</a>';

    1081. 

  1081. 				}

    1082. 

  1082. 				else {

    1083. 

  1083. 					$table_data[$i]['plugin'] = '' . $plugin['name'] . ''; // No hyperlink

    1084. 

  1084. 				}

    1085. 

  1085. 

    1086. 

  1086. 				if ( isset( $table_data[$i]['plugin'] ) && (array) $table_data[$i]['plugin'] )

    1087. 

  1087. 					$plugin['name'] = $table_data[$i]['plugin'];

    1088. 

  1088. 

    1089. 

  1089. 				if ( isset( $plugin['external_url'] ) ) {

    1090. 

  1090. 					/** The plugin is linked to an external source */

    1091. 

  1091. 					$table_data[$i]['source'] = __( 'External Link', SH_NAME );

    1092. 

  1092. 				}

    1093. 

  1093. 				elseif ( isset( $plugin['source'] ) ) {

    1094. 

  1094. 					/** The plugin must be from a private repository */

    1095. 

  1095. 					if ( preg_match( '|^http(s)?://|', $plugin['source'] ) )

    1096. 

  1096. 						$table_data[$i]['source'] = __( 'Private Repository', SH_NAME );

    1097. 

  1097. 					/** The plugin is pre-packaged with the theme */

    1098. 

  1098. 					else

    1099. 

  1099. 						$table_data[$i]['source'] = __( 'Pre-Packaged', SH_NAME );

    1100. 

  1100. 				}

    1101. 

  1101. 				/** The plugin is from the WordPress repository */

    1102. 

  1102. 				else {

    1103. 

  1103. 					$table_data[$i]['source'] = __( 'WordPress Repository', SH_NAME );

    1104. 

  1104. 				}

    1105. 

  1105. 

    1106. 

  1106. 				$table_data[$i]['type'] = $plugin['required'] ? __( 'Required', SH_NAME ) : __( 'Recommended', SH_NAME );

    1107. 

  1107. 

    1108. 

  1108. 				if ( ! isset( $installed_plugins[$plugin['file_path']] ) )

    1109. 

  1109. 					$table_data[$i]['status'] = sprintf( '%1$s', __( 'Not Installed', SH_NAME ) );

    1110. 

  1110. 				elseif ( is_plugin_inactive( $plugin['file_path'] ) )

    1111. 

  1111. 					$table_data[$i]['status'] = sprintf( '%1$s', __( 'Installed But Not Activated', SH_NAME ) );

    1112. 

  1112. 

    1113. 

  1113. 				$table_data[$i]['file_path'] = $plugin['file_path'];

    1114. 

  1114. 				$table_data[$i]['url'] = isset( $plugin['source'] ) ? $plugin['source'] : 'repo';

    1115. 

  1115. 

    1116. 

  1116. 				$i++;

    1117. 

  1117. 			}

    1118. 

  1118. 			

    1119. 

  1119. 			/** Sort plugins by Required/Recommended type and by alphabetical listing within each type */

    1120. 

  1120. 			$resort = array();

    1121. 

  1121. 			$req = array();

    1122. 

  1122. 			$rec = array();

    1123. 

  1123. 			

    1124. 

  1124. 			/** Grab all the plugin types */

    1125. 

  1125. 			foreach ( $table_data as $plugin )

    1126. 

  1126. 				$resort[] = $plugin['type'];

    1127. 

  1127. 			

    1128. 

  1128. 			/** Sort each plugin by type */

    1129. 

  1129. 			foreach ( $resort as $type )

    1130. 

  1130. 				if ( 'Required' == $type )

    1131. 

  1131. 					$req[] = $type;

    1132. 

  1132. 				else

    1133. 

  1133. 					$rec[] = $type;

    1134. 

  1134. 			

    1135. 

  1135. 			/** Sort alphabetically each plugin type array, merge them and then sort in reverse	(lists Required plugins first) */	

    1136. 

  1136. 			sort( $req );

    1137. 

  1137. 			sort( $rec );

    1138. 

  1138. 			array_merge( $resort, $req, $rec );

    1139. 

  1139. 			array_multisort( $resort, SORT_DESC, $table_data );

    1140. 

  1140. 

    1141. 

  1141. 			return $table_data;

    1142. 

  1142. 

    1143. 

  1143. 		}

    1144. 

  1144. 

    1145. 

  1145. 		/**

    1146. 

  1146. 		 * Retrieve plugin data, given the plugin name. Taken from the

    1147. 

  1147. 		 * TGM_Plugin_Activation class.

    1148. 

  1148. 		 *

    1149. 

  1149. 		 * Loops through the registered plugins looking for $name. If it finds it,

    1150. 

  1150. 		 * it returns the $data from that plugin. Otherwise, returns false.

    1151. 

  1151. 		 *

    1152. 

  1152. 		 * @since 2.2.0

    1153. 

  1153. 		 *

    1154. 

  1154. 		 * @param string $name Name of the plugin, as it was registered

    1155. 

  1155. 		 * @param string $data Optional. Array key of plugin data to return. Default is slug

    1156. 

  1156. 		 * @return string|boolean Plugin slug if found, false otherwise

    1157. 

  1157. 		 */

    1158. 

  1158. 		protected function _get_plugin_data_from_name( $name, $data = 'slug' ) {

    1159. 

  1159. 

    1160. 

  1160. 			foreach ( TGM_Plugin_Activation::$instance->plugins as $plugin => $values ) {

    1161. 

  1161. 				if ( $name == $values['name'] && isset( $values[$data] ) )

    1162. 

  1162. 					return $values[$data];

    1163. 

  1163. 			}

    1164. 

  1164. 

    1165. 

  1165. 			return false;

    1166. 

  1166. 

    1167. 

  1167. 		}

    1168. 

  1168. 

    1169. 

  1169. 		/**

    1170. 

  1170. 		 * Create default columns to display important plugin information

    1171. 

  1171. 		 * like type, action and status.

    1172. 

  1172. 		 *

    1173. 

  1173. 		 * @since 2.2.0

    1174. 

  1174. 		 *

    1175. 

  1175. 		 * @param array $item

    1176. 

  1176. 		 * @param string $column_name

    1177. 

  1177. 		 */

    1178. 

  1178. 		public function column_default( $item, $column_name ) {

    1179. 

  1179. 

    1180. 

  1180. 			switch ( $column_name ) {

    1181. 

  1181. 				case 'source':

    1182. 

  1182. 				case 'type':

    1183. 

  1183. 				case 'status':

    1184. 

  1184. 					return $item[$column_name];

    1185. 

  1185. 			}

    1186. 

  1186. 

    1187. 

  1187. 		}

    1188. 

  1188. 

    1189. 

  1189. 		/**

    1190. 

  1190. 		 * Create default title column along with action links of 'Install'

    1191. 

  1191. 		 * and 'Activate'.

    1192. 

  1192. 		 *

    1193. 

  1193. 		 * @since 2.2.0

    1194. 

  1194. 		 *

    1195. 

  1195. 		 * @param array $item

    1196. 

  1196. 		 * @return string The action hover links

    1197. 

  1197. 		 */

    1198. 

  1198. 		public function column_plugin( $item ) {

    1199. 

  1199. 

    1200. 

  1200. 			$installed_plugins = get_plugins();

    1201. 

  1201. 

    1202. 

  1202. 			/** No need to display any hover links */

    1203. 

  1203. 			if ( is_plugin_active( $item['file_path'] ) )

    1204. 

  1204. 				$actions = array();

    1205. 

  1205. 

    1206. 

  1206. 			/** We need to display the 'Install' hover link */

    1207. 

  1207. 			if ( ! isset( $installed_plugins[$item['file_path']] ) ) {

    1208. 

  1208. 				$actions = array(

    1209. 

  1209. 					'install' => sprintf(

    1210. 

  1210. 						'<a href="%1$s" title="Install %2$s">Install</a>',

    1211. 

  1211. 						wp_nonce_url(

    1212. 

  1212. 							add_query_arg(

    1213. 

  1213. 								array(

    1214. 

  1214. 									'page'          => TGM_Plugin_Activation::$instance->menu,

    1215. 

  1215. 									'plugin'        => $item['slug'],

    1216. 

  1216. 									'plugin_name'   => $item['sanitized_plugin'],

    1217. 

  1217. 									'plugin_source' => $item['url'],

    1218. 

  1218. 									'tgmpa-install' => 'install-plugin',

    1219. 

  1219. 								),

    1220. 

  1220. 								admin_url( TGM_Plugin_Activation::$instance->parent_url_slug )

    1221. 

  1221. 							),

    1222. 

  1222. 							'tgmpa-install'

    1223. 

  1223. 						),

    1224. 

  1224. 						$item['sanitized_plugin']

    1225. 

  1225. 					),

    1226. 

  1226. 				);

    1227. 

  1227. 			}

    1228. 

  1228. 			/** We need to display the 'Activate' hover link */

    1229. 

  1229. 			elseif ( is_plugin_inactive( $item['file_path'] ) ) {

    1230. 

  1230. 				$actions = array(

    1231. 

  1231. 					'activate' => sprintf(

    1232. 

  1232. 						'<a href="%1$s" title="Activate %2$s">Activate</a>',

    1233. 

  1233. 						add_query_arg(

    1234. 

  1234. 							array(

    1235. 

  1235. 								'page'                 => TGM_Plugin_Activation::$instance->menu,

    1236. 

  1236. 								'plugin'               => $item['slug'],

    1237. 

  1237. 								'plugin_name'          => $item['sanitized_plugin'],

    1238. 

  1238. 								'plugin_source'        => $item['url'],

    1239. 

  1239. 								'tgmpa-activate'       => 'activate-plugin',

    1240. 

  1240. 								'tgmpa-activate-nonce' => wp_create_nonce( 'tgmpa-activate' ),

    1241. 

  1241. 							),

    1242. 

  1242. 							admin_url( TGM_Plugin_Activation::$instance->parent_url_slug )

    1243. 

  1243. 						),

    1244. 

  1244. 						$item['sanitized_plugin']

    1245. 

  1245. 					),

    1246. 

  1246. 				);

    1247. 

  1247. 			}

    1248. 

  1248. 

    1249. 

  1249. 			return sprintf( '%1$s %2$s', $item['plugin'], $this->row_actions( $actions ) );

    1250. 

  1250. 

    1251. 

  1251. 		}

    1252. 

  1252. 

    1253. 

  1253. 		/**

    1254. 

  1254. 		 * Required for bulk installing.

    1255. 

  1255. 		 *

    1256. 

  1256. 		 * Adds a checkbox for each plugin.

    1257. 

  1257. 		 *

    1258. 

  1258. 		 * @since 2.2.0

    1259. 

  1259. 		 *

    1260. 

  1260. 		 * @param array $item

    1261. 

  1261. 		 * @return string The input checkbox with all necessary info

    1262. 

  1262. 		 */

    1263. 

  1263. 		public function column_cb( $item ) {

    1264. 

  1264. 

    1265. 

  1265. 			$value = $item['file_path'] . ',' . $item['url'] . ',' . $item['sanitized_plugin'];

    1266. 

  1266. 			return sprintf( '<input type="checkbox" name="%1$s[]" value="%2$s" id="%3$s" />', $this->_args['singular'], $value, $item['sanitized_plugin'] );

    1267. 

  1267. 

    1268. 

  1268. 		}

    1269. 

  1269. 

    1270. 

  1270. 		/**

    1271. 

  1271. 		 * Sets default message within the plugins table if no plugins

    1272. 

  1272. 		 * are left for interaction.

    1273. 

  1273. 		 *

    1274. 

  1274. 		 * Hides the menu item to prevent the user from clicking and

    1275. 

  1275. 		 * getting a permissions error.

    1276. 

  1276. 		 *

    1277. 

  1277. 		 * @since 2.2.0

    1278. 

  1278. 		 */

    1279. 

  1279. 		public function no_items() {

    1280. 

  1280. 

    1281. 

  1281. 			printf( __( 'No plugins to install or activate. <a href="%1$s" title="Return to the Dashboard">Return to the Dashboard</a>', SH_NAME ), admin_url() );

    1282. 

  1282. 			echo '<style type="text/css">#adminmenu .wp-submenu li.current { display: none !important; }</style>';

    1283. 

  1283. 

    1284. 

  1284. 		}

    1285. 

  1285. 

    1286. 

  1286. 		/**

    1287. 

  1287. 		 * Output all the column information within the table.

    1288. 

  1288. 		 *

    1289. 

  1289. 		 * @since 2.2.0

    1290. 

  1290. 		 *

    1291. 

  1291. 		 * @return array $columns The column names

    1292. 

  1292. 		 */

    1293. 

  1293. 		public function get_columns() {

    1294. 

  1294. 

    1295. 

  1295. 			$columns = array(

    1296. 

  1296. 				'cb'     => '<input type="checkbox" />',

    1297. 

  1297. 				'plugin' => __( 'Plugin', SH_NAME ),

    1298. 

  1298. 				'source' => __( 'Source', SH_NAME ),

    1299. 

  1299. 				'type'   => __( 'Type', SH_NAME ),

    1300. 

  1300. 				'status' => __( 'Status', SH_NAME )

    1301. 

  1301. 			);

    1302. 

  1302. 

    1303. 

  1303. 			return $columns;

    1304. 

  1304. 

    1305. 

  1305. 		}

    1306. 

  1306. 

    1307. 

  1307. 		/**

    1308. 

  1308. 		 * Defines all types of bulk actions for handling

    1309. 

  1309. 		 * registered plugins.

    1310. 

  1310. 		 *

    1311. 

  1311. 		 * @since 2.2.0

    1312. 

  1312. 		 *

    1313. 

  1313. 		 * @return array $actions The bulk actions for the plugin install table

    1314. 

  1314. 		 */

    1315. 

  1315. 		public function get_bulk_actions() {

    1316. 

  1316. 

    1317. 

  1317. 			$actions = array(

    1318. 

  1318. 				'tgmpa-bulk-install'  => __( 'Install', SH_NAME ),

    1319. 

  1319. 				'tgmpa-bulk-activate' => __( 'Activate', SH_NAME ),

    1320. 

  1320. 			);

    1321. 

  1321. 

    1322. 

  1322. 			return $actions;

    1323. 

  1323. 

    1324. 

  1324. 		}

    1325. 

  1325. 

    1326. 

  1326. 		/**

    1327. 

  1327. 		 * Processes bulk installation and activation actions.

    1328. 

  1328. 		 *

    1329. 

  1329. 		 * The bulk installation process looks either for the $_POST

    1330. 

  1330. 		 * information or for the plugin info within the $_GET variable if

    1331. 

  1331. 		 * a user has to use WP_Filesystem to enter their credentials.

    1332. 

  1332. 		 *

    1333. 

  1333. 		 * @since 2.2.0

    1334. 

  1334. 		 */

    1335. 

  1335. 		public function process_bulk_actions() {

    1336. 

  1336. 

    1337. 

  1337. 			/** Bulk installation process */

    1338. 

  1338. 			if ( 'tgmpa-bulk-install' === $this->current_action() ) {

    1339. 

  1339. 				check_admin_referer( 'bulk-' . $this->_args['plural'] );

    1340. 

  1340. 

    1341. 

  1341. 				/** Prep variables to be populated */

    1342. 

  1342. 				$plugins_to_install = array();

    1343. 

  1343. 				$plugin_installs    = array();

    1344. 

  1344. 				$plugin_path        = array();

    1345. 

  1345. 				$plugin_name        = array();

    1346. 

  1346. 

    1347. 

  1347. 				/** Look first to see if information has been passed via WP_Filesystem */

    1348. 

  1348. 				if ( isset( $_GET[sanitize_key( 'plugins' )] ) )

    1349. 

  1349. 					$plugins = explode( ',', stripslashes( $_GET[sanitize_key( 'plugins' )] ) );

    1350. 

  1350. 				/** Looks like the user can use the direct method, take from $_POST */

    1351. 

  1351. 				elseif ( isset( $_POST[sanitize_key( 'plugin' )] ) )

    1352. 

  1352. 					$plugins = (array) $_POST[sanitize_key( 'plugin' )];

    1353. 

  1353. 				/** Nothing has been submitted */

    1354. 

  1354. 				else

    1355. 

  1355. 					$plugins = array();

    1356. 

  1356. 

    1357. 

  1357. 				$a = 0; // Incremental variable

    1358. 

  1358. 

    1359. 

  1359. 				/** Grab information from $_POST if available */

    1360. 

  1360. 				if ( isset( $_POST[sanitize_key( 'plugin' )] ) ) {

    1361. 

  1361. 					foreach ( $plugins as $plugin_data )

    1362. 

  1362. 						$plugins_to_install[] = explode( ',', $plugin_data );

    1363. 

  1363. 

    1364. 

  1364. 					foreach ( $plugins_to_install as $plugin_data ) {

    1365. 

  1365. 						$plugin_installs[] = $plugin_data[0];

    1366. 

  1366. 						$plugin_path[]     = $plugin_data[1];

    1367. 

  1367. 						$plugin_name[]     = $plugin_data[2];

    1368. 

  1368. 					}

    1369. 

  1369. 				}

    1370. 

  1370. 				/** Information has been passed via $_GET */

    1371. 

  1371. 				else {

    1372. 

  1372. 					foreach ( $plugins as $key => $value ) {

    1373. 

  1373. 						/** Grab plugin slug for each plugin */

    1374. 

  1374. 						if ( 0 == $key % 3 || 0 == $key ) {

    1375. 

  1375. 							$plugins_to_install[] = $value;

    1376. 

  1376. 							$plugin_installs[]    = $value;

    1377. 

  1377. 						}

    1378. 

  1378. 						$a++;

    1379. 

  1379. 					}

    1380. 

  1380. 				}

    1381. 

  1381. 

    1382. 

  1382. 				/** Look first to see if information has been passed via WP_Filesystem */…
    1383.

Large files files are truncated, but you can click here to view the full file