| 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 |
/** |
|
3 |
* WordPress Theme Administration API |
|
4 |
* |
|
5 |
* @package WordPress |
|
6 |
* @subpackage Administration |
|
7 |
*/ |
|
8 |
||
9 |
/** |
|
| 19 | 10 |
* Removes a theme. |
| 0 | 11 |
* |
12 |
* @since 2.8.0 |
|
13 |
* |
|
| 9 | 14 |
* @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass. |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
15 |
* |
| 9 | 16 |
* @param string $stylesheet Stylesheet of the theme to delete. |
17 |
* @param string $redirect Redirect to page when complete. |
|
18 |
* @return bool|null|WP_Error True on success, false if `$stylesheet` is empty, WP_Error on failure. |
|
19 |
* Null if filesystem credentials are required to proceed. |
|
| 0 | 20 |
*/ |
| 9 | 21 |
function delete_theme( $stylesheet, $redirect = '' ) { |
| 0 | 22 |
global $wp_filesystem; |
23 |
||
| 9 | 24 |
if ( empty( $stylesheet ) ) { |
| 0 | 25 |
return false; |
| 9 | 26 |
} |
| 0 | 27 |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
28 |
if ( empty( $redirect ) ) { |
| 9 | 29 |
$redirect = wp_nonce_url( 'themes.php?action=delete&stylesheet=' . urlencode( $stylesheet ), 'delete-theme_' . $stylesheet ); |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
30 |
} |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
31 |
|
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
32 |
ob_start(); |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
33 |
$credentials = request_filesystem_credentials( $redirect ); |
| 9 | 34 |
$data = ob_get_clean(); |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
35 |
|
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
36 |
if ( false === $credentials ) { |
| 9 | 37 |
if ( ! empty( $data ) ) { |
| 16 | 38 |
require_once ABSPATH . 'wp-admin/admin-header.php'; |
| 0 | 39 |
echo $data; |
| 16 | 40 |
require_once ABSPATH . 'wp-admin/admin-footer.php'; |
| 0 | 41 |
exit; |
42 |
} |
|
43 |
return; |
|
44 |
} |
|
45 |
||
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
46 |
if ( ! WP_Filesystem( $credentials ) ) { |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
47 |
ob_start(); |
| 16 | 48 |
// Failed to connect. Error and request again. |
49 |
request_filesystem_credentials( $redirect, '', true ); |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
50 |
$data = ob_get_clean(); |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
51 |
|
| 9 | 52 |
if ( ! empty( $data ) ) { |
| 16 | 53 |
require_once ABSPATH . 'wp-admin/admin-header.php'; |
| 0 | 54 |
echo $data; |
| 16 | 55 |
require_once ABSPATH . 'wp-admin/admin-footer.php'; |
| 0 | 56 |
exit; |
57 |
} |
|
58 |
return; |
|
59 |
} |
|
60 |
||
| 9 | 61 |
if ( ! is_object( $wp_filesystem ) ) { |
62 |
return new WP_Error( 'fs_unavailable', __( 'Could not access filesystem.' ) ); |
|
63 |
} |
|
| 0 | 64 |
|
| 9 | 65 |
if ( is_wp_error( $wp_filesystem->errors ) && $wp_filesystem->errors->has_errors() ) { |
66 |
return new WP_Error( 'fs_error', __( 'Filesystem error.' ), $wp_filesystem->errors ); |
|
67 |
} |
|
| 0 | 68 |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
69 |
// Get the base theme folder. |
| 0 | 70 |
$themes_dir = $wp_filesystem->wp_themes_dir(); |
| 5 | 71 |
if ( empty( $themes_dir ) ) { |
72 |
return new WP_Error( 'fs_no_themes_dir', __( 'Unable to locate WordPress theme directory.' ) ); |
|
73 |
} |
|
| 0 | 74 |
|
| 18 | 75 |
/** |
76 |
* Fires immediately before a theme deletion attempt. |
|
77 |
* |
|
78 |
* @since 5.8.0 |
|
79 |
* |
|
80 |
* @param string $stylesheet Stylesheet of the theme to delete. |
|
81 |
*/ |
|
82 |
do_action( 'delete_theme', $stylesheet ); |
|
83 |
||
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
84 |
$theme = wp_get_theme( $stylesheet ); |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
85 |
|
| 0 | 86 |
$themes_dir = trailingslashit( $themes_dir ); |
| 9 | 87 |
$theme_dir = trailingslashit( $themes_dir . $stylesheet ); |
88 |
$deleted = $wp_filesystem->delete( $theme_dir, true ); |
|
| 5 | 89 |
|
| 18 | 90 |
/** |
91 |
* Fires immediately after a theme deletion attempt. |
|
92 |
* |
|
93 |
* @since 5.8.0 |
|
94 |
* |
|
95 |
* @param string $stylesheet Stylesheet of the theme to delete. |
|
96 |
* @param bool $deleted Whether the theme deletion was successful. |
|
97 |
*/ |
|
98 |
do_action( 'deleted_theme', $stylesheet, $deleted ); |
|
99 |
||
| 5 | 100 |
if ( ! $deleted ) { |
| 16 | 101 |
return new WP_Error( |
102 |
'could_not_remove_theme', |
|
103 |
/* translators: %s: Theme name. */ |
|
104 |
sprintf( __( 'Could not fully remove the theme %s.' ), $stylesheet ) |
|
105 |
); |
|
| 5 | 106 |
} |
107 |
||
108 |
$theme_translations = wp_get_installed_translations( 'themes' ); |
|
| 0 | 109 |
|
| 5 | 110 |
// Remove language files, silently. |
111 |
if ( ! empty( $theme_translations[ $stylesheet ] ) ) { |
|
112 |
$translations = $theme_translations[ $stylesheet ]; |
|
| 0 | 113 |
|
| 5 | 114 |
foreach ( $translations as $translation => $data ) { |
115 |
$wp_filesystem->delete( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '.po' ); |
|
116 |
$wp_filesystem->delete( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '.mo' ); |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
117 |
$wp_filesystem->delete( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '.l10n.php' ); |
| 9 | 118 |
|
119 |
$json_translation_files = glob( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '-*.json' ); |
|
120 |
if ( $json_translation_files ) { |
|
121 |
array_map( array( $wp_filesystem, 'delete' ), $json_translation_files ); |
|
122 |
} |
|
| 5 | 123 |
} |
124 |
} |
|
125 |
||
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
126 |
// Remove the theme from allowed themes on the network. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
127 |
if ( is_multisite() ) { |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
128 |
WP_Theme::network_disable_theme( $stylesheet ); |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
129 |
} |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
130 |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
131 |
// Clear theme caches. |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
132 |
$theme->cache_delete(); |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
133 |
|
| 5 | 134 |
// Force refresh of theme update information. |
135 |
delete_site_transient( 'update_themes' ); |
|
| 0 | 136 |
|
137 |
return true; |
|
138 |
} |
|
139 |
||
140 |
/** |
|
| 16 | 141 |
* Gets the page templates available in this theme. |
| 0 | 142 |
* |
143 |
* @since 1.5.0 |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
144 |
* @since 4.7.0 Added the `$post_type` parameter. |
| 0 | 145 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
146 |
* @param WP_Post|null $post Optional. The post being edited, provided for context. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
147 |
* @param string $post_type Optional. Post type to get the templates for. Default 'page'. |
| 16 | 148 |
* @return string[] Array of template file names keyed by the template header name. |
| 0 | 149 |
*/ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
150 |
function get_page_templates( $post = null, $post_type = 'page' ) { |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
151 |
return array_flip( wp_get_theme()->get_page_templates( $post, $post_type ) ); |
| 0 | 152 |
} |
153 |
||
154 |
/** |
|
| 19 | 155 |
* Tidies a filename for url display by the theme file editor. |
| 0 | 156 |
* |
157 |
* @since 2.9.0 |
|
158 |
* @access private |
|
159 |
* |
|
160 |
* @param string $fullpath Full path to the theme file |
|
161 |
* @param string $containingfolder Path of the theme parent folder |
|
162 |
* @return string |
|
163 |
*/ |
|
| 9 | 164 |
function _get_template_edit_filename( $fullpath, $containingfolder ) { |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
165 |
return str_replace( dirname( $containingfolder, 2 ), '', $fullpath ); |
| 0 | 166 |
} |
167 |
||
168 |
/** |
|
169 |
* Check if there is an update for a theme available. |
|
170 |
* |
|
171 |
* Will display link, if there is an update available. |
|
172 |
* |
|
173 |
* @since 2.7.0 |
|
| 16 | 174 |
* |
| 5 | 175 |
* @see get_theme_update_available() |
| 0 | 176 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
177 |
* @param WP_Theme $theme Theme data object. |
| 0 | 178 |
*/ |
179 |
function theme_update_available( $theme ) { |
|
| 5 | 180 |
echo get_theme_update_available( $theme ); |
181 |
} |
|
182 |
||
183 |
/** |
|
| 19 | 184 |
* Retrieves the update link if there is a theme update available. |
| 5 | 185 |
* |
186 |
* Will return a link if there is an update available. |
|
187 |
* |
|
188 |
* @since 3.8.0 |
|
189 |
* |
|
190 |
* @param WP_Theme $theme WP_Theme object. |
|
| 16 | 191 |
* @return string|false HTML for the update link, or false if invalid info was passed. |
| 5 | 192 |
*/ |
193 |
function get_theme_update_available( $theme ) { |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
194 |
static $themes_update = null; |
| 0 | 195 |
|
| 9 | 196 |
if ( ! current_user_can( 'update_themes' ) ) { |
| 5 | 197 |
return false; |
| 9 | 198 |
} |
| 0 | 199 |
|
| 9 | 200 |
if ( ! isset( $themes_update ) ) { |
201 |
$themes_update = get_site_transient( 'update_themes' ); |
|
202 |
} |
|
| 0 | 203 |
|
| 5 | 204 |
if ( ! ( $theme instanceof WP_Theme ) ) { |
205 |
return false; |
|
206 |
} |
|
| 0 | 207 |
|
208 |
$stylesheet = $theme->get_stylesheet(); |
|
209 |
||
| 5 | 210 |
$html = ''; |
211 |
||
| 9 | 212 |
if ( isset( $themes_update->response[ $stylesheet ] ) ) { |
213 |
$update = $themes_update->response[ $stylesheet ]; |
|
214 |
$theme_name = $theme->display( 'Name' ); |
|
215 |
$details_url = add_query_arg( |
|
216 |
array( |
|
217 |
'TB_iframe' => 'true', |
|
218 |
'width' => 1024, |
|
219 |
'height' => 800, |
|
220 |
), |
|
221 |
$update['url'] |
|
| 16 | 222 |
); // Theme browser inside WP? Replace this. Also, theme preview JS will override this on the available list. |
| 9 | 223 |
$update_url = wp_nonce_url( admin_url( 'update.php?action=upgrade-theme&theme=' . urlencode( $stylesheet ) ), 'upgrade-theme_' . $stylesheet ); |
| 0 | 224 |
|
| 9 | 225 |
if ( ! is_multisite() ) { |
226 |
if ( ! current_user_can( 'update_themes' ) ) { |
|
227 |
$html = sprintf( |
|
| 16 | 228 |
/* translators: 1: Theme name, 2: Theme details URL, 3: Additional link attributes, 4: Version number. */ |
| 9 | 229 |
'<p><strong>' . __( 'There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a>.' ) . '</strong></p>', |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
230 |
$theme_name, |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
231 |
esc_url( $details_url ), |
| 9 | 232 |
sprintf( |
233 |
'class="thickbox open-plugin-details-modal" aria-label="%s"', |
|
| 16 | 234 |
/* translators: 1: Theme name, 2: Version number. */ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
235 |
esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme_name, $update['new_version'] ) ) |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
236 |
), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
237 |
$update['new_version'] |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
238 |
); |
| 5 | 239 |
} elseif ( empty( $update['package'] ) ) { |
| 9 | 240 |
$html = sprintf( |
| 16 | 241 |
/* translators: 1: Theme name, 2: Theme details URL, 3: Additional link attributes, 4: Version number. */ |
| 9 | 242 |
'<p><strong>' . __( 'There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a>. <em>Automatic update is unavailable for this theme.</em>' ) . '</strong></p>', |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
243 |
$theme_name, |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
244 |
esc_url( $details_url ), |
| 9 | 245 |
sprintf( |
246 |
'class="thickbox open-plugin-details-modal" aria-label="%s"', |
|
| 16 | 247 |
/* translators: 1: Theme name, 2: Version number. */ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
248 |
esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme_name, $update['new_version'] ) ) |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
249 |
), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
250 |
$update['new_version'] |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
251 |
); |
| 5 | 252 |
} else { |
| 9 | 253 |
$html = sprintf( |
| 16 | 254 |
/* translators: 1: Theme name, 2: Theme details URL, 3: Additional link attributes, 4: Version number, 5: Update URL, 6: Additional link attributes. */ |
| 9 | 255 |
'<p><strong>' . __( 'There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a> or <a href="%5$s" %6$s>update now</a>.' ) . '</strong></p>', |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
256 |
$theme_name, |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
257 |
esc_url( $details_url ), |
| 9 | 258 |
sprintf( |
259 |
'class="thickbox open-plugin-details-modal" aria-label="%s"', |
|
| 16 | 260 |
/* translators: 1: Theme name, 2: Version number. */ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
261 |
esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme_name, $update['new_version'] ) ) |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
262 |
), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
263 |
$update['new_version'], |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
264 |
$update_url, |
| 9 | 265 |
sprintf( |
266 |
'aria-label="%s" id="update-theme" data-slug="%s"', |
|
| 16 | 267 |
/* translators: %s: Theme name. */ |
268 |
esc_attr( sprintf( _x( 'Update %s now', 'theme' ), $theme_name ) ), |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
269 |
$stylesheet |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
270 |
) |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
271 |
); |
| 5 | 272 |
} |
| 0 | 273 |
} |
274 |
} |
|
| 5 | 275 |
|
276 |
return $html; |
|
| 0 | 277 |
} |
278 |
||
279 |
/** |
|
| 19 | 280 |
* Retrieves list of WordPress theme features (aka theme tags). |
| 0 | 281 |
* |
282 |
* @since 3.1.0 |
|
| 16 | 283 |
* @since 3.2.0 Added 'Gray' color and 'Featured Image Header', 'Featured Images', |
284 |
* 'Full Width Template', and 'Post Formats' features. |
|
285 |
* @since 3.5.0 Added 'Flexible Header' feature. |
|
286 |
* @since 3.8.0 Renamed 'Width' filter to 'Layout'. |
|
287 |
* @since 3.8.0 Renamed 'Fixed Width' and 'Flexible Width' options |
|
288 |
* to 'Fixed Layout' and 'Fluid Layout'. |
|
289 |
* @since 3.8.0 Added 'Accessibility Ready' feature and 'Responsive Layout' option. |
|
290 |
* @since 3.9.0 Combined 'Layout' and 'Columns' filters. |
|
291 |
* @since 4.6.0 Removed 'Colors' filter. |
|
292 |
* @since 4.6.0 Added 'Grid Layout' option. |
|
293 |
* Removed 'Fixed Layout', 'Fluid Layout', and 'Responsive Layout' options. |
|
294 |
* @since 4.6.0 Added 'Custom Logo' and 'Footer Widgets' features. |
|
295 |
* Removed 'Blavatar' feature. |
|
296 |
* @since 4.6.0 Added 'Blog', 'E-Commerce', 'Education', 'Entertainment', 'Food & Drink', |
|
297 |
* 'Holiday', 'News', 'Photography', and 'Portfolio' subjects. |
|
298 |
* Removed 'Photoblogging' and 'Seasonal' subjects. |
|
299 |
* @since 4.9.0 Reordered the filters from 'Layout', 'Features', 'Subject' |
|
300 |
* to 'Subject', 'Features', 'Layout'. |
|
301 |
* @since 4.9.0 Removed 'BuddyPress', 'Custom Menu', 'Flexible Header', |
|
302 |
* 'Front Page Posting', 'Microformats', 'RTL Language Support', |
|
303 |
* 'Threaded Comments', and 'Translation Ready' features. |
|
304 |
* @since 5.5.0 Added 'Block Editor Patterns', 'Block Editor Styles', |
|
305 |
* and 'Full Site Editing' features. |
|
306 |
* @since 5.5.0 Added 'Wide Blocks' layout option. |
|
| 18 | 307 |
* @since 5.8.1 Added 'Template Editing' feature. |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
308 |
* @since 6.1.1 Replaced 'Full Site Editing' feature name with 'Site Editor'. |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
309 |
* @since 6.2.0 Added 'Style Variations' feature. |
| 0 | 310 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
311 |
* @param bool $api Optional. Whether try to fetch tags from the WordPress.org API. Defaults to true. |
| 0 | 312 |
* @return array Array of features keyed by category with translations keyed by slug. |
313 |
*/ |
|
314 |
function get_theme_feature_list( $api = true ) { |
|
| 16 | 315 |
// Hard-coded list is used if API is not accessible. |
| 0 | 316 |
$features = array( |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
317 |
|
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
318 |
__( 'Subject' ) => array( |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
319 |
'blog' => __( 'Blog' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
320 |
'e-commerce' => __( 'E-Commerce' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
321 |
'education' => __( 'Education' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
322 |
'entertainment' => __( 'Entertainment' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
323 |
'food-and-drink' => __( 'Food & Drink' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
324 |
'holiday' => __( 'Holiday' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
325 |
'news' => __( 'News' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
326 |
'photography' => __( 'Photography' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
327 |
'portfolio' => __( 'Portfolio' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
328 |
), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
329 |
|
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
330 |
__( 'Features' ) => array( |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
331 |
'accessibility-ready' => __( 'Accessibility Ready' ), |
| 16 | 332 |
'block-patterns' => __( 'Block Editor Patterns' ), |
333 |
'block-styles' => __( 'Block Editor Styles' ), |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
334 |
'custom-background' => __( 'Custom Background' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
335 |
'custom-colors' => __( 'Custom Colors' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
336 |
'custom-header' => __( 'Custom Header' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
337 |
'custom-logo' => __( 'Custom Logo' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
338 |
'editor-style' => __( 'Editor Style' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
339 |
'featured-image-header' => __( 'Featured Image Header' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
340 |
'featured-images' => __( 'Featured Images' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
341 |
'footer-widgets' => __( 'Footer Widgets' ), |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
342 |
'full-site-editing' => __( 'Site Editor' ), |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
343 |
'full-width-template' => __( 'Full Width Template' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
344 |
'post-formats' => __( 'Post Formats' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
345 |
'sticky-post' => __( 'Sticky Post' ), |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
346 |
'style-variations' => __( 'Style Variations' ), |
| 18 | 347 |
'template-editing' => __( 'Template Editing' ), |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
348 |
'theme-options' => __( 'Theme Options' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
349 |
), |
| 0 | 350 |
|
| 9 | 351 |
__( 'Layout' ) => array( |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
352 |
'grid-layout' => __( 'Grid Layout' ), |
| 0 | 353 |
'one-column' => __( 'One Column' ), |
354 |
'two-columns' => __( 'Two Columns' ), |
|
355 |
'three-columns' => __( 'Three Columns' ), |
|
356 |
'four-columns' => __( 'Four Columns' ), |
|
357 |
'left-sidebar' => __( 'Left Sidebar' ), |
|
358 |
'right-sidebar' => __( 'Right Sidebar' ), |
|
| 16 | 359 |
'wide-blocks' => __( 'Wide Blocks' ), |
| 9 | 360 |
), |
| 0 | 361 |
|
362 |
); |
|
363 |
||
| 9 | 364 |
if ( ! $api || ! current_user_can( 'install_themes' ) ) { |
| 0 | 365 |
return $features; |
| 9 | 366 |
} |
| 0 | 367 |
|
| 16 | 368 |
$feature_list = get_site_transient( 'wporg_theme_feature_list' ); |
369 |
if ( ! $feature_list ) { |
|
| 5 | 370 |
set_site_transient( 'wporg_theme_feature_list', array(), 3 * HOUR_IN_SECONDS ); |
| 0 | 371 |
} |
372 |
||
| 9 | 373 |
if ( ! $feature_list ) { |
374 |
$feature_list = themes_api( 'feature_list', array() ); |
|
375 |
if ( is_wp_error( $feature_list ) ) { |
|
376 |
return $features; |
|
377 |
} |
|
378 |
} |
|
379 |
||
380 |
if ( ! $feature_list ) { |
|
| 0 | 381 |
return $features; |
| 9 | 382 |
} |
| 0 | 383 |
|
| 5 | 384 |
set_site_transient( 'wporg_theme_feature_list', $feature_list, 3 * HOUR_IN_SECONDS ); |
| 0 | 385 |
|
| 5 | 386 |
$category_translations = array( |
387 |
'Layout' => __( 'Layout' ), |
|
388 |
'Features' => __( 'Features' ), |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
389 |
'Subject' => __( 'Subject' ), |
| 5 | 390 |
); |
| 0 | 391 |
|
392 |
$wporg_features = array(); |
|
| 16 | 393 |
|
394 |
// Loop over the wp.org canonical list and apply translations. |
|
| 0 | 395 |
foreach ( (array) $feature_list as $feature_category => $feature_items ) { |
| 9 | 396 |
if ( isset( $category_translations[ $feature_category ] ) ) { |
397 |
$feature_category = $category_translations[ $feature_category ]; |
|
398 |
} |
|
| 16 | 399 |
|
| 9 | 400 |
$wporg_features[ $feature_category ] = array(); |
| 0 | 401 |
|
402 |
foreach ( $feature_items as $feature ) { |
|
| 9 | 403 |
if ( isset( $features[ $feature_category ][ $feature ] ) ) { |
404 |
$wporg_features[ $feature_category ][ $feature ] = $features[ $feature_category ][ $feature ]; |
|
405 |
} else { |
|
406 |
$wporg_features[ $feature_category ][ $feature ] = $feature; |
|
407 |
} |
|
| 0 | 408 |
} |
409 |
} |
|
410 |
||
411 |
return $wporg_features; |
|
412 |
} |
|
413 |
||
414 |
/** |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
415 |
* Retrieves theme installer pages from the WordPress.org Themes API. |
| 0 | 416 |
* |
417 |
* It is possible for a theme to override the Themes API result with three |
|
418 |
* filters. Assume this is for themes, which can extend on the Theme Info to |
|
419 |
* offer more choices. This is very powerful and must be used with care, when |
|
| 5 | 420 |
* overriding the filters. |
| 0 | 421 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
422 |
* The first filter, {@see 'themes_api_args'}, is for the args and gives the action |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
423 |
* as the second parameter. The hook for {@see 'themes_api_args'} must ensure that |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
424 |
* an object is returned. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
425 |
* |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
426 |
* The second filter, {@see 'themes_api'}, allows a plugin to override the WordPress.org |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
427 |
* Theme API entirely. If `$action` is 'query_themes', 'theme_information', or 'feature_list', |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
428 |
* an object MUST be passed. If `$action` is 'hot_tags', an array should be passed. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
429 |
* |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
430 |
* Finally, the third filter, {@see 'themes_api_result'}, makes it possible to filter the |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
431 |
* response object or array, depending on the `$action` type. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
432 |
* |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
433 |
* Supported arguments per action: |
| 0 | 434 |
* |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
435 |
* | Argument Name | 'query_themes' | 'theme_information' | 'hot_tags' | 'feature_list' | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
436 |
* | -------------------| :------------: | :-----------------: | :--------: | :--------------: | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
437 |
* | `$slug` | No | Yes | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
438 |
* | `$per_page` | Yes | No | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
439 |
* | `$page` | Yes | No | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
440 |
* | `$number` | No | No | Yes | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
441 |
* | `$search` | Yes | No | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
442 |
* | `$tag` | Yes | No | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
443 |
* | `$author` | Yes | No | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
444 |
* | `$user` | Yes | No | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
445 |
* | `$browse` | Yes | No | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
446 |
* | `$locale` | Yes | Yes | No | No | |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
447 |
* | `$fields` | Yes | Yes | No | No | |
| 0 | 448 |
* |
449 |
* @since 2.8.0 |
|
450 |
* |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
451 |
* @param string $action API action to perform: Accepts 'query_themes', 'theme_information', |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
452 |
* 'hot_tags' or 'feature_list'. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
453 |
* @param array|object $args { |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
454 |
* Optional. Array or object of arguments to serialize for the Themes API. Default empty array. |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
455 |
* |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
456 |
* @type string $slug The theme slug. Default empty. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
457 |
* @type int $per_page Number of themes per page. Default 24. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
458 |
* @type int $page Number of current page. Default 1. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
459 |
* @type int $number Number of tags to be queried. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
460 |
* @type string $search A search term. Default empty. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
461 |
* @type string $tag Tag to filter themes. Default empty. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
462 |
* @type string $author Username of an author to filter themes. Default empty. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
463 |
* @type string $user Username to query for their favorites. Default empty. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
464 |
* @type string $browse Browse view: 'featured', 'popular', 'updated', 'favorites'. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
465 |
* @type string $locale Locale to provide context-sensitive results. Default is the value of get_locale(). |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
466 |
* @type array $fields { |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
467 |
* Array of fields which should or should not be returned. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
468 |
* |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
469 |
* @type bool $description Whether to return the theme full description. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
470 |
* @type bool $sections Whether to return the theme readme sections: description, installation, |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
471 |
* FAQ, screenshots, other notes, and changelog. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
472 |
* @type bool $rating Whether to return the rating in percent and total number of ratings. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
473 |
* Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
474 |
* @type bool $ratings Whether to return the number of rating for each star (1-5). Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
475 |
* @type bool $downloaded Whether to return the download count. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
476 |
* @type bool $downloadlink Whether to return the download link for the package. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
477 |
* @type bool $last_updated Whether to return the date of the last update. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
478 |
* @type bool $tags Whether to return the assigned tags. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
479 |
* @type bool $homepage Whether to return the theme homepage link. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
480 |
* @type bool $screenshots Whether to return the screenshots. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
481 |
* @type int $screenshot_count Number of screenshots to return. Default 1. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
482 |
* @type bool $screenshot_url Whether to return the URL of the first screenshot. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
483 |
* @type bool $photon_screenshots Whether to return the screenshots via Photon. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
484 |
* @type bool $template Whether to return the slug of the parent theme. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
485 |
* @type bool $parent Whether to return the slug, name and homepage of the parent theme. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
486 |
* @type bool $versions Whether to return the list of all available versions. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
487 |
* @type bool $theme_url Whether to return theme's URL. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
488 |
* @type bool $extended_author Whether to return nicename or nicename and display name. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
489 |
* } |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
490 |
* } |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
491 |
* @return object|array|WP_Error Response object or array on success, WP_Error on failure. See the |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
492 |
* {@link https://developer.wordpress.org/reference/functions/themes_api/ function reference article} |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
493 |
* for more information on the make-up of possible return objects depending on the value of `$action`. |
| 0 | 494 |
*/ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
495 |
function themes_api( $action, $args = array() ) { |
| 5 | 496 |
if ( is_array( $args ) ) { |
497 |
$args = (object) $args; |
|
498 |
} |
|
| 0 | 499 |
|
| 16 | 500 |
if ( 'query_themes' === $action ) { |
| 9 | 501 |
if ( ! isset( $args->per_page ) ) { |
502 |
$args->per_page = 24; |
|
503 |
} |
|
| 5 | 504 |
} |
505 |
||
506 |
if ( ! isset( $args->locale ) ) { |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
507 |
$args->locale = get_user_locale(); |
| 5 | 508 |
} |
| 0 | 509 |
|
| 9 | 510 |
if ( ! isset( $args->wp_version ) ) { |
|
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
511 |
$args->wp_version = substr( wp_get_wp_version(), 0, 3 ); // x.y |
| 9 | 512 |
} |
513 |
||
| 5 | 514 |
/** |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
515 |
* Filters arguments used to query for installer pages from the WordPress.org Themes API. |
| 5 | 516 |
* |
517 |
* Important: An object MUST be returned to this filter. |
|
518 |
* |
|
519 |
* @since 2.8.0 |
|
520 |
* |
|
521 |
* @param object $args Arguments used to query for installer pages from the WordPress.org Themes API. |
|
522 |
* @param string $action Requested action. Likely values are 'theme_information', |
|
523 |
* 'feature_list', or 'query_themes'. |
|
524 |
*/ |
|
525 |
$args = apply_filters( 'themes_api_args', $args, $action ); |
|
| 0 | 526 |
|
| 5 | 527 |
/** |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
528 |
* Filters whether to override the WordPress.org Themes API. |
| 5 | 529 |
* |
| 19 | 530 |
* Returning a non-false value will effectively short-circuit the WordPress.org API request. |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
531 |
* |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
532 |
* If `$action` is 'query_themes', 'theme_information', or 'feature_list', an object MUST |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
533 |
* be passed. If `$action` is 'hot_tags', an array should be passed. |
| 5 | 534 |
* |
535 |
* @since 2.8.0 |
|
536 |
* |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
537 |
* @param false|object|array $override Whether to override the WordPress.org Themes API. Default false. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
538 |
* @param string $action Requested action. Likely values are 'theme_information', |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
539 |
* 'feature_list', or 'query_themes'. |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
540 |
* @param object $args Arguments used to query for installer pages from the Themes API. |
| 5 | 541 |
*/ |
542 |
$res = apply_filters( 'themes_api', false, $action, $args ); |
|
| 0 | 543 |
|
544 |
if ( ! $res ) { |
|
| 9 | 545 |
$url = 'http://api.wordpress.org/themes/info/1.2/'; |
546 |
$url = add_query_arg( |
|
547 |
array( |
|
548 |
'action' => $action, |
|
549 |
'request' => $args, |
|
550 |
), |
|
551 |
$url |
|
552 |
); |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
553 |
|
| 9 | 554 |
$http_url = $url; |
| 16 | 555 |
$ssl = wp_http_supports( array( 'ssl' ) ); |
556 |
if ( $ssl ) { |
|
| 0 | 557 |
$url = set_url_scheme( $url, 'https' ); |
| 9 | 558 |
} |
| 0 | 559 |
|
| 5 | 560 |
$http_args = array( |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
561 |
'timeout' => 15, |
|
22
8c2e4d02f4ef
Update WordPress to latest version (6.7)
ymh <ymh.work@gmail.com>
parents:
21
diff
changeset
|
562 |
'user-agent' => 'WordPress/' . wp_get_wp_version() . '; ' . home_url( '/' ), |
| 0 | 563 |
); |
| 9 | 564 |
$request = wp_remote_get( $url, $http_args ); |
| 0 | 565 |
|
566 |
if ( $ssl && is_wp_error( $request ) ) { |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
567 |
if ( ! wp_doing_ajax() ) { |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
568 |
wp_trigger_error( |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
569 |
__FUNCTION__, |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
570 |
sprintf( |
| 16 | 571 |
/* translators: %s: Support forums URL. */ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
572 |
__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server’s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ), |
| 16 | 573 |
__( 'https://wordpress.org/support/forums/' ) |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
574 |
) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
575 |
headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
576 |
); |
| 5 | 577 |
} |
| 9 | 578 |
$request = wp_remote_get( $http_url, $http_args ); |
| 0 | 579 |
} |
580 |
||
| 9 | 581 |
if ( is_wp_error( $request ) ) { |
582 |
$res = new WP_Error( |
|
583 |
'themes_api_failed', |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
584 |
sprintf( |
| 16 | 585 |
/* translators: %s: Support forums URL. */ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
586 |
__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server’s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ), |
| 16 | 587 |
__( 'https://wordpress.org/support/forums/' ) |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
588 |
), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
589 |
$request->get_error_message() |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
590 |
); |
| 0 | 591 |
} else { |
| 9 | 592 |
$res = json_decode( wp_remote_retrieve_body( $request ), true ); |
593 |
if ( is_array( $res ) ) { |
|
594 |
// Object casting is required in order to match the info/1.0 format. |
|
595 |
$res = (object) $res; |
|
596 |
} elseif ( null === $res ) { |
|
597 |
$res = new WP_Error( |
|
598 |
'themes_api_failed', |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
599 |
sprintf( |
| 16 | 600 |
/* translators: %s: Support forums URL. */ |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
601 |
__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server’s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ), |
| 16 | 602 |
__( 'https://wordpress.org/support/forums/' ) |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
603 |
), |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
604 |
wp_remote_retrieve_body( $request ) |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
605 |
); |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
606 |
} |
| 9 | 607 |
|
608 |
if ( isset( $res->error ) ) { |
|
609 |
$res = new WP_Error( 'themes_api_failed', $res->error ); |
|
610 |
} |
|
611 |
} |
|
612 |
||
| 19 | 613 |
if ( ! is_wp_error( $res ) ) { |
614 |
// Back-compat for info/1.2 API, upgrade the theme objects in query_themes to objects. |
|
615 |
if ( 'query_themes' === $action ) { |
|
616 |
foreach ( $res->themes as $i => $theme ) { |
|
617 |
$res->themes[ $i ] = (object) $theme; |
|
618 |
} |
|
| 9 | 619 |
} |
| 19 | 620 |
|
621 |
// Back-compat for info/1.2 API, downgrade the feature_list result back to an array. |
|
622 |
if ( 'feature_list' === $action ) { |
|
623 |
$res = (array) $res; |
|
624 |
} |
|
| 5 | 625 |
} |
626 |
} |
|
627 |
||
628 |
/** |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
629 |
* Filters the returned WordPress.org Themes API response. |
| 5 | 630 |
* |
631 |
* @since 2.8.0 |
|
632 |
* |
|
| 19 | 633 |
* @param array|stdClass|WP_Error $res WordPress.org Themes API response. |
634 |
* @param string $action Requested action. Likely values are 'theme_information', |
|
635 |
* 'feature_list', or 'query_themes'. |
|
636 |
* @param stdClass $args Arguments used to query for installer pages from the WordPress.org Themes API. |
|
| 5 | 637 |
*/ |
638 |
return apply_filters( 'themes_api_result', $res, $action, $args ); |
|
639 |
} |
|
640 |
||
641 |
/** |
|
| 19 | 642 |
* Prepares themes for JavaScript. |
| 5 | 643 |
* |
644 |
* @since 3.8.0 |
|
645 |
* |
|
| 9 | 646 |
* @param WP_Theme[] $themes Optional. Array of theme objects to prepare. |
647 |
* Defaults to all allowed themes. |
|
| 5 | 648 |
* |
649 |
* @return array An associative array of theme data, sorted by name. |
|
650 |
*/ |
|
651 |
function wp_prepare_themes_for_js( $themes = null ) { |
|
652 |
$current_theme = get_stylesheet(); |
|
653 |
||
654 |
/** |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
655 |
* Filters theme data before it is prepared for JavaScript. |
| 5 | 656 |
* |
657 |
* Passing a non-empty array will result in wp_prepare_themes_for_js() returning |
|
658 |
* early with that value instead. |
|
659 |
* |
|
660 |
* @since 4.2.0 |
|
661 |
* |
|
| 9 | 662 |
* @param array $prepared_themes An associative array of theme data. Default empty array. |
663 |
* @param WP_Theme[]|null $themes An array of theme objects to prepare, if any. |
|
| 19 | 664 |
* @param string $current_theme The active theme slug. |
| 5 | 665 |
*/ |
666 |
$prepared_themes = (array) apply_filters( 'pre_prepare_themes_for_js', array(), $themes, $current_theme ); |
|
667 |
||
668 |
if ( ! empty( $prepared_themes ) ) { |
|
669 |
return $prepared_themes; |
|
670 |
} |
|
671 |
||
| 19 | 672 |
// Make sure the active theme is listed first. |
| 5 | 673 |
$prepared_themes[ $current_theme ] = array(); |
674 |
||
675 |
if ( null === $themes ) { |
|
676 |
$themes = wp_get_themes( array( 'allowed' => true ) ); |
|
677 |
if ( ! isset( $themes[ $current_theme ] ) ) { |
|
678 |
$themes[ $current_theme ] = wp_get_theme(); |
|
679 |
} |
|
680 |
} |
|
681 |
||
| 16 | 682 |
$updates = array(); |
683 |
$no_updates = array(); |
|
| 18 | 684 |
if ( ! is_multisite() && current_user_can( 'update_themes' ) ) { |
| 5 | 685 |
$updates_transient = get_site_transient( 'update_themes' ); |
686 |
if ( isset( $updates_transient->response ) ) { |
|
687 |
$updates = $updates_transient->response; |
|
| 0 | 688 |
} |
| 16 | 689 |
if ( isset( $updates_transient->no_update ) ) { |
690 |
$no_updates = $updates_transient->no_update; |
|
691 |
} |
|
| 0 | 692 |
} |
693 |
||
| 5 | 694 |
WP_Theme::sort_by_name( $themes ); |
695 |
||
696 |
$parents = array(); |
|
697 |
||
| 16 | 698 |
$auto_updates = (array) get_site_option( 'auto_update_themes', array() ); |
699 |
||
| 5 | 700 |
foreach ( $themes as $theme ) { |
| 9 | 701 |
$slug = $theme->get_stylesheet(); |
| 5 | 702 |
$encoded_slug = urlencode( $slug ); |
703 |
||
704 |
$parent = false; |
|
705 |
if ( $theme->parent() ) { |
|
| 9 | 706 |
$parent = $theme->parent(); |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
707 |
$parents[ $slug ] = $parent->get_stylesheet(); |
| 9 | 708 |
$parent = $parent->display( 'Name' ); |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
709 |
} |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
710 |
|
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
711 |
$customize_action = null; |
| 19 | 712 |
|
713 |
$can_edit_theme_options = current_user_can( 'edit_theme_options' ); |
|
714 |
$can_customize = current_user_can( 'customize' ); |
|
715 |
$is_block_theme = $theme->is_block_theme(); |
|
716 |
||
717 |
if ( $is_block_theme && $can_edit_theme_options ) { |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
718 |
$customize_action = admin_url( 'site-editor.php' ); |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
719 |
if ( $current_theme !== $slug ) { |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
720 |
$customize_action = add_query_arg( 'wp_theme_preview', $slug, $customize_action ); |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
721 |
} |
| 19 | 722 |
} elseif ( ! $is_block_theme && $can_customize && $can_edit_theme_options ) { |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
723 |
$customize_action = wp_customize_url( $slug ); |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
724 |
} |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
725 |
if ( null !== $customize_action ) { |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
726 |
$customize_action = add_query_arg( |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
727 |
array( |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
728 |
'return' => urlencode( sanitize_url( remove_query_arg( wp_removable_query_args(), wp_unslash( $_SERVER['REQUEST_URI'] ) ) ) ), |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
729 |
), |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
730 |
$customize_action |
| 9 | 731 |
); |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
732 |
$customize_action = esc_url( $customize_action ); |
| 5 | 733 |
} |
734 |
||
| 16 | 735 |
$update_requires_wp = isset( $updates[ $slug ]['requires'] ) ? $updates[ $slug ]['requires'] : null; |
736 |
$update_requires_php = isset( $updates[ $slug ]['requires_php'] ) ? $updates[ $slug ]['requires_php'] : null; |
|
737 |
||
738 |
$auto_update = in_array( $slug, $auto_updates, true ); |
|
739 |
$auto_update_action = $auto_update ? 'disable-auto-update' : 'enable-auto-update'; |
|
740 |
||
741 |
if ( isset( $updates[ $slug ] ) ) { |
|
742 |
$auto_update_supported = true; |
|
743 |
$auto_update_filter_payload = (object) $updates[ $slug ]; |
|
744 |
} elseif ( isset( $no_updates[ $slug ] ) ) { |
|
745 |
$auto_update_supported = true; |
|
746 |
$auto_update_filter_payload = (object) $no_updates[ $slug ]; |
|
747 |
} else { |
|
748 |
$auto_update_supported = false; |
|
749 |
/* |
|
750 |
* Create the expected payload for the auto_update_theme filter, this is the same data |
|
751 |
* as contained within $updates or $no_updates but used when the Theme is not known. |
|
752 |
*/ |
|
753 |
$auto_update_filter_payload = (object) array( |
|
754 |
'theme' => $slug, |
|
755 |
'new_version' => $theme->get( 'Version' ), |
|
756 |
'url' => '', |
|
757 |
'package' => '', |
|
758 |
'requires' => $theme->get( 'RequiresWP' ), |
|
759 |
'requires_php' => $theme->get( 'RequiresPHP' ), |
|
760 |
); |
|
761 |
} |
|
762 |
||
| 18 | 763 |
$auto_update_forced = wp_is_auto_update_forced_for_item( 'theme', null, $auto_update_filter_payload ); |
| 16 | 764 |
|
| 5 | 765 |
$prepared_themes[ $slug ] = array( |
| 16 | 766 |
'id' => $slug, |
767 |
'name' => $theme->display( 'Name' ), |
|
768 |
'screenshot' => array( $theme->get_screenshot() ), // @todo Multiple screenshots. |
|
769 |
'description' => $theme->display( 'Description' ), |
|
770 |
'author' => $theme->display( 'Author', false, true ), |
|
771 |
'authorAndUri' => $theme->display( 'Author' ), |
|
772 |
'tags' => $theme->display( 'Tags' ), |
|
773 |
'version' => $theme->get( 'Version' ), |
|
774 |
'compatibleWP' => is_wp_version_compatible( $theme->get( 'RequiresWP' ) ), |
|
775 |
'compatiblePHP' => is_php_version_compatible( $theme->get( 'RequiresPHP' ) ), |
|
776 |
'updateResponse' => array( |
|
777 |
'compatibleWP' => is_wp_version_compatible( $update_requires_wp ), |
|
778 |
'compatiblePHP' => is_php_version_compatible( $update_requires_php ), |
|
779 |
), |
|
780 |
'parent' => $parent, |
|
781 |
'active' => $slug === $current_theme, |
|
782 |
'hasUpdate' => isset( $updates[ $slug ] ), |
|
783 |
'hasPackage' => isset( $updates[ $slug ] ) && ! empty( $updates[ $slug ]['package'] ), |
|
784 |
'update' => get_theme_update_available( $theme ), |
|
785 |
'autoupdate' => array( |
|
786 |
'enabled' => $auto_update || $auto_update_forced, |
|
787 |
'supported' => $auto_update_supported, |
|
788 |
'forced' => $auto_update_forced, |
|
789 |
), |
|
790 |
'actions' => array( |
|
791 |
'activate' => current_user_can( 'switch_themes' ) ? wp_nonce_url( admin_url( 'themes.php?action=activate&stylesheet=' . $encoded_slug ), 'switch-theme_' . $slug ) : null, |
|
792 |
'customize' => $customize_action, |
|
| 18 | 793 |
'delete' => ( ! is_multisite() && current_user_can( 'delete_themes' ) ) ? wp_nonce_url( admin_url( 'themes.php?action=delete&stylesheet=' . $encoded_slug ), 'delete-theme_' . $slug ) : null, |
| 16 | 794 |
'autoupdate' => wp_is_auto_update_enabled_for_type( 'theme' ) && ! is_multisite() && current_user_can( 'update_themes' ) |
795 |
? wp_nonce_url( admin_url( 'themes.php?action=' . $auto_update_action . '&stylesheet=' . $encoded_slug ), 'updates' ) |
|
796 |
: null, |
|
| 5 | 797 |
), |
| 19 | 798 |
'blockTheme' => $theme->is_block_theme(), |
| 5 | 799 |
); |
800 |
} |
|
801 |
||
| 16 | 802 |
// Remove 'delete' action if theme has an active child. |
| 5 | 803 |
if ( ! empty( $parents ) && array_key_exists( $current_theme, $parents ) ) { |
804 |
unset( $prepared_themes[ $parents[ $current_theme ] ]['actions']['delete'] ); |
|
805 |
} |
|
806 |
||
807 |
/** |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
808 |
* Filters the themes prepared for JavaScript, for themes.php. |
| 5 | 809 |
* |
810 |
* Could be useful for changing the order, which is by name by default. |
|
811 |
* |
|
812 |
* @since 3.8.0 |
|
813 |
* |
|
| 16 | 814 |
* @param array $prepared_themes Array of theme data. |
| 5 | 815 |
*/ |
816 |
$prepared_themes = apply_filters( 'wp_prepare_themes_for_js', $prepared_themes ); |
|
817 |
$prepared_themes = array_values( $prepared_themes ); |
|
818 |
return array_filter( $prepared_themes ); |
|
| 0 | 819 |
} |
| 5 | 820 |
|
821 |
/** |
|
| 19 | 822 |
* Prints JS templates for the theme-browsing UI in the Customizer. |
| 5 | 823 |
* |
824 |
* @since 4.2.0 |
|
825 |
*/ |
|
826 |
function customize_themes_print_templates() { |
|
827 |
?> |
|
828 |
<script type="text/html" id="tmpl-customize-themes-details-view"> |
|
829 |
<div class="theme-backdrop"></div> |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
830 |
<div class="theme-wrap wp-clearfix" role="document"> |
| 5 | 831 |
<div class="theme-header"> |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
832 |
<button type="button" class="left dashicons dashicons-no"><span class="screen-reader-text"> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
833 |
<?php |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
834 |
/* translators: Hidden accessibility text. */ |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
835 |
_e( 'Show previous theme' ); |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
836 |
?> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
837 |
</span></button> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
838 |
<button type="button" class="right dashicons dashicons-no"><span class="screen-reader-text"> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
839 |
<?php |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
840 |
/* translators: Hidden accessibility text. */ |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
841 |
_e( 'Show next theme' ); |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
842 |
?> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
843 |
</span></button> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
844 |
<button type="button" class="close dashicons dashicons-no"><span class="screen-reader-text"> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
845 |
<?php |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
846 |
/* translators: Hidden accessibility text. */ |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
847 |
_e( 'Close details dialog' ); |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
848 |
?> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
849 |
</span></button> |
| 5 | 850 |
</div> |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
851 |
<div class="theme-about wp-clearfix"> |
| 5 | 852 |
<div class="theme-screenshots"> |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
853 |
<# if ( data.screenshot && data.screenshot[0] ) { #> |
| 19 | 854 |
<div class="screenshot"><img src="{{ data.screenshot[0] }}?ver={{ data.version }}" alt="" /></div> |
| 5 | 855 |
<# } else { #> |
856 |
<div class="screenshot blank"></div> |
|
857 |
<# } #> |
|
858 |
</div> |
|
859 |
||
860 |
<div class="theme-info"> |
|
861 |
<# if ( data.active ) { #> |
|
| 19 | 862 |
<span class="current-label"><?php _e( 'Active Theme' ); ?></span> |
| 5 | 863 |
<# } #> |
| 16 | 864 |
<h2 class="theme-name">{{{ data.name }}}<span class="theme-version"> |
865 |
<?php |
|
866 |
/* translators: %s: Theme version. */ |
|
867 |
printf( __( 'Version: %s' ), '{{ data.version }}' ); |
|
868 |
?> |
|
869 |
</span></h2> |
|
870 |
<h3 class="theme-author"> |
|
871 |
<?php |
|
872 |
/* translators: %s: Theme author link. */ |
|
873 |
printf( __( 'By %s' ), '{{{ data.authorAndUri }}}' ); |
|
874 |
?> |
|
875 |
</h3> |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
876 |
|
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
877 |
<# if ( data.stars && 0 != data.num_ratings ) { #> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
878 |
<div class="theme-rating"> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
879 |
{{{ data.stars }}} |
| 9 | 880 |
<a class="num-ratings" target="_blank" href="{{ data.reviews_url }}"> |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
881 |
<?php |
| 9 | 882 |
printf( |
883 |
'%1$s <span class="screen-reader-text">%2$s</span>', |
|
| 16 | 884 |
/* translators: %s: Number of ratings. */ |
| 9 | 885 |
sprintf( __( '(%s ratings)' ), '{{ data.num_ratings }}' ), |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
886 |
/* translators: Hidden accessibility text. */ |
| 9 | 887 |
__( '(opens in a new tab)' ) |
888 |
); |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
889 |
?> |
| 9 | 890 |
</a> |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
891 |
</div> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
892 |
<# } #> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
893 |
|
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
894 |
<# if ( data.hasUpdate ) { #> |
| 16 | 895 |
<# if ( data.updateResponse.compatibleWP && data.updateResponse.compatiblePHP ) { #> |
896 |
<div class="notice notice-warning notice-alt notice-large" data-slug="{{ data.id }}"> |
|
897 |
<h3 class="notice-title"><?php _e( 'Update Available' ); ?></h3> |
|
898 |
{{{ data.update }}} |
|
899 |
</div> |
|
900 |
<# } else { #> |
|
901 |
<div class="notice notice-error notice-alt notice-large" data-slug="{{ data.id }}"> |
|
902 |
<h3 class="notice-title"><?php _e( 'Update Incompatible' ); ?></h3> |
|
903 |
<p> |
|
904 |
<# if ( ! data.updateResponse.compatibleWP && ! data.updateResponse.compatiblePHP ) { #> |
|
905 |
<?php |
|
906 |
printf( |
|
907 |
/* translators: %s: Theme name. */ |
|
| 19 | 908 |
__( 'There is a new version of %s available, but it does not work with your versions of WordPress and PHP.' ), |
| 16 | 909 |
'{{{ data.name }}}' |
910 |
); |
|
911 |
if ( current_user_can( 'update_core' ) && current_user_can( 'update_php' ) ) { |
|
912 |
printf( |
|
913 |
/* translators: 1: URL to WordPress Updates screen, 2: URL to Update PHP page. */ |
|
914 |
' ' . __( '<a href="%1$s">Please update WordPress</a>, and then <a href="%2$s">learn more about updating PHP</a>.' ), |
|
915 |
self_admin_url( 'update-core.php' ), |
|
916 |
esc_url( wp_get_update_php_url() ) |
|
917 |
); |
|
918 |
wp_update_php_annotation( '</p><p><em>', '</em>' ); |
|
919 |
} elseif ( current_user_can( 'update_core' ) ) { |
|
920 |
printf( |
|
921 |
/* translators: %s: URL to WordPress Updates screen. */ |
|
922 |
' ' . __( '<a href="%s">Please update WordPress</a>.' ), |
|
923 |
self_admin_url( 'update-core.php' ) |
|
924 |
); |
|
925 |
} elseif ( current_user_can( 'update_php' ) ) { |
|
926 |
printf( |
|
927 |
/* translators: %s: URL to Update PHP page. */ |
|
928 |
' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ), |
|
929 |
esc_url( wp_get_update_php_url() ) |
|
930 |
); |
|
931 |
wp_update_php_annotation( '</p><p><em>', '</em>' ); |
|
932 |
} |
|
933 |
?> |
|
934 |
<# } else if ( ! data.updateResponse.compatibleWP ) { #> |
|
935 |
<?php |
|
936 |
printf( |
|
937 |
/* translators: %s: Theme name. */ |
|
| 19 | 938 |
__( 'There is a new version of %s available, but it does not work with your version of WordPress.' ), |
| 16 | 939 |
'{{{ data.name }}}' |
940 |
); |
|
941 |
if ( current_user_can( 'update_core' ) ) { |
|
942 |
printf( |
|
943 |
/* translators: %s: URL to WordPress Updates screen. */ |
|
944 |
' ' . __( '<a href="%s">Please update WordPress</a>.' ), |
|
945 |
self_admin_url( 'update-core.php' ) |
|
946 |
); |
|
947 |
} |
|
948 |
?> |
|
949 |
<# } else if ( ! data.updateResponse.compatiblePHP ) { #> |
|
950 |
<?php |
|
951 |
printf( |
|
952 |
/* translators: %s: Theme name. */ |
|
| 19 | 953 |
__( 'There is a new version of %s available, but it does not work with your version of PHP.' ), |
| 16 | 954 |
'{{{ data.name }}}' |
955 |
); |
|
956 |
if ( current_user_can( 'update_php' ) ) { |
|
957 |
printf( |
|
958 |
/* translators: %s: URL to Update PHP page. */ |
|
959 |
' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ), |
|
960 |
esc_url( wp_get_update_php_url() ) |
|
961 |
); |
|
962 |
wp_update_php_annotation( '</p><p><em>', '</em>' ); |
|
963 |
} |
|
964 |
?> |
|
965 |
<# } #> |
|
966 |
</p> |
|
967 |
</div> |
|
968 |
<# } #> |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
969 |
<# } #> |
| 5 | 970 |
|
971 |
<# if ( data.parent ) { #> |
|
| 16 | 972 |
<p class="parent-theme"> |
973 |
<?php |
|
974 |
printf( |
|
975 |
/* translators: %s: Theme name. */ |
|
976 |
__( 'This is a child theme of %s.' ), |
|
977 |
'<strong>{{{ data.parent }}}</strong>' |
|
978 |
); |
|
979 |
?> |
|
980 |
</p> |
|
981 |
<# } #> |
|
982 |
||
983 |
<# if ( ! data.compatibleWP || ! data.compatiblePHP ) { #> |
|
984 |
<div class="notice notice-error notice-alt notice-large"><p> |
|
985 |
<# if ( ! data.compatibleWP && ! data.compatiblePHP ) { #> |
|
986 |
<?php |
|
| 19 | 987 |
_e( 'This theme does not work with your versions of WordPress and PHP.' ); |
| 16 | 988 |
if ( current_user_can( 'update_core' ) && current_user_can( 'update_php' ) ) { |
989 |
printf( |
|
990 |
/* translators: 1: URL to WordPress Updates screen, 2: URL to Update PHP page. */ |
|
991 |
' ' . __( '<a href="%1$s">Please update WordPress</a>, and then <a href="%2$s">learn more about updating PHP</a>.' ), |
|
992 |
self_admin_url( 'update-core.php' ), |
|
993 |
esc_url( wp_get_update_php_url() ) |
|
994 |
); |
|
995 |
wp_update_php_annotation( '</p><p><em>', '</em>' ); |
|
996 |
} elseif ( current_user_can( 'update_core' ) ) { |
|
997 |
printf( |
|
998 |
/* translators: %s: URL to WordPress Updates screen. */ |
|
999 |
' ' . __( '<a href="%s">Please update WordPress</a>.' ), |
|
1000 |
self_admin_url( 'update-core.php' ) |
|
1001 |
); |
|
1002 |
} elseif ( current_user_can( 'update_php' ) ) { |
|
1003 |
printf( |
|
1004 |
/* translators: %s: URL to Update PHP page. */ |
|
1005 |
' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ), |
|
1006 |
esc_url( wp_get_update_php_url() ) |
|
1007 |
); |
|
1008 |
wp_update_php_annotation( '</p><p><em>', '</em>' ); |
|
1009 |
} |
|
1010 |
?> |
|
1011 |
<# } else if ( ! data.compatibleWP ) { #> |
|
1012 |
<?php |
|
| 19 | 1013 |
_e( 'This theme does not work with your version of WordPress.' ); |
| 16 | 1014 |
if ( current_user_can( 'update_core' ) ) { |
1015 |
printf( |
|
1016 |
/* translators: %s: URL to WordPress Updates screen. */ |
|
1017 |
' ' . __( '<a href="%s">Please update WordPress</a>.' ), |
|
1018 |
self_admin_url( 'update-core.php' ) |
|
1019 |
); |
|
1020 |
} |
|
1021 |
?> |
|
1022 |
<# } else if ( ! data.compatiblePHP ) { #> |
|
1023 |
<?php |
|
| 19 | 1024 |
_e( 'This theme does not work with your version of PHP.' ); |
| 16 | 1025 |
if ( current_user_can( 'update_php' ) ) { |
1026 |
printf( |
|
1027 |
/* translators: %s: URL to Update PHP page. */ |
|
1028 |
' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ), |
|
1029 |
esc_url( wp_get_update_php_url() ) |
|
1030 |
); |
|
1031 |
wp_update_php_annotation( '</p><p><em>', '</em>' ); |
|
1032 |
} |
|
1033 |
?> |
|
1034 |
<# } #> |
|
1035 |
</p></div> |
|
| 19 | 1036 |
<# } else if ( ! data.active && data.blockTheme ) { #> |
1037 |
<div class="notice notice-error notice-alt notice-large"><p> |
|
1038 |
<?php |
|
1039 |
_e( 'This theme doesn\'t support Customizer.' ); |
|
1040 |
?> |
|
1041 |
<# if ( data.actions.activate ) { #> |
|
1042 |
<?php |
|
1043 |
printf( |
|
1044 |
/* translators: %s: URL to the themes page (also it activates the theme). */ |
|
1045 |
' ' . __( 'However, you can still <a href="%s">activate this theme</a>, and use the Site Editor to customize it.' ), |
|
1046 |
'{{{ data.actions.activate }}}' |
|
1047 |
); |
|
1048 |
?> |
|
1049 |
<# } #> |
|
1050 |
</p></div> |
|
| 5 | 1051 |
<# } #> |
1052 |
||
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1053 |
<p class="theme-description">{{{ data.description }}}</p> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1054 |
|
| 5 | 1055 |
<# if ( data.tags ) { #> |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1056 |
<p class="theme-tags"><span><?php _e( 'Tags:' ); ?></span> {{{ data.tags }}}</p> |
| 5 | 1057 |
<# } #> |
1058 |
</div> |
|
1059 |
</div> |
|
1060 |
||
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1061 |
<div class="theme-actions"> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1062 |
<# if ( data.active ) { #> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1063 |
<button type="button" class="button button-primary customize-theme"><?php _e( 'Customize' ); ?></button> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1064 |
<# } else if ( 'installed' === data.type ) { #> |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1065 |
<div class="theme-inactive-actions"> |
| 19 | 1066 |
<# if ( data.blockTheme ) { #> |
1067 |
<?php |
|
1068 |
/* translators: %s: Theme name. */ |
|
1069 |
$aria_label = sprintf( _x( 'Activate %s', 'theme' ), '{{ data.name }}' ); |
|
1070 |
?> |
|
1071 |
<# if ( data.compatibleWP && data.compatiblePHP && data.actions.activate ) { #> |
|
1072 |
<a href="{{{ data.actions.activate }}}" class="button button-primary activate" aria-label="<?php echo esc_attr( $aria_label ); ?>"><?php _e( 'Activate' ); ?></a> |
|
1073 |
<# } #> |
|
| 16 | 1074 |
<# } else { #> |
| 19 | 1075 |
<# if ( data.compatibleWP && data.compatiblePHP ) { #> |
1076 |
<button type="button" class="button button-primary preview-theme" data-slug="{{ data.id }}"><?php _e( 'Live Preview' ); ?></button> |
|
1077 |
<# } else { #> |
|
1078 |
<button class="button button-primary disabled"><?php _e( 'Live Preview' ); ?></button> |
|
1079 |
<# } #> |
|
| 16 | 1080 |
<# } #> |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1081 |
</div> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1082 |
<?php if ( current_user_can( 'delete_themes' ) ) { ?> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1083 |
<# if ( data.actions && data.actions['delete'] ) { #> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1084 |
<a href="{{{ data.actions['delete'] }}}" data-slug="{{ data.id }}" class="button button-secondary delete-theme"><?php _e( 'Delete' ); ?></a> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1085 |
<# } #> |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1086 |
<?php } ?> |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1087 |
<# } else { #> |
| 16 | 1088 |
<# if ( data.compatibleWP && data.compatiblePHP ) { #> |
1089 |
<button type="button" class="button theme-install" data-slug="{{ data.id }}"><?php _e( 'Install' ); ?></button> |
|
1090 |
<button type="button" class="button button-primary theme-install preview" data-slug="{{ data.id }}"><?php _e( 'Install & Preview' ); ?></button> |
|
1091 |
<# } else { #> |
|
1092 |
<button type="button" class="button disabled"><?php _ex( 'Cannot Install', 'theme' ); ?></button> |
|
1093 |
<button type="button" class="button button-primary disabled"><?php _e( 'Install & Preview' ); ?></button> |
|
1094 |
<# } #> |
|
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1095 |
<# } #> |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
1096 |
</div> |
| 5 | 1097 |
</div> |
1098 |
</script> |
|
1099 |
<?php |
|
1100 |
} |
|
| 9 | 1101 |
|
1102 |
/** |
|
1103 |
* Determines whether a theme is technically active but was paused while |
|
1104 |
* loading. |
|
1105 |
* |
|
1106 |
* For more information on this and similar theme functions, check out |
|
1107 |
* the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ |
|
1108 |
* Conditional Tags} article in the Theme Developer Handbook. |
|
1109 |
* |
|
1110 |
* @since 5.2.0 |
|
1111 |
* |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1112 |
* @global WP_Paused_Extensions_Storage $_paused_themes |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1113 |
* |
| 9 | 1114 |
* @param string $theme Path to the theme directory relative to the themes directory. |
1115 |
* @return bool True, if in the list of paused themes. False, not in the list. |
|
1116 |
*/ |
|
1117 |
function is_theme_paused( $theme ) { |
|
1118 |
if ( ! isset( $GLOBALS['_paused_themes'] ) ) { |
|
1119 |
return false; |
|
1120 |
} |
|
1121 |
||
1122 |
if ( get_stylesheet() !== $theme && get_template() !== $theme ) { |
|
1123 |
return false; |
|
1124 |
} |
|
1125 |
||
1126 |
return array_key_exists( $theme, $GLOBALS['_paused_themes'] ); |
|
1127 |
} |
|
1128 |
||
1129 |
/** |
|
1130 |
* Gets the error that was recorded for a paused theme. |
|
1131 |
* |
|
1132 |
* @since 5.2.0 |
|
1133 |
* |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1134 |
* @global WP_Paused_Extensions_Storage $_paused_themes |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1135 |
* |
| 9 | 1136 |
* @param string $theme Path to the theme directory relative to the themes |
1137 |
* directory. |
|
1138 |
* @return array|false Array of error information as it was returned by |
|
1139 |
* `error_get_last()`, or false if none was recorded. |
|
1140 |
*/ |
|
1141 |
function wp_get_theme_error( $theme ) { |
|
1142 |
if ( ! isset( $GLOBALS['_paused_themes'] ) ) { |
|
1143 |
return false; |
|
1144 |
} |
|
1145 |
||
1146 |
if ( ! array_key_exists( $theme, $GLOBALS['_paused_themes'] ) ) { |
|
1147 |
return false; |
|
1148 |
} |
|
1149 |
||
1150 |
return $GLOBALS['_paused_themes'][ $theme ]; |
|
1151 |
} |
|
1152 |
||
1153 |
/** |
|
1154 |
* Tries to resume a single theme. |
|
1155 |
* |
|
1156 |
* If a redirect was provided and a functions.php file was found, we first ensure that |
|
1157 |
* functions.php file does not throw fatal errors anymore. |
|
1158 |
* |
|
1159 |
* The way it works is by setting the redirection to the error before trying to |
|
1160 |
* include the file. If the theme fails, then the redirection will not be overwritten |
|
1161 |
* with the success message and the theme will not be resumed. |
|
1162 |
* |
|
1163 |
* @since 5.2.0 |
|
1164 |
* |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1165 |
* @global string $wp_stylesheet_path Path to current theme's stylesheet directory. |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1166 |
* @global string $wp_template_path Path to current theme's template directory. |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1167 |
* |
| 9 | 1168 |
* @param string $theme Single theme to resume. |
1169 |
* @param string $redirect Optional. URL to redirect to. Default empty string. |
|
1170 |
* @return bool|WP_Error True on success, false if `$theme` was not paused, |
|
1171 |
* `WP_Error` on failure. |
|
1172 |
*/ |
|
1173 |
function resume_theme( $theme, $redirect = '' ) { |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1174 |
global $wp_stylesheet_path, $wp_template_path; |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1175 |
|
| 9 | 1176 |
list( $extension ) = explode( '/', $theme ); |
1177 |
||
1178 |
/* |
|
1179 |
* We'll override this later if the theme could be resumed without |
|
1180 |
* creating a fatal error. |
|
1181 |
*/ |
|
1182 |
if ( ! empty( $redirect ) ) { |
|
1183 |
$functions_path = ''; |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1184 |
if ( str_contains( $wp_stylesheet_path, $extension ) ) { |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1185 |
$functions_path = $wp_stylesheet_path . '/functions.php'; |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1186 |
} elseif ( str_contains( $wp_template_path, $extension ) ) { |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1187 |
$functions_path = $wp_template_path . '/functions.php'; |
| 9 | 1188 |
} |
1189 |
||
1190 |
if ( ! empty( $functions_path ) ) { |
|
1191 |
wp_redirect( |
|
1192 |
add_query_arg( |
|
1193 |
'_error_nonce', |
|
1194 |
wp_create_nonce( 'theme-resume-error_' . $theme ), |
|
1195 |
$redirect |
|
1196 |
) |
|
1197 |
); |
|
1198 |
||
1199 |
// Load the theme's functions.php to test whether it throws a fatal error. |
|
1200 |
ob_start(); |
|
1201 |
if ( ! defined( 'WP_SANDBOX_SCRAPING' ) ) { |
|
1202 |
define( 'WP_SANDBOX_SCRAPING', true ); |
|
1203 |
} |
|
1204 |
include $functions_path; |
|
1205 |
ob_clean(); |
|
1206 |
} |
|
1207 |
} |
|
1208 |
||
1209 |
$result = wp_paused_themes()->delete( $extension ); |
|
1210 |
||
1211 |
if ( ! $result ) { |
|
1212 |
return new WP_Error( |
|
1213 |
'could_not_resume_theme', |
|
1214 |
__( 'Could not resume the theme.' ) |
|
1215 |
); |
|
1216 |
} |
|
1217 |
||
1218 |
return true; |
|
1219 |
} |
|
1220 |
||
1221 |
/** |
|
1222 |
* Renders an admin notice in case some themes have been paused due to errors. |
|
1223 |
* |
|
1224 |
* @since 5.2.0 |
|
| 18 | 1225 |
* |
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1226 |
* @global string $pagenow The filename of the current screen. |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1227 |
* @global WP_Paused_Extensions_Storage $_paused_themes |
| 9 | 1228 |
*/ |
1229 |
function paused_themes_notice() { |
|
1230 |
if ( 'themes.php' === $GLOBALS['pagenow'] ) { |
|
1231 |
return; |
|
1232 |
} |
|
1233 |
||
1234 |
if ( ! current_user_can( 'resume_themes' ) ) { |
|
1235 |
return; |
|
1236 |
} |
|
1237 |
||
1238 |
if ( ! isset( $GLOBALS['_paused_themes'] ) || empty( $GLOBALS['_paused_themes'] ) ) { |
|
1239 |
return; |
|
1240 |
} |
|
1241 |
||
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1242 |
$message = sprintf( |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1243 |
'<p><strong>%s</strong><br>%s</p><p><a href="%s">%s</a></p>', |
| 9 | 1244 |
__( 'One or more themes failed to load properly.' ), |
1245 |
__( 'You can find more details and make changes on the Themes screen.' ), |
|
1246 |
esc_url( admin_url( 'themes.php' ) ), |
|
1247 |
__( 'Go to the Themes screen' ) |
|
1248 |
); |
|
|
21
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1249 |
wp_admin_notice( |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1250 |
$message, |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1251 |
array( |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1252 |
'type' => 'error', |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1253 |
'paragraph_wrap' => false, |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1254 |
) |
|
48c4eec2b7e6
Add CLAUDE.md documentation and sync WordPress core files
ymh <ymh.work@gmail.com>
parents:
19
diff
changeset
|
1255 |
); |
| 9 | 1256 |
} |