gutenberg / lib / experiments-page.php

experiments-page.php in Gutenberg 11.7.0, at lib/experiments-page.php

123 lines 3.5 KB

Raw Download Zip

1	<?php
2	/**
3	* Bootstrapping the Gutenberg experiments page.
4	*
5	* @package gutenberg
6	*/
7
8	/**
9	* The main entry point for the Gutenberg experiments page.
10	*
11	* @since 6.3.0
12	*/
13	function the_gutenberg_experiments() {
14	?>
15	<div
16	id="experiments-editor"
17	class="wrap"
18	>
19	<h1><?php echo __( 'Experimental settings', 'gutenberg' ); ?></h1>
20	<?php settings_errors(); ?>
21	<form method="post" action="options.php">
22	<?php settings_fields( 'gutenberg-experiments' ); ?>
23	<?php do_settings_sections( 'gutenberg-experiments' ); ?>
24	<?php submit_button(); ?>
25	</form>
26	</div>
27	<?php
28	}
29
30	/**
31	* Set up the experiments settings.
32	*
33	* @since 6.3.0
34	*/
35	function gutenberg_initialize_experiments_settings() {
36	add_settings_section(
37	'gutenberg_experiments_section',
38	// The empty string ensures the render function won't output a h2.
39	'',
40	'gutenberg_display_experiment_section',
41	'gutenberg-experiments'
42	);
43	add_settings_field(
44	'gutenberg-navigation',
45	__( 'Navigation', 'gutenberg' ),
46	'gutenberg_display_experiment_field',
47	'gutenberg-experiments',
48	'gutenberg_experiments_section',
49	array(
50	'label' => __( 'Enable Navigation screen', 'gutenberg' ),
51	'id' => 'gutenberg-navigation',
52	)
53	);
54	add_settings_field(
55	'gutenberg-gallery-refactor',
56	__( 'Gallery block experiment', 'gutenberg' ),
57	'gutenberg_display_experiment_field',
58	'gutenberg-experiments',
59	'gutenberg_experiments_section',
60	array(
61	'label' => __( 'Test a new gallery block that uses nested image blocks (Warning: The new gallery is not compatible with WordPress mobile apps prior to version 18.2. If you use the mobile app, please update to the latest version to avoid content loss.)', 'gutenberg' ),
62	'id' => 'gutenberg-gallery-refactor',
63	)
64	);
65	register_setting(
66	'gutenberg-experiments',
67	'gutenberg-experiments'
68	);
69	}
70
71	add_action( 'admin_init', 'gutenberg_initialize_experiments_settings' );
72
73	/**
74	* Display a checkbox field for a Gutenberg experiment.
75	*
76	* @since 6.3.0
77	*
78	* @param array $args ( $label, $id ).
79	*/
80	function gutenberg_display_experiment_field( $args ) {
81	$options = get_option( 'gutenberg-experiments' );
82	$value = isset( $options[ $args['id'] ] ) ? 1 : 0;
83	?>
84	<label for="<?php echo $args['id']; ?>">
85	<input type="checkbox" name="<?php echo 'gutenberg-experiments[' . $args['id'] . ']'; ?>" id="<?php echo $args['id']; ?>" value="1" <?php checked( 1, $value ); ?> />
86	<?php echo $args['label']; ?>
87	</label>
88	<?php
89	}
90
91	/**
92	* Display the experiments section.
93	*
94	* @since 6.3.0
95	*/
96	function gutenberg_display_experiment_section() {
97	?>
98	<p><?php echo __( "The block editor includes experimental features that are useable while they're in development. Select the ones you'd like to enable. These features are likely to change, so avoid using them in production.", 'gutenberg' ); ?></p>
99
100	<?php
101	}
102
103	/**
104	* Extends default editor settings with experiments settings.
105	*
106	* @param array $settings Default editor settings.
107	*
108	* @return array Filtered editor settings.
109	*/
110	function gutenberg_experiments_editor_settings( $settings ) {
111	$experiments = get_option( 'gutenberg-experiments' );
112	$experiments_settings = array(
113	'__unstableGalleryWithImageBlocks' => isset( $experiments['gutenberg-gallery-refactor'] ),
114	);
115	return array_merge( $settings, $experiments_settings );
116	}
117	// This can be removed when plugin support requires WordPress 5.8.0+.
118	if ( function_exists( 'get_block_editor_settings' ) ) {
119	add_filter( 'block_editor_settings_all', 'gutenberg_experiments_editor_settings' );
120	} else {
121	add_filter( 'block_editor_settings', 'gutenberg_experiments_editor_settings' );
122	}
123