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 “%s”' ), $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 “%s”' ), $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 “%s”', '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