[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * Upgrader API: Bulk_Plugin_Upgrader_Skin class
   4   *
   5   * @package WordPress
   6   * @subpackage Upgrader
   7   * @since 4.6.0
   8   */
   9  
  10  /**
  11   * Bulk Theme Upgrader Skin for WordPress Theme Upgrades.
  12   *
  13   * @since 3.0.0
  14   * @since 4.6.0 Moved to its own file from wp-admin/includes/class-wp-upgrader-skins.php.
  15   *
  16   * @see Bulk_Upgrader_Skin
  17   */
  18  class Bulk_Theme_Upgrader_Skin extends Bulk_Upgrader_Skin {
  19  
  20      /**
  21       * Theme info.
  22       *
  23       * The Theme_Upgrader::bulk_upgrade() method will fill this in
  24       * with info retrieved from the Theme_Upgrader::theme_info() method,
  25       * which in turn calls the wp_get_theme() function.
  26       *
  27       * @since 3.0.0
  28       * @var WP_Theme|false The theme's info object, or false.
  29       */
  30      public $theme_info = false;
  31  
  32      /**
  33       * Sets up the strings used in the update process.
  34       *
  35       * @since 3.0.0
  36       */
  37  	public function add_strings() {
  38          parent::add_strings();
  39          /* translators: 1: Theme name, 2: Number of the theme, 3: Total number of themes being updated. */
  40          $this->upgrader->strings['skin_before_update_header'] = __( 'Updating Theme %1$s (%2$d/%3$d)' );
  41      }
  42  
  43      /**
  44       * Performs an action before a bulk theme update.
  45       *
  46       * @since 3.0.0
  47       *
  48       * @param string $title
  49       */
  50  	public function before( $title = '' ) {
  51          parent::before( $this->theme_info->display( 'Name' ) );
  52      }
  53  
  54      /**
  55       * Performs an action following a bulk theme update.
  56       *
  57       * @since 3.0.0
  58       *
  59       * @param string $title
  60       */
  61  	public function after( $title = '' ) {
  62          parent::after( $this->theme_info->display( 'Name' ) );
  63          $this->decrement_update_count( 'theme' );
  64      }
  65  
  66      /**
  67       * Displays the footer following the bulk update process.
  68       *
  69       * @since 3.0.0
  70       */
  71  	public function bulk_footer() {
  72          parent::bulk_footer();
  73  
  74          $update_actions = array(
  75              'themes_page'  => sprintf(
  76                  '<a href="%s" target="_parent">%s</a>',
  77                  self_admin_url( 'themes.php' ),
  78                  __( 'Go to Themes page' )
  79              ),
  80              'updates_page' => sprintf(
  81                  '<a href="%s" target="_parent">%s</a>',
  82                  self_admin_url( 'update-core.php' ),
  83                  __( 'Go to WordPress Updates page' )
  84              ),
  85          );
  86  
  87          if ( ! current_user_can( 'switch_themes' ) && ! current_user_can( 'edit_theme_options' ) ) {
  88              unset( $update_actions['themes_page'] );
  89          }
  90  
  91          /**
  92           * Filters the list of action links available following bulk theme updates.
  93           *
  94           * @since 3.0.0
  95           *
  96           * @param string[] $update_actions Array of theme action links.
  97           * @param WP_Theme $theme_info     Theme object for the last-updated theme.
  98           */
  99          $update_actions = apply_filters( 'update_bulk_theme_complete_actions', $update_actions, $this->theme_info );
 100  
 101          if ( ! empty( $update_actions ) ) {
 102              $this->feedback( implode( ' | ', (array) $update_actions ) );
 103          }
 104      }
 105  }