PluginProbe
Gutenberg / 10.3.0
Gutenberg v10.3.0
23.9.1 23.9.0 23.8.0 23.7.2 23.7.1 23.7.0 23.6.1 23.6.2 23.6.0 23.5.3 23.5.2 23.5.1 23.5.0 23.4.0 23.3.2 23.3.1 23.3.0 23.2.0 23.2.1 23.2.2 23.1.1 23.1.0 23.0.1 12.6.0 7.4.0 All 402 releases
gutenberg / lib / client-assets.php

client-assets.php in Gutenberg 10.3.0, at lib/client-assets.php

742 lines 23.8 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2 /**
3 * Functions to register client-side assets (scripts and stylesheets) for the
4 * Gutenberg editor plugin.
5 *
6 * @package gutenberg
7 */
8
9 if ( ! defined( 'ABSPATH' ) ) {
10 die( 'Silence is golden.' );
11 }
12
13 /**
14 * Retrieves the root plugin path.
15 *
16 * @return string Root path to the gutenberg plugin.
17 *
18 * @since 0.1.0
19 */
20 function gutenberg_dir_path() {
21 return plugin_dir_path( __DIR__ );
22 }
23
24 /**
25 * Retrieves a URL to a file in the gutenberg plugin.
26 *
27 * @param string $path Relative path of the desired file.
28 *
29 * @return string Fully qualified URL pointing to the desired file.
30 *
31 * @since 0.1.0
32 */
33 function gutenberg_url( $path ) {
34 return plugins_url( $path, __DIR__ );
35 }
36
37 /**
38 * Registers a script according to `wp_register_script`. Honors this request by
39 * reassigning internal dependency properties of any script handle already
40 * registered by that name. It does not deregister the original script, to
41 * avoid losing inline scripts which may have been attached.
42 *
43 * @since 4.1.0
44 *
45 * @param WP_Scripts $scripts WP_Scripts instance.
46 * @param string $handle Name of the script. Should be unique.
47 * @param string $src Full URL of the script, or path of the script relative to the WordPress root directory.
48 * @param array $deps Optional. An array of registered script handles this script depends on. Default empty array.
49 * @param string|bool|null $ver Optional. String specifying script version number, if it has one, which is added to the URL
50 * as a query string for cache busting purposes. If version is set to false, a version
51 * number is automatically added equal to current installed WordPress version.
52 * If set to null, no version is added.
53 * @param bool $in_footer Optional. Whether to enqueue the script before </body> instead of in the <head>.
54 * Default 'false'.
55 */
56 function gutenberg_override_script( $scripts, $handle, $src, $deps = array(), $ver = false, $in_footer = false ) {
57 $script = $scripts->query( $handle, 'registered' );
58 if ( $script ) {
59 /*
60 * In many ways, this is a reimplementation of `wp_register_script` but
61 * bypassing consideration of whether a script by the given handle had
62 * already been registered.
63 */
64
65 // See: `_WP_Dependency::__construct` .
66 $script->src = $src;
67 $script->deps = $deps;
68 $script->ver = $ver;
69 $script->args = $in_footer;
70
71 /*
72 * The script's `group` designation is an indication of whether it is
73 * to be printed in the header or footer. The behavior here defers to
74 * the arguments as passed. Specifically, group data is not assigned
75 * for a script unless it is designated to be printed in the footer.
76 */
77
78 // See: `wp_register_script` .
79 unset( $script->extra['group'] );
80 if ( $in_footer ) {
81 $script->add_data( 'group', 1 );
82 }
83 } else {
84 $scripts->add( $handle, $src, $deps, $ver, $in_footer );
85 }
86
87 /*
88 * `WP_Dependencies::set_translations` will fall over on itself if setting
89 * translations on the `wp-i18n` handle, since it internally adds `wp-i18n`
90 * as a dependency of itself, exhausting memory. The same applies for the
91 * polyfill and hooks scripts, which are dependencies _of_ `wp-i18n`.
92 *
93 * See: https://core.trac.wordpress.org/ticket/46089
94 */
95 if ( ! in_array( $handle, array( 'wp-i18n', 'wp-polyfill', 'wp-hooks' ), true ) ) {
96 $scripts->set_translations( $handle, 'default' );
97 }
98
99 // Remove this check once the minimum supported WordPress version is at least 5.7.
100 if ( 'wp-i18n' === $handle ) {
101 $ltr = 'rtl' === _x( 'ltr', 'text direction', 'default' ) ? 'rtl' : 'ltr';
102 $output = sprintf( "wp.i18n.setLocaleData( { 'text direction\u0004ltr': [ '%s' ] }, 'default' );", $ltr );
103 $scripts->add_inline_script( 'wp-i18n', $output, 'after' );
104 }
105 }
106
107 /**
108 * Filters the default translation file load behavior to load the Gutenberg
109 * plugin translation file, if available.
110 *
111 * @param string|false $file Path to the translation file to load. False if
112 * there isn't one.
113 * @param string $handle Name of the script to register a translation
114 * domain to.
115 *
116 * @return string|false Filtered path to the Gutenberg translation file, if
117 * available.
118 */
119 function gutenberg_override_translation_file( $file, $handle ) {
120 if ( ! $file ) {
121 return $file;
122 }
123
124 // Ignore scripts whose handle does not have the "wp-" prefix.
125 if ( 'wp-' !== substr( $handle, 0, 3 ) ) {
126 return $file;
127 }
128
129 // Ignore scripts that are not found in the expected `build/` location.
130 $script_path = gutenberg_dir_path() . 'build/' . substr( $handle, 3 ) . '/index.js';
131 if ( ! file_exists( $script_path ) ) {
132 return $file;
133 }
134
135 /*
136 * The default file will be in the plugins language directory, omitting the
137 * domain since Gutenberg assigns the script translations as the default.
138 *
139 * Example: /www/wp-content/languages/plugins/de_DE-07d88e6a803e01276b9bfcc1203e862e.json
140 *
141 * The logic of `load_script_textdomain` is such that it will assume to
142 * search in the plugins language directory, since the assigned source of
143 * the overridden Gutenberg script originates in the plugins directory.
144 *
145 * The plugin translation files each begin with the slug of the plugin, so
146 * it's a simple matter of prepending the Gutenberg plugin slug.
147 */
148 $path_parts = pathinfo( $file );
149 $plugin_translation_file = (
150 $path_parts['dirname'] .
151 '/gutenberg-' .
152 $path_parts['basename']
153 );
154
155 return $plugin_translation_file;
156 }
157 add_filter( 'load_script_translation_file', 'gutenberg_override_translation_file', 10, 2 );
158
159 /**
160 * Registers a style according to `wp_register_style`. Honors this request by
161 * deregistering any style by the same handler before registration.
162 *
163 * @since 4.1.0
164 *
165 * @param WP_Styles $styles WP_Styles instance.
166 * @param string $handle Name of the stylesheet. Should be unique.
167 * @param string $src Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory.
168 * @param array $deps Optional. An array of registered stylesheet handles this stylesheet depends on. Default empty array.
169 * @param string|bool|null $ver Optional. String specifying stylesheet version number, if it has one, which is added to the URL
170 * as a query string for cache busting purposes. If version is set to false, a version
171 * number is automatically added equal to current installed WordPress version.
172 * If set to null, no version is added.
173 * @param string $media Optional. The media for which this stylesheet has been defined.
174 * Default 'all'. Accepts media types like 'all', 'print' and 'screen', or media queries like
175 * '(orientation: portrait)' and '(max-width: 640px)'.
176 */
177 function gutenberg_override_style( $styles, $handle, $src, $deps = array(), $ver = false, $media = 'all' ) {
178 $style = $styles->query( $handle, 'registered' );
179 if ( $style ) {
180 $styles->remove( $handle );
181 }
182 $styles->add( $handle, $src, $deps, $ver, $media );
183 }
184
185 /**
186 * Registers vendor JavaScript files to be used as dependencies of the editor
187 * and plugins.
188 *
189 * This function is called from a script during the plugin build process, so it
190 * should not call any WordPress PHP functions.
191 *
192 * @since 0.1.0
193 *
194 * @param WP_Scripts $scripts WP_Scripts instance.
195 */
196 function gutenberg_register_vendor_scripts( $scripts ) {
197 $suffix = SCRIPT_DEBUG ? '' : '.min';
198
199 $react_suffix = ( SCRIPT_DEBUG ? '.development' : '.production' ) . $suffix;
200 gutenberg_register_vendor_script(
201 $scripts,
202 'react',
203 'https://unpkg.com/react@16.13.1/umd/react' . $react_suffix . '.js',
204 array( 'wp-polyfill' )
205 );
206 gutenberg_register_vendor_script(
207 $scripts,
208 'react-dom',
209 'https://unpkg.com/react-dom@16.13.1/umd/react-dom' . $react_suffix . '.js',
210 array( 'react' )
211 );
212
213 /*
214 * This script registration and the corresponding function should be removed
215 * removed once the plugin is updated to support WordPress 5.7.0 and newer.
216 */
217 gutenberg_register_vendor_script(
218 $scripts,
219 'object-fit-polyfill',
220 'https://unpkg.com/objectFitPolyfill@2.3.0/dist/objectFitPolyfill.min.js',
221 array(),
222 '2.3.0'
223 );
224 }
225 add_action( 'wp_default_scripts', 'gutenberg_register_vendor_scripts' );
226
227 /**
228 * Registers all the WordPress packages scripts that are in the standardized
229 * `build/` location.
230 *
231 * @since 4.5.0
232 *
233 * @param WP_Scripts $scripts WP_Scripts instance.
234 */
235 function gutenberg_register_packages_scripts( $scripts ) {
236 // When in production, use the plugin's version as the default asset version;
237 // else (for development or test) default to use the current time.
238 $default_version = defined( 'GUTENBERG_VERSION' ) && ! ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) ? GUTENBERG_VERSION : time();
239
240 foreach ( glob( gutenberg_dir_path() . 'build/*/index.js' ) as $path ) {
241 // Prefix `wp-` to package directory to get script handle.
242 // For example, `…/build/a11y/index.js` becomes `wp-a11y`.
243 $handle = 'wp-' . basename( dirname( $path ) );
244
245 // Replace `.js` extension with `.asset.php` to find the generated dependencies file.
246 $asset_file = substr( $path, 0, -3 ) . '.asset.php';
247 $asset = file_exists( $asset_file )
248 ? require( $asset_file )
249 : null;
250 $dependencies = isset( $asset['dependencies'] ) ? $asset['dependencies'] : array();
251 $version = isset( $asset['version'] ) ? $asset['version'] : $default_version;
252
253 // Add dependencies that cannot be detected and generated by build tools.
254 switch ( $handle ) {
255 case 'wp-block-library':
256 array_push( $dependencies, 'editor' );
257 break;
258
259 case 'wp-edit-post':
260 array_push( $dependencies, 'media-models', 'media-views', 'postbox' );
261 break;
262
263 case 'wp-edit-site':
264 array_push( $dependencies, 'wp-dom-ready' );
265 break;
266 }
267
268 // Get the path from Gutenberg directory as expected by `gutenberg_url`.
269 $gutenberg_path = substr( $path, strlen( gutenberg_dir_path() ) );
270
271 gutenberg_override_script(
272 $scripts,
273 $handle,
274 gutenberg_url( $gutenberg_path ),
275 $dependencies,
276 $version,
277 true
278 );
279 }
280 }
281 add_action( 'wp_default_scripts', 'gutenberg_register_packages_scripts' );
282
283 /**
284 * Registers all the WordPress packages styles that are in the standardized
285 * `build/` location.
286 *
287 * @since 6.7.0
288
289 * @param WP_Styles $styles WP_Styles instance.
290 */
291 function gutenberg_register_packages_styles( $styles ) {
292 // When in production, use the plugin's version as the asset version;
293 // else (for development or test) default to use the current time.
294 $version = defined( 'GUTENBERG_VERSION' ) && ! ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) ? GUTENBERG_VERSION : time();
295
296 // Editor Styles.
297 gutenberg_override_style(
298 $styles,
299 'wp-block-editor',
300 gutenberg_url( 'build/block-editor/style.css' ),
301 array( 'wp-components' ),
302 $version
303 );
304 $styles->add_data( 'wp-block-editor', 'rtl', 'replace' );
305
306 gutenberg_override_style(
307 $styles,
308 'wp-editor',
309 gutenberg_url( 'build/editor/style.css' ),
310 array( 'wp-components', 'wp-block-editor', 'wp-nux', 'wp-reusable-blocks' ),
311 $version
312 );
313 $styles->add_data( 'wp-editor', 'rtl', 'replace' );
314
315 gutenberg_override_style(
316 $styles,
317 'wp-edit-post',
318 gutenberg_url( 'build/edit-post/style.css' ),
319 array( 'wp-components', 'wp-block-editor', 'wp-editor', 'wp-edit-blocks', 'wp-block-library', 'wp-nux' ),
320 $version
321 );
322 $styles->add_data( 'wp-edit-post', 'rtl', 'replace' );
323
324 gutenberg_override_style(
325 $styles,
326 'wp-components',
327 gutenberg_url( 'build/components/style.css' ),
328 array( 'dashicons' ),
329 $version
330 );
331 $styles->add_data( 'wp-components', 'rtl', 'replace' );
332
333 $block_library_filename = gutenberg_should_load_separate_block_assets() ? 'common' : 'style';
334 gutenberg_override_style(
335 $styles,
336 'wp-block-library',
337 gutenberg_url( 'build/block-library/' . $block_library_filename . '.css' ),
338 array(),
339 $version
340 );
341 $styles->add_data( 'wp-block-library', 'rtl', 'replace' );
342 $styles->add_data( 'wp-block-library', 'path', gutenberg_dir_path() . 'build/block-library/' . $block_library_filename . '.css' );
343
344 gutenberg_override_style(
345 $styles,
346 'wp-format-library',
347 gutenberg_url( 'build/format-library/style.css' ),
348 array( 'wp-block-editor', 'wp-components' ),
349 $version
350 );
351 $styles->add_data( 'wp-format-library', 'rtl', 'replace' );
352
353 $wp_edit_blocks_dependencies = array(
354 'wp-components',
355 'wp-editor',
356 // This need to be added before the block library styles,
357 // The block library styles override the "reset" styles.
358 'wp-reset-editor-styles',
359 'wp-block-library',
360 'wp-reusable-blocks',
361 );
362
363 global $editor_styles;
364 if ( ! is_array( $editor_styles ) || count( $editor_styles ) === 0 ) {
365 // Include opinionated block styles if no $editor_styles are declared, so the editor never appears broken.
366 $wp_edit_blocks_dependencies[] = 'wp-block-library-theme';
367 }
368
369 gutenberg_override_style(
370 $styles,
371 'wp-reset-editor-styles',
372 gutenberg_url( 'build/block-library/reset.css' ),
373 array(),
374 $version
375 );
376 $styles->add_data( 'wp-reset-editor-styles', 'rtl', 'replace' );
377
378 gutenberg_override_style(
379 $styles,
380 'wp-edit-blocks',
381 gutenberg_url( 'build/block-library/editor.css' ),
382 $wp_edit_blocks_dependencies,
383 $version
384 );
385 $styles->add_data( 'wp-edit-blocks', 'rtl', 'replace' );
386
387 gutenberg_override_style(
388 $styles,
389 'wp-nux',
390 gutenberg_url( 'build/nux/style.css' ),
391 array( 'wp-components' ),
392 $version
393 );
394 $styles->add_data( 'wp-nux', 'rtl', 'replace' );
395
396 gutenberg_override_style(
397 $styles,
398 'wp-block-library-theme',
399 gutenberg_url( 'build/block-library/theme.css' ),
400 array(),
401 $version
402 );
403 $styles->add_data( 'wp-block-library-theme', 'rtl', 'replace' );
404
405 gutenberg_override_style(
406 $styles,
407 'wp-list-reusable-blocks',
408 gutenberg_url( 'build/list-reusable-blocks/style.css' ),
409 array( 'wp-components' ),
410 $version
411 );
412 $styles->add_data( 'wp-list-reusable-block', 'rtl', 'replace' );
413
414 gutenberg_override_style(
415 $styles,
416 'wp-edit-navigation',
417 gutenberg_url( 'build/edit-navigation/style.css' ),
418 array( 'wp-components', 'wp-block-editor', 'wp-edit-blocks' ),
419 $version
420 );
421 $styles->add_data( 'wp-edit-navigation', 'rtl', 'replace' );
422
423 gutenberg_override_style(
424 $styles,
425 'wp-edit-site',
426 gutenberg_url( 'build/edit-site/style.css' ),
427 array( 'wp-components', 'wp-block-editor', 'wp-edit-blocks' ),
428 $version
429 );
430 $styles->add_data( 'wp-edit-site', 'rtl', 'replace' );
431
432 gutenberg_override_style(
433 $styles,
434 'wp-edit-widgets',
435 gutenberg_url( 'build/edit-widgets/style.css' ),
436 array( 'wp-components', 'wp-block-editor', 'wp-edit-blocks', 'wp-reusable-blocks' ),
437 $version
438 );
439 $styles->add_data( 'wp-edit-widgets', 'rtl', 'replace' );
440
441 gutenberg_override_style(
442 $styles,
443 'wp-block-directory',
444 gutenberg_url( 'build/block-directory/style.css' ),
445 array( 'wp-block-editor', 'wp-components' ),
446 $version
447 );
448 $styles->add_data( 'wp-block-directory', 'rtl', 'replace' );
449
450 gutenberg_override_style(
451 $styles,
452 'wp-customize-widgets',
453 gutenberg_url( 'build/customize-widgets/style.css' ),
454 array( 'wp-components', 'wp-block-editor', 'wp-edit-blocks' ),
455 $version
456 );
457 $styles->add_data( 'wp-customize-widgets', 'rtl', 'replace' );
458
459 gutenberg_override_style(
460 $styles,
461 'wp-reusable-blocks',
462 gutenberg_url( 'build/reusable-blocks/style.css' ),
463 array( 'wp-components' ),
464 $version
465 );
466 $styles->add_data( 'wp-reusable-block', 'rtl', 'replace' );
467 }
468 add_action( 'wp_default_styles', 'gutenberg_register_packages_styles' );
469
470 /**
471 * Registers common scripts and styles to be used as dependencies of the editor
472 * and plugins.
473 *
474 * @since 0.1.0
475 */
476 function gutenberg_enqueue_block_editor_assets() {
477 if ( defined( 'GUTENBERG_LIVE_RELOAD' ) && GUTENBERG_LIVE_RELOAD ) {
478 $live_reload_url = ( GUTENBERG_LIVE_RELOAD === true ) ? 'http://localhost:35729/livereload.js' : GUTENBERG_LIVE_RELOAD;
479
480 wp_enqueue_script(
481 'gutenberg-live-reload',
482 $live_reload_url
483 );
484 }
485 }
486 add_action( 'enqueue_block_editor_assets', 'gutenberg_enqueue_block_editor_assets' );
487
488 /**
489 * Retrieves a unique and reasonably short and human-friendly filename for a
490 * vendor script based on a URL and the script handle.
491 *
492 * @param string $handle The name of the script.
493 * @param string $src Full URL of the external script.
494 *
495 * @return string Script filename suitable for local caching.
496 *
497 * @since 0.1.0
498 */
499 function gutenberg_vendor_script_filename( $handle, $src ) {
500 $filename = basename( $src );
501 $match = preg_match(
502 '/^'
503 . '(?P<ignore>.*?)'
504 . '(?P<suffix>\.min)?'
505 . '(?P<extension>\.js)'
506 . '(?P<extra>.*)'
507 . '$/',
508 $filename,
509 $filename_pieces
510 );
511
512 $prefix = $handle;
513 $suffix = $match ? $filename_pieces['suffix'] : '';
514 $hash = substr( md5( $src ), 0, 8 );
515
516 return "${prefix}${suffix}.${hash}.js";
517 }
518
519 /**
520 * Registers a vendor script from a URL, preferring a locally cached version if
521 * possible, or downloading it if the cached version is unavailable or
522 * outdated.
523 *
524 * @param WP_Scripts $scripts WP_Scripts instance.
525 * @param string $handle Name of the script.
526 * @param string $src Full URL of the external script.
527 * @param array $deps Optional. An array of registered script handles this
528 * script depends on.
529 * @param string|bool|null $ver Optional. String specifying script version number, if it has one, which is added to the URL
530 * as a query string for cache busting purposes. If version is set to false, a version
531 * number is automatically added equal to current installed WordPress version.
532 * If set to null, no version is added.
533 * @param bool $in_footer Optional. Whether to enqueue the script before </body> instead of in the <head>.
534 * Default 'false'.
535 *
536 * @since 0.1.0
537 */
538 function gutenberg_register_vendor_script( $scripts, $handle, $src, $deps = array(), $ver = null, $in_footer = false ) {
539 if ( defined( 'GUTENBERG_LOAD_VENDOR_SCRIPTS' ) && ! GUTENBERG_LOAD_VENDOR_SCRIPTS ) {
540 return;
541 }
542
543 $filename = gutenberg_vendor_script_filename( $handle, $src );
544
545 if ( defined( 'GUTENBERG_LIST_VENDOR_ASSETS' ) && GUTENBERG_LIST_VENDOR_ASSETS ) {
546 echo "$src|$filename\n";
547 return;
548 }
549
550 $full_path = gutenberg_dir_path() . 'vendor/' . $filename;
551
552 $needs_fetch = (
553 defined( 'GUTENBERG_DEVELOPMENT_MODE' ) && GUTENBERG_DEVELOPMENT_MODE && (
554 ! file_exists( $full_path ) ||
555 time() - filemtime( $full_path ) >= DAY_IN_SECONDS
556 )
557 );
558
559 if ( $needs_fetch ) {
560 // Determine whether we can write to this file. If not, don't waste
561 // time doing a network request.
562 // @codingStandardsIgnoreStart
563
564 $is_writable = is_writable( $full_path );
565 if ( $is_writable ) {
566 $f = @fopen( $full_path, 'a' );
567 if ( ! $f ) {
568 $is_writable = false;
569 } else {
570 fclose( $f );
571 }
572 }
573
574 // @codingStandardsIgnoreEnd
575 if ( ! $is_writable ) {
576 // Failed to open the file for writing, probably due to server
577 // permissions. Enqueue the script directly from the URL instead.
578 gutenberg_override_script( $scripts, $handle, $src, $deps, $ver, $in_footer );
579 return;
580 }
581
582 $response = wp_remote_get( $src );
583 if ( wp_remote_retrieve_response_code( $response ) === 200 ) {
584 $f = fopen( $full_path, 'w' );
585 fwrite( $f, wp_remote_retrieve_body( $response ) );
586 fclose( $f );
587 } elseif ( ! filesize( $full_path ) ) {
588 // The request failed. If the file is already cached, continue to
589 // use this file. If not, then unlink the 0 byte file, and enqueue
590 // the script directly from the URL.
591 gutenberg_override_script( $scripts, $handle, $src, $deps, $ver, $in_footer );
592 unlink( $full_path );
593 return;
594 }
595 }
596 gutenberg_override_script(
597 $scripts,
598 $handle,
599 gutenberg_url( 'vendor/' . $filename ),
600 $deps,
601 $ver,
602 $in_footer
603 );
604 }
605
606 /**
607 * Extends block editor settings to remove the Gutenberg's `editor-styles.css`;
608 *
609 * @param array $settings Default editor settings.
610 *
611 * @return array Filtered editor settings.
612 */
613 function gutenberg_extend_block_editor_styles( $settings ) {
614 if ( empty( $settings['styles'] ) ) {
615 $settings['styles'] = array();
616 } else {
617 /*
618 * The styles setting is an array of CSS strings, so there is no direct
619 * way to find the default styles. To maximize stability, load (again)
620 * the default styles from disk and find its place in the array.
621 *
622 * See: https://github.com/WordPress/wordpress-develop/blob/5.0.3/src/wp-admin/edit-form-blocks.php#L168-L175
623 */
624
625 $default_styles = file_get_contents(
626 is_rtl() ?
627 ABSPATH . WPINC . '/css/dist/editor/editor-styles-rtl.css' :
628 ABSPATH . WPINC . '/css/dist/editor/editor-styles.css'
629 );
630
631 /*
632 * Iterate backwards from the end of the array since the preferred
633 * insertion point in case not found is prepended as first entry.
634 */
635 for ( $i = count( $settings['styles'] ) - 1; $i >= 0; $i-- ) {
636 if ( isset( $settings['styles'][ $i ]['css'] ) &&
637 $default_styles === $settings['styles'][ $i ]['css'] ) {
638 break;
639 }
640 }
641 }
642
643 // Substitute default styles if found. Otherwise, prepend to setting array.
644 if ( isset( $i ) && $i >= 0 ) {
645 unset( $settings['styles'][ $i ] );
646 }
647
648 // Remove the default font editor styles for FSE themes.
649 if ( gutenberg_is_fse_theme() ) {
650 foreach ( $settings['styles'] as $j => $style ) {
651 if ( 0 === strpos( $style['css'], 'body { font-family:' ) ) {
652 unset( $settings['styles'][ $j ] );
653 }
654 }
655 }
656
657 return $settings;
658 }
659 add_filter( 'block_editor_settings', 'gutenberg_extend_block_editor_styles' );
660
661 /**
662 * Adds a flag to the editor settings to know whether we're in FSE theme or not.
663 *
664 * @param array $settings Default editor settings.
665 *
666 * @return array Filtered editor settings.
667 */
668 function gutenberg_extend_block_editor_settings_with_fse_theme_flag( $settings ) {
669 $settings['isFSETheme'] = gutenberg_is_fse_theme();
670
671 // Enable the new layout options for themes with a theme.json file.
672 $settings['supportsLayout'] = WP_Theme_JSON_Resolver::theme_has_support();
673
674 return $settings;
675 }
676 add_filter( 'block_editor_settings', 'gutenberg_extend_block_editor_settings_with_fse_theme_flag' );
677
678 /**
679 * Sets the editor styles to be consumed by JS.
680 */
681 function gutenberg_extend_block_editor_styles_html() {
682 $handles = array(
683 'wp-block-editor',
684 'wp-block-library',
685 'wp-edit-blocks',
686 );
687
688 $block_registry = WP_Block_Type_Registry::get_instance();
689
690 foreach ( $block_registry->get_all_registered() as $block_type ) {
691 if ( ! empty( $block_type->style ) ) {
692 $handles[] = $block_type->style;
693 }
694
695 if ( ! empty( $block_type->editor_style ) ) {
696 $handles[] = $block_type->editor_style;
697 }
698 }
699
700 $handles = array_unique( $handles );
701 $done = wp_styles()->done;
702
703 ob_start();
704
705 wp_styles()->done = array();
706 wp_styles()->do_items( $handles );
707 wp_styles()->done = $done;
708
709 $editor_styles = wp_json_encode( array( 'html' => ob_get_clean() ) );
710
711 echo "<script>window.__editorStyles = $editor_styles</script>";
712 }
713 add_action( 'admin_footer-toplevel_page_gutenberg-edit-site', 'gutenberg_extend_block_editor_styles_html' );
714
715 /**
716 * Adds a polyfill for object-fit in environments which do not support it.
717 *
718 * The script registration occurs in `gutenberg_register_vendor_scripts`, which
719 * should be removed in coordination with this function.
720 *
721 * Remove this when the minimum supported version is WordPress 5.7
722 *
723 * @see gutenberg_register_vendor_scripts
724 * @see https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit
725 *
726 * @since 9.1.0
727 *
728 * @param WP_Scripts $scripts WP_Scripts object.
729 */
730 function gutenberg_add_object_fit_polyfill( $scripts ) {
731 did_action( 'init' ) && $scripts->add_inline_script(
732 'wp-polyfill',
733 wp_get_script_polyfill(
734 $scripts,
735 array(
736 '"objectFit" in document.documentElement.style' => 'object-fit-polyfill',
737 )
738 )
739 );
740 }
741 add_action( 'wp_default_scripts', 'gutenberg_add_object_fit_polyfill', 20 );
742