author | ymh <ymh.work@gmail.com> |
Mon, 08 Sep 2025 19:44:41 +0200 | |
changeset 23 | 417f20492bf7 |
parent 22 | 8c2e4d02f4ef |
permissions | -rw-r--r-- |
0 | 1 |
<?php |
2 |
/** |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
3 |
* List Table API: WP_Theme_Install_List_Table class |
0 | 4 |
* |
5 |
* @package WordPress |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
6 |
* @subpackage Administration |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
7 |
* @since 3.1.0 |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
8 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
9 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
10 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
11 |
* Core class used to implement displaying themes to install in a list table. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
12 |
* |
0 | 13 |
* @since 3.1.0 |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
14 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
15 |
* @see WP_Themes_List_Table |
0 | 16 |
*/ |
17 |
class WP_Theme_Install_List_Table extends WP_Themes_List_Table { |
|
18 |
||
5 | 19 |
public $features = array(); |
0 | 20 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
21 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
22 |
* @return bool |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
23 |
*/ |
5 | 24 |
public function ajax_user_can() { |
0 | 25 |
return current_user_can( 'install_themes' ); |
26 |
} |
|
27 |
||
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
28 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
29 |
* @global array $tabs |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
30 |
* @global string $tab |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
31 |
* @global int $paged |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
32 |
* @global string $type |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
33 |
* @global array $theme_field_defaults |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
34 |
*/ |
5 | 35 |
public function prepare_items() { |
16 | 36 |
require ABSPATH . 'wp-admin/includes/theme-install.php'; |
0 | 37 |
|
38 |
global $tabs, $tab, $paged, $type, $theme_field_defaults; |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
39 |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
40 |
$tab = ! empty( $_REQUEST['tab'] ) ? sanitize_text_field( $_REQUEST['tab'] ) : ''; |
0 | 41 |
|
9 | 42 |
$search_terms = array(); |
0 | 43 |
$search_string = ''; |
9 | 44 |
if ( ! empty( $_REQUEST['s'] ) ) { |
0 | 45 |
$search_string = strtolower( wp_unslash( $_REQUEST['s'] ) ); |
9 | 46 |
$search_terms = array_unique( array_filter( array_map( 'trim', explode( ',', $search_string ) ) ) ); |
0 | 47 |
} |
48 |
||
9 | 49 |
if ( ! empty( $_REQUEST['features'] ) ) { |
0 | 50 |
$this->features = $_REQUEST['features']; |
9 | 51 |
} |
0 | 52 |
|
53 |
$paged = $this->get_pagenum(); |
|
54 |
||
55 |
$per_page = 36; |
|
56 |
||
57 |
// These are the tabs which are shown on the page, |
|
9 | 58 |
$tabs = array(); |
0 | 59 |
$tabs['dashboard'] = __( 'Search' ); |
9 | 60 |
if ( 'search' === $tab ) { |
61 |
$tabs['search'] = __( 'Search Results' ); |
|
62 |
} |
|
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
63 |
$tabs['upload'] = _x( 'Upload', 'noun' ); |
5 | 64 |
$tabs['featured'] = _x( 'Featured', 'themes' ); |
65 |
//$tabs['popular'] = _x( 'Popular', 'themes' ); |
|
9 | 66 |
$tabs['new'] = _x( 'Latest', 'themes' ); |
67 |
$tabs['updated'] = _x( 'Recently Updated', 'themes' ); |
|
0 | 68 |
|
69 |
$nonmenu_tabs = array( 'theme-information' ); // Valid actions to perform which do not have a Menu item. |
|
70 |
||
5 | 71 |
/** This filter is documented in wp-admin/theme-install.php */ |
0 | 72 |
$tabs = apply_filters( 'install_themes_tabs', $tabs ); |
5 | 73 |
|
74 |
/** |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
75 |
* Filters tabs not associated with a menu item on the Install Themes screen. |
5 | 76 |
* |
77 |
* @since 2.8.0 |
|
78 |
* |
|
9 | 79 |
* @param string[] $nonmenu_tabs The tabs that don't have a menu item on |
80 |
* the Install Themes screen. |
|
5 | 81 |
*/ |
0 | 82 |
$nonmenu_tabs = apply_filters( 'install_themes_nonmenu_tabs', $nonmenu_tabs ); |
83 |
||
84 |
// If a non-valid menu tab has been selected, And it's not a non-menu action. |
|
16 | 85 |
if ( empty( $tab ) || ( ! isset( $tabs[ $tab ] ) && ! in_array( $tab, (array) $nonmenu_tabs, true ) ) ) { |
0 | 86 |
$tab = key( $tabs ); |
9 | 87 |
} |
0 | 88 |
|
9 | 89 |
$args = array( |
90 |
'page' => $paged, |
|
91 |
'per_page' => $per_page, |
|
92 |
'fields' => $theme_field_defaults, |
|
93 |
); |
|
0 | 94 |
|
95 |
switch ( $tab ) { |
|
96 |
case 'search': |
|
97 |
$type = isset( $_REQUEST['type'] ) ? wp_unslash( $_REQUEST['type'] ) : 'term'; |
|
98 |
switch ( $type ) { |
|
99 |
case 'tag': |
|
100 |
$args['tag'] = array_map( 'sanitize_key', $search_terms ); |
|
101 |
break; |
|
102 |
case 'term': |
|
103 |
$args['search'] = $search_string; |
|
104 |
break; |
|
105 |
case 'author': |
|
106 |
$args['author'] = $search_string; |
|
107 |
break; |
|
108 |
} |
|
109 |
||
110 |
if ( ! empty( $this->features ) ) { |
|
9 | 111 |
$args['tag'] = $this->features; |
112 |
$_REQUEST['s'] = implode( ',', $this->features ); |
|
0 | 113 |
$_REQUEST['type'] = 'tag'; |
114 |
} |
|
115 |
||
116 |
add_action( 'install_themes_table_header', 'install_theme_search_form', 10, 0 ); |
|
117 |
break; |
|
118 |
||
119 |
case 'featured': |
|
9 | 120 |
// case 'popular': |
0 | 121 |
case 'new': |
122 |
case 'updated': |
|
123 |
$args['browse'] = $tab; |
|
124 |
break; |
|
125 |
||
126 |
default: |
|
127 |
$args = false; |
|
128 |
break; |
|
129 |
} |
|
130 |
||
5 | 131 |
/** |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
132 |
* Filters API request arguments for each Install Themes screen tab. |
5 | 133 |
* |
134 |
* The dynamic portion of the hook name, `$tab`, refers to the theme install |
|
18 | 135 |
* tab. |
136 |
* |
|
137 |
* Possible hook names include: |
|
138 |
* |
|
139 |
* - `install_themes_table_api_args_dashboard` |
|
140 |
* - `install_themes_table_api_args_featured` |
|
141 |
* - `install_themes_table_api_args_new` |
|
142 |
* - `install_themes_table_api_args_search` |
|
143 |
* - `install_themes_table_api_args_updated` |
|
144 |
* - `install_themes_table_api_args_upload` |
|
5 | 145 |
* |
146 |
* @since 3.7.0 |
|
147 |
* |
|
16 | 148 |
* @param array|false $args Theme install API arguments. |
5 | 149 |
*/ |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
150 |
$args = apply_filters( "install_themes_table_api_args_{$tab}", $args ); |
0 | 151 |
|
9 | 152 |
if ( ! $args ) { |
0 | 153 |
return; |
9 | 154 |
} |
0 | 155 |
|
156 |
$api = themes_api( 'query_themes', $args ); |
|
157 |
||
9 | 158 |
if ( is_wp_error( $api ) ) { |
18 | 159 |
wp_die( '<p>' . $api->get_error_message() . '</p> <p><a href="#" onclick="document.location.reload(); return false;">' . __( 'Try Again' ) . '</a></p>' ); |
9 | 160 |
} |
0 | 161 |
|
162 |
$this->items = $api->themes; |
|
163 |
||
9 | 164 |
$this->set_pagination_args( |
165 |
array( |
|
166 |
'total_items' => $api->info['results'], |
|
167 |
'per_page' => $args['per_page'], |
|
168 |
'infinite_scroll' => true, |
|
169 |
) |
|
170 |
); |
|
0 | 171 |
} |
172 |
||
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
173 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
174 |
*/ |
5 | 175 |
public function no_items() { |
0 | 176 |
_e( 'No themes match your request.' ); |
177 |
} |
|
178 |
||
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
179 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
180 |
* @global array $tabs |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
181 |
* @global string $tab |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
182 |
* @return array |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
183 |
*/ |
5 | 184 |
protected function get_views() { |
0 | 185 |
global $tabs, $tab; |
186 |
||
187 |
$display_tabs = array(); |
|
188 |
foreach ( (array) $tabs as $action => $text ) { |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
189 |
$display_tabs[ 'theme-install-' . $action ] = array( |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
190 |
'url' => self_admin_url( 'theme-install.php?tab=' . $action ), |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
191 |
'label' => $text, |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
192 |
'current' => $action === $tab, |
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
193 |
); |
0 | 194 |
} |
195 |
||
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
196 |
return $this->get_views_links( $display_tabs ); |
0 | 197 |
} |
198 |
||
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
199 |
/** |
16 | 200 |
* Displays the theme install table. |
201 |
* |
|
202 |
* Overrides the parent display() method to provide a different container. |
|
203 |
* |
|
204 |
* @since 3.1.0 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
205 |
*/ |
5 | 206 |
public function display() { |
9 | 207 |
wp_nonce_field( 'fetch-list-' . get_class( $this ), '_ajax_fetch_list_nonce' ); |
208 |
?> |
|
0 | 209 |
<div class="tablenav top themes"> |
210 |
<div class="alignleft actions"> |
|
5 | 211 |
<?php |
212 |
/** |
|
213 |
* Fires in the Install Themes list table header. |
|
214 |
* |
|
215 |
* @since 2.8.0 |
|
216 |
*/ |
|
217 |
do_action( 'install_themes_table_header' ); |
|
218 |
?> |
|
0 | 219 |
</div> |
220 |
<?php $this->pagination( 'top' ); ?> |
|
221 |
<br class="clear" /> |
|
222 |
</div> |
|
223 |
||
224 |
<div id="availablethemes"> |
|
225 |
<?php $this->display_rows_or_placeholder(); ?> |
|
226 |
</div> |
|
227 |
||
228 |
<?php |
|
5 | 229 |
$this->tablenav( 'bottom' ); |
0 | 230 |
} |
231 |
||
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
232 |
/** |
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
233 |
* Generates the list table rows. |
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
234 |
* |
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
235 |
* @since 3.1.0 |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
236 |
*/ |
5 | 237 |
public function display_rows() { |
0 | 238 |
$themes = $this->items; |
239 |
foreach ( $themes as $theme ) { |
|
9 | 240 |
?> |
241 |
<div class="available-theme installable-theme"> |
|
242 |
<?php |
|
0 | 243 |
$this->single_row( $theme ); |
9 | 244 |
?> |
245 |
</div> |
|
246 |
<?php |
|
16 | 247 |
} // End foreach $theme_names. |
0 | 248 |
|
249 |
$this->theme_installer(); |
|
250 |
} |
|
251 |
||
5 | 252 |
/** |
0 | 253 |
* Prints a theme from the WordPress.org API. |
254 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
255 |
* @since 3.1.0 |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
256 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
257 |
* @global array $themes_allowedtags |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
258 |
* |
19 | 259 |
* @param stdClass $theme { |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
260 |
* An object that contains theme data returned by the WordPress.org API. |
0 | 261 |
* |
18 | 262 |
* @type string $name Theme name, e.g. 'Twenty Twenty-One'. |
263 |
* @type string $slug Theme slug, e.g. 'twentytwentyone'. |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
264 |
* @type string $version Theme version, e.g. '1.1'. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
265 |
* @type string $author Theme author username, e.g. 'melchoyce'. |
18 | 266 |
* @type string $preview_url Preview URL, e.g. 'https://2021.wordpress.net/'. |
267 |
* @type string $screenshot_url Screenshot URL, e.g. 'https://wordpress.org/themes/twentytwentyone/'. |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
268 |
* @type float $rating Rating score. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
269 |
* @type int $num_ratings The number of ratings. |
18 | 270 |
* @type string $homepage Theme homepage, e.g. 'https://wordpress.org/themes/twentytwentyone/'. |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
271 |
* @type string $description Theme description. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
272 |
* @type string $download_link Theme ZIP download URL. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
273 |
* } |
0 | 274 |
*/ |
5 | 275 |
public function single_row( $theme ) { |
0 | 276 |
global $themes_allowedtags; |
277 |
||
9 | 278 |
if ( empty( $theme ) ) { |
0 | 279 |
return; |
9 | 280 |
} |
0 | 281 |
|
9 | 282 |
$name = wp_kses( $theme->name, $themes_allowedtags ); |
0 | 283 |
$author = wp_kses( $theme->author, $themes_allowedtags ); |
284 |
||
16 | 285 |
/* translators: %s: Theme name. */ |
9 | 286 |
$preview_title = sprintf( __( 'Preview “%s”' ), $name ); |
287 |
$preview_url = add_query_arg( |
|
288 |
array( |
|
289 |
'tab' => 'theme-information', |
|
290 |
'theme' => $theme->slug, |
|
291 |
), |
|
292 |
self_admin_url( 'theme-install.php' ) |
|
293 |
); |
|
0 | 294 |
|
295 |
$actions = array(); |
|
296 |
||
9 | 297 |
$install_url = add_query_arg( |
298 |
array( |
|
299 |
'action' => 'install-theme', |
|
300 |
'theme' => $theme->slug, |
|
301 |
), |
|
302 |
self_admin_url( 'update.php' ) |
|
303 |
); |
|
0 | 304 |
|
9 | 305 |
$update_url = add_query_arg( |
306 |
array( |
|
307 |
'action' => 'upgrade-theme', |
|
308 |
'theme' => $theme->slug, |
|
309 |
), |
|
310 |
self_admin_url( 'update.php' ) |
|
311 |
); |
|
0 | 312 |
|
313 |
$status = $this->_get_theme_status( $theme ); |
|
314 |
||
315 |
switch ( $status ) { |
|
316 |
case 'update_available': |
|
9 | 317 |
$actions[] = sprintf( |
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
318 |
'<a class="install-now" href="%s" aria-label="%s">%s</a>', |
9 | 319 |
esc_url( wp_nonce_url( $update_url, 'upgrade-theme_' . $theme->slug ) ), |
16 | 320 |
/* translators: %s: Theme version. */ |
9 | 321 |
esc_attr( sprintf( __( 'Update to version %s' ), $theme->version ) ), |
322 |
__( 'Update' ) |
|
323 |
); |
|
0 | 324 |
break; |
325 |
case 'newer_installed': |
|
326 |
case 'latest_installed': |
|
9 | 327 |
$actions[] = sprintf( |
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
328 |
'<span class="install-now">%s</span>', |
9 | 329 |
_x( 'Installed', 'theme' ) |
330 |
); |
|
0 | 331 |
break; |
5 | 332 |
case 'install': |
333 |
default: |
|
9 | 334 |
$actions[] = sprintf( |
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
335 |
'<a class="install-now" href="%s" aria-label="%s">%s</a>', |
9 | 336 |
esc_url( wp_nonce_url( $install_url, 'install-theme_' . $theme->slug ) ), |
16 | 337 |
/* translators: %s: Theme name. */ |
338 |
esc_attr( sprintf( _x( 'Install %s', 'theme' ), $name ) ), |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
339 |
_x( 'Install Now', 'theme' ) |
9 | 340 |
); |
5 | 341 |
break; |
0 | 342 |
} |
343 |
||
9 | 344 |
$actions[] = sprintf( |
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
345 |
'<a class="install-theme-preview" href="%s" aria-label="%s">%s</a>', |
9 | 346 |
esc_url( $preview_url ), |
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
347 |
esc_attr( $preview_title ), |
9 | 348 |
__( 'Preview' ) |
349 |
); |
|
0 | 350 |
|
5 | 351 |
/** |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
352 |
* Filters the install action links for a theme in the Install Themes list table. |
5 | 353 |
* |
354 |
* @since 3.4.0 |
|
355 |
* |
|
9 | 356 |
* @param string[] $actions An array of theme action links. Defaults are |
5 | 357 |
* links to Install Now, Preview, and Details. |
19 | 358 |
* @param stdClass $theme An object that contains theme data returned by the |
359 |
* WordPress.org API. |
|
5 | 360 |
*/ |
0 | 361 |
$actions = apply_filters( 'theme_install_actions', $actions, $theme ); |
362 |
||
363 |
?> |
|
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
364 |
<a class="screenshot install-theme-preview" href="<?php echo esc_url( $preview_url ); ?>" aria-label="<?php echo esc_attr( $preview_title ); ?>"> |
19 | 365 |
<img src="<?php echo esc_url( $theme->screenshot_url . '?ver=' . $theme->version ); ?>" width="150" alt="" /> |
0 | 366 |
</a> |
367 |
||
368 |
<h3><?php echo $name; ?></h3> |
|
9 | 369 |
<div class="theme-author"> |
370 |
<?php |
|
16 | 371 |
/* translators: %s: Theme author. */ |
9 | 372 |
printf( __( 'By %s' ), $author ); |
373 |
?> |
|
374 |
</div> |
|
0 | 375 |
|
376 |
<div class="action-links"> |
|
377 |
<ul> |
|
9 | 378 |
<?php foreach ( $actions as $action ) : ?> |
0 | 379 |
<li><?php echo $action; ?></li> |
380 |
<?php endforeach; ?> |
|
9 | 381 |
<li class="hide-if-no-js"><a href="#" class="theme-detail"><?php _e( 'Details' ); ?></a></li> |
0 | 382 |
</ul> |
383 |
</div> |
|
384 |
||
385 |
<?php |
|
386 |
$this->install_theme_info( $theme ); |
|
387 |
} |
|
388 |
||
5 | 389 |
/** |
0 | 390 |
* Prints the wrapper for the theme installer. |
391 |
*/ |
|
5 | 392 |
public function theme_installer() { |
0 | 393 |
?> |
394 |
<div id="theme-installer" class="wp-full-overlay expanded"> |
|
395 |
<div class="wp-full-overlay-sidebar"> |
|
396 |
<div class="wp-full-overlay-header"> |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
397 |
<a href="#" class="close-full-overlay button"><?php _e( 'Close' ); ?></a> |
5 | 398 |
<span class="theme-install"></span> |
0 | 399 |
</div> |
400 |
<div class="wp-full-overlay-sidebar-content"> |
|
401 |
<div class="install-theme-info"></div> |
|
402 |
</div> |
|
403 |
<div class="wp-full-overlay-footer"> |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
404 |
<button type="button" class="collapse-sidebar button" aria-expanded="true" aria-label="<?php esc_attr_e( 'Collapse Sidebar' ); ?>"> |
0 | 405 |
<span class="collapse-sidebar-arrow"></span> |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
406 |
<span class="collapse-sidebar-label"><?php _e( 'Collapse' ); ?></span> |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
407 |
</button> |
0 | 408 |
</div> |
409 |
</div> |
|
410 |
<div class="wp-full-overlay-main"></div> |
|
411 |
</div> |
|
412 |
<?php |
|
413 |
} |
|
414 |
||
5 | 415 |
/** |
0 | 416 |
* Prints the wrapper for the theme installer with a provided theme's data. |
417 |
* Used to make the theme installer work for no-js. |
|
418 |
* |
|
19 | 419 |
* @param stdClass $theme A WordPress.org Theme API object. |
0 | 420 |
*/ |
5 | 421 |
public function theme_installer_single( $theme ) { |
0 | 422 |
?> |
423 |
<div id="theme-installer" class="wp-full-overlay single-theme"> |
|
424 |
<div class="wp-full-overlay-sidebar"> |
|
425 |
<?php $this->install_theme_info( $theme ); ?> |
|
426 |
</div> |
|
427 |
<div class="wp-full-overlay-main"> |
|
428 |
<iframe src="<?php echo esc_url( $theme->preview_url ); ?>"></iframe> |
|
429 |
</div> |
|
430 |
</div> |
|
431 |
<?php |
|
432 |
} |
|
433 |
||
5 | 434 |
/** |
0 | 435 |
* Prints the info for a theme (to be used in the theme installer modal). |
436 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
437 |
* @global array $themes_allowedtags |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
438 |
* |
19 | 439 |
* @param stdClass $theme A WordPress.org Theme API object. |
0 | 440 |
*/ |
5 | 441 |
public function install_theme_info( $theme ) { |
0 | 442 |
global $themes_allowedtags; |
443 |
||
9 | 444 |
if ( empty( $theme ) ) { |
0 | 445 |
return; |
9 | 446 |
} |
0 | 447 |
|
9 | 448 |
$name = wp_kses( $theme->name, $themes_allowedtags ); |
0 | 449 |
$author = wp_kses( $theme->author, $themes_allowedtags ); |
450 |
||
9 | 451 |
$install_url = add_query_arg( |
452 |
array( |
|
453 |
'action' => 'install-theme', |
|
454 |
'theme' => $theme->slug, |
|
455 |
), |
|
456 |
self_admin_url( 'update.php' ) |
|
457 |
); |
|
0 | 458 |
|
9 | 459 |
$update_url = add_query_arg( |
460 |
array( |
|
461 |
'action' => 'upgrade-theme', |
|
462 |
'theme' => $theme->slug, |
|
463 |
), |
|
464 |
self_admin_url( 'update.php' ) |
|
465 |
); |
|
0 | 466 |
|
467 |
$status = $this->_get_theme_status( $theme ); |
|
468 |
||
469 |
?> |
|
9 | 470 |
<div class="install-theme-info"> |
471 |
<?php |
|
472 |
switch ( $status ) { |
|
473 |
case 'update_available': |
|
474 |
printf( |
|
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
475 |
'<a class="theme-install button button-primary" href="%s" aria-label="%s">%s</a>', |
9 | 476 |
esc_url( wp_nonce_url( $update_url, 'upgrade-theme_' . $theme->slug ) ), |
16 | 477 |
/* translators: %s: Theme version. */ |
9 | 478 |
esc_attr( sprintf( __( 'Update to version %s' ), $theme->version ) ), |
479 |
__( 'Update' ) |
|
480 |
); |
|
481 |
break; |
|
482 |
case 'newer_installed': |
|
483 |
case 'latest_installed': |
|
484 |
printf( |
|
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
485 |
'<span class="theme-install">%s</span>', |
9 | 486 |
_x( 'Installed', 'theme' ) |
487 |
); |
|
488 |
break; |
|
489 |
case 'install': |
|
490 |
default: |
|
491 |
printf( |
|
492 |
'<a class="theme-install button button-primary" href="%s">%s</a>', |
|
493 |
esc_url( wp_nonce_url( $install_url, 'install-theme_' . $theme->slug ) ), |
|
494 |
__( 'Install' ) |
|
495 |
); |
|
496 |
break; |
|
497 |
} |
|
498 |
?> |
|
0 | 499 |
<h3 class="theme-name"><?php echo $name; ?></h3> |
9 | 500 |
<span class="theme-by"> |
501 |
<?php |
|
16 | 502 |
/* translators: %s: Theme author. */ |
9 | 503 |
printf( __( 'By %s' ), $author ); |
504 |
?> |
|
505 |
</span> |
|
506 |
<?php if ( isset( $theme->screenshot_url ) ) : ?> |
|
19 | 507 |
<img class="theme-screenshot" src="<?php echo esc_url( $theme->screenshot_url . '?ver=' . $theme->version ); ?>" alt="" /> |
0 | 508 |
<?php endif; ?> |
509 |
<div class="theme-details"> |
|
9 | 510 |
<?php |
511 |
wp_star_rating( |
|
512 |
array( |
|
513 |
'rating' => $theme->rating, |
|
514 |
'type' => 'percent', |
|
515 |
'number' => $theme->num_ratings, |
|
516 |
) |
|
517 |
); |
|
518 |
?> |
|
0 | 519 |
<div class="theme-version"> |
9 | 520 |
<strong><?php _e( 'Version:' ); ?> </strong> |
0 | 521 |
<?php echo wp_kses( $theme->version, $themes_allowedtags ); ?> |
522 |
</div> |
|
523 |
<div class="theme-description"> |
|
524 |
<?php echo wp_kses( $theme->description, $themes_allowedtags ); ?> |
|
525 |
</div> |
|
526 |
</div> |
|
527 |
<input class="theme-preview-url" type="hidden" value="<?php echo esc_url( $theme->preview_url ); ?>" /> |
|
528 |
</div> |
|
529 |
<?php |
|
530 |
} |
|
531 |
||
532 |
/** |
|
533 |
* Send required variables to JavaScript land |
|
534 |
* |
|
5 | 535 |
* @since 3.4.0 |
0 | 536 |
* |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
537 |
* @global string $tab Current tab within Themes->Install screen |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
538 |
* @global string $type Type of search. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
539 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
540 |
* @param array $extra_args Unused. |
0 | 541 |
*/ |
5 | 542 |
public function _js_vars( $extra_args = array() ) { |
0 | 543 |
global $tab, $type; |
544 |
parent::_js_vars( compact( 'tab', 'type' ) ); |
|
545 |
} |
|
546 |
||
547 |
/** |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
548 |
* Checks to see if the theme is already installed. |
0 | 549 |
* |
5 | 550 |
* @since 3.4.0 |
0 | 551 |
* |
19 | 552 |
* @param stdClass $theme A WordPress.org Theme API object. |
0 | 553 |
* @return string Theme status. |
554 |
*/ |
|
555 |
private function _get_theme_status( $theme ) { |
|
556 |
$status = 'install'; |
|
557 |
||
558 |
$installed_theme = wp_get_theme( $theme->slug ); |
|
559 |
if ( $installed_theme->exists() ) { |
|
9 | 560 |
if ( version_compare( $installed_theme->get( 'Version' ), $theme->version, '=' ) ) { |
0 | 561 |
$status = 'latest_installed'; |
9 | 562 |
} elseif ( version_compare( $installed_theme->get( 'Version' ), $theme->version, '>' ) ) { |
0 | 563 |
$status = 'newer_installed'; |
9 | 564 |
} else { |
0 | 565 |
$status = 'update_available'; |
9 | 566 |
} |
0 | 567 |
} |
568 |
||
569 |
return $status; |
|
570 |
} |
|
571 |
} |