wp-admin/includes/class-plugin-installer-skin.php

   1 <?php
   2 /**
   3  * Upgrader API: Plugin_Installer_Skin class
   4  *
   5  * @package WordPress
   6  * @subpackage Upgrader
   7  * @since 4.6.0
   8  */
   9
  10 /**
  11  * Plugin Installer Skin for WordPress Plugin Installer.
  12  *
  13  * @since 2.8.0
  14  * @since 4.6.0 Moved to its own file from wp-admin/includes/class-wp-upgrader-skins.php.
  15  *
  16  * @see WP_Upgrader_Skin
  17  */
  18 class Plugin_Installer_Skin extends WP_Upgrader_Skin {
  19         public $api;
  20         public $type;
  21
  22         /**
  23          *
  24          * @param array $args
  25          */
  26         public function __construct($args = array()) {
  27                 $defaults = array( 'type' => 'web', 'url' => '', 'plugin' => '', 'nonce' => '', 'title' => '' );
  28                 $args = wp_parse_args($args, $defaults);
  29
  30                 $this->type = $args['type'];
  31                 $this->api = isset($args['api']) ? $args['api'] : array();
  32
  33                 parent::__construct($args);
  34         }
  35
  36         /**
  37          * @access public
  38          */
  39         public function before() {
  40                 if ( !empty($this->api) )
  41                         $this->upgrader->strings['process_success'] = sprintf( __('Successfully installed the plugin <strong>%s %s</strong>.'), $this->api->name, $this->api->version);
  42         }
  43
  44         /**
  45          * @access public
  46          */
  47         public function after() {
  48                 $plugin_file = $this->upgrader->plugin_info();
  49
  50                 $install_actions = array();
  51
  52                 $from = isset($_GET['from']) ? wp_unslash( $_GET['from'] ) : 'plugins';
  53
  54                 if ( 'import' == $from )
  55                         $install_actions['activate_plugin'] = '<a href="' . wp_nonce_url( 'plugins.php?action=activate&amp;from=import&amp;plugin=' . urlencode( $plugin_file ), 'activate-plugin_' . $plugin_file ) . '" target="_parent">' . __( 'Activate Plugin &amp; Run Importer' ) . '</a>';
  56                 else
  57                         $install_actions['activate_plugin'] = '<a href="' . wp_nonce_url( 'plugins.php?action=activate&amp;plugin=' . urlencode( $plugin_file ), 'activate-plugin_' . $plugin_file ) . '" target="_parent">' . __( 'Activate Plugin' ) . '</a>';
  58
  59                 if ( is_multisite() && current_user_can( 'manage_network_plugins' ) ) {
  60                         $install_actions['network_activate'] = '<a href="' . wp_nonce_url( 'plugins.php?action=activate&amp;networkwide=1&amp;plugin=' . urlencode( $plugin_file ), 'activate-plugin_' . $plugin_file ) . '" target="_parent">' . __( 'Network Activate' ) . '</a>';
  61                         unset( $install_actions['activate_plugin'] );
  62                 }
  63
  64                 if ( 'import' == $from ) {
  65                         $install_actions['importers_page'] = '<a href="' . admin_url( 'import.php' ) . '" target="_parent">' . __( 'Return to Importers' ) . '</a>';
  66                 } elseif ( $this->type == 'web' ) {
  67                         $install_actions['plugins_page'] = '<a href="' . self_admin_url( 'plugin-install.php' ) . '" target="_parent">' . __( 'Return to Plugin Installer' ) . '</a>';
  68                 } elseif ( 'upload' == $this->type && 'plugins' == $from ) {
  69                         $install_actions['plugins_page'] = '<a href="' . self_admin_url( 'plugin-install.php' ) . '">' . __( 'Return to Plugin Installer' ) . '</a>';
  70                 } else {
  71                         $install_actions['plugins_page'] = '<a href="' . self_admin_url( 'plugins.php' ) . '" target="_parent">' . __( 'Return to Plugins page' ) . '</a>';
  72                 }
  73
  74                 if ( ! $this->result || is_wp_error($this->result) ) {
  75                         unset( $install_actions['activate_plugin'], $install_actions['network_activate'] );
  76                 } elseif ( ! current_user_can( 'activate_plugins' ) ) {
  77                         unset( $install_actions['activate_plugin'] );
  78                 }
  79
  80                 /**
  81                  * Filters the list of action links available following a single plugin installation.
  82                  *
  83                  * @since 2.7.0
  84                  *
  85                  * @param array  $install_actions Array of plugin action links.
  86                  * @param object $api             Object containing WordPress.org API plugin data. Empty
  87                  *                                for non-API installs, such as when a plugin is installed
  88                  *                                via upload.
  89                  * @param string $plugin_file     Path to the plugin file.
  90                  */
  91                 $install_actions = apply_filters( 'install_plugin_complete_actions', $install_actions, $this->api, $plugin_file );
  92
  93                 if ( ! empty($install_actions) )
  94                         $this->feedback(implode(' | ', (array)$install_actions));
  95         }
  96 }