1<?php
  2/**
  3 * Upgrader API: Theme_Upgrader_Skin class
  4 *
  5 * @package WordPress
  6 * @subpackage Upgrader
  7 * @since 4.6.0
  8 */
  9
 10/**
 11 * Theme Upgrader Skin for WordPress Theme Upgrades.
 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 */
 18class Theme_Upgrader_Skin extends WP_Upgrader_Skin {
 19
 20	/**
 21	 * Holds the theme slug in the Theme Directory.
 22	 *
 23	 * @since 2.8.0
 24	 *
 25	 * @var string
 26	 */
 27	public $theme = '';
 28
 29	/**
 30	 * Constructor.
 31	 *
 32	 * Sets up the theme upgrader skin.
 33	 *
 34	 * @since 2.8.0
 35	 *
 36	 * @param array $args Optional. The theme upgrader skin arguments to
 37	 *                    override default options. Default empty array.
 38	 */
 39	public function __construct( $args = array() ) {
 40		$defaults = array(
 41			'url'   => '',
 42			'theme' => '',
 43			'nonce' => '',
 44			'title' => __( 'Update Theme' ),
 45		);
 46		$args     = wp_parse_args( $args, $defaults );
 47
 48		$this->theme = $args['theme'];
 49
 50		parent::__construct( $args );
 51	}
 52
 53	/**
 54	 * Performs an action following a single theme update.
 55	 *
 56	 * @since 2.8.0
 57	 */
 58	public function after() {
 59		$this->decrement_update_count( 'theme' );
 60
 61		$update_actions = array();
 62		$theme_info     = $this->upgrader->theme_info();
 63		if ( $theme_info ) {
 64			$name       = $theme_info->display( 'Name' );
 65			$stylesheet = $this->upgrader->result['destination_name'];
 66			$template   = $theme_info->get_template();
 67
 68			$activate_link = add_query_arg(
 69				array(
 70					'action'     => 'activate',
 71					'template'   => urlencode( $template ),
 72					'stylesheet' => urlencode( $stylesheet ),
 73				),
 74				admin_url( 'themes.php' )
 75			);
 76			$activate_link = wp_nonce_url( $activate_link, 'switch-theme_' . $stylesheet );
 77
 78			$customize_url = add_query_arg(
 79				array(
 80					'theme'  => urlencode( $stylesheet ),
 81					'return' => urlencode( admin_url( 'themes.php' ) ),
 82				),
 83				admin_url( 'customize.php' )
 84			);
 85
 86			if ( get_stylesheet() === $stylesheet ) {
 87				if ( current_user_can( 'edit_theme_options' ) && current_user_can( 'customize' ) ) {
 88					$update_actions['preview'] = sprintf(
 89						'<a href="%s" class="hide-if-no-customize load-customize">' .
 90						'<span aria-hidden="true">%s</span><span class="screen-reader-text">%s</span></a>',
 91						esc_url( $customize_url ),
 92						__( 'Customize' ),
 93						/* translators: Hidden accessibility text. %s: Theme name. */
 94						sprintf( __( 'Customize &#8220;%s&#8221;' ), $name )
 95					);
 96				}
 97			} elseif ( current_user_can( 'switch_themes' ) ) {
 98				if ( current_user_can( 'edit_theme_options' ) && current_user_can( 'customize' ) ) {
 99					$update_actions['preview'] = sprintf(
100						'<a href="%s" class="hide-if-no-customize load-customize">' .
101						'<span aria-hidden="true">%s</span><span class="screen-reader-text">%s</span></a>',
102						esc_url( $customize_url ),
103						__( 'Live Preview' ),
104						/* translators: Hidden accessibility text. %s: Theme name. */
105						sprintf( __( 'Live Preview &#8220;%s&#8221;' ), $name )
106					);
107				}
108
109				$update_actions['activate'] = sprintf(
110					'<a href="%s" class="activatelink">' .
111					'<span aria-hidden="true">%s</span><span class="screen-reader-text">%s</span></a>',
112					esc_url( $activate_link ),
113					_x( 'Activate', 'theme' ),
114					/* translators: Hidden accessibility text. %s: Theme name. */
115					sprintf( _x( 'Activate &#8220;%s&#8221;', 'theme' ), $name )
116				);
117			}
118
119			if ( ! $this->result || is_wp_error( $this->result ) || is_network_admin() ) {
120				unset( $update_actions['preview'], $update_actions['activate'] );
121			}
122		}
123
124		$update_actions['themes_page'] = sprintf(
125			'<a href="%s" target="_parent">%s</a>',
126			self_admin_url( 'themes.php' ),
127			__( 'Go to Themes page' )
128		);
129
130		/**
131		 * Filters the list of action links available following a single theme update.
132		 *
133		 * @since 2.8.0
134		 *
135		 * @param string[] $update_actions Array of theme action links.
136		 * @param string   $theme          Theme directory name.
137		 */
138		$update_actions = apply_filters( 'update_theme_complete_actions', $update_actions, $this->theme );
139
140		if ( ! empty( $update_actions ) ) {
141			$this->feedback( implode( ' | ', (array) $update_actions ) );
142		}
143	}
144}
145