← All changes | core/experiments/manager.php +180 -185 4.0.8 → 3.24.0-dev3 View file →

		@@ -1,9 +1,8 @@
1	1	<?php
2	2	namespace Elementor\Core\Experiments;
3	3
4	4	use Elementor\Core\Base\Base_Object;
5		-use Elementor\Core\Experiments\Exceptions\Dependency_Exception;
6	5	use Elementor\Core\Upgrade\Manager as Upgrade_Manager;
7	6	use Elementor\Core\Utils\Collection;
8	7	use Elementor\Modules\System_Info\Module as System_Info;
9	8	use Elementor\Plugin;
		@@ -11,9 +10,9 @@
11	10	use Elementor\Tracker;
12	11	use Elementor\Utils;
13	12
14	13	if ( ! defined( 'ABSPATH' ) ) {
15		- exit; // Exit if accessed directly.
	14	+ exit; // Exit if accessed directly
16	15	}
17	16
18	17	class Manager extends Base_Object {
19	18
		@@ -22,8 +21,10 @@
22	21	const RELEASE_STATUS_ALPHA = 'alpha';
23	22
24	23	const RELEASE_STATUS_BETA = 'beta';
25	24
	25	+ const RELEASE_STATUS_RC = 'rc';
	26	+
26	27	const RELEASE_STATUS_STABLE = 'stable';
27	28
28	29	const STATE_DEFAULT = 'default';
29	30
		@@ -43,26 +44,24 @@
43	44
44	45	/**
45	46	* Add Feature
46	47	*
47		- * Each feature has to provide the following information:
48		- * [
49		- * 'name' => string,
50		- * 'title' => string,
51		- * 'description' => string,
52		- * 'tag' => string,
53		- * 'release_status' => string,
54		- * 'default' => string,
55		- * 'new_site' => array,
56		- * ]
57		- *
58	48	* @since 3.1.0
59	49	* @access public
60	50	*
61		- * @param array $options Feature options.
	51	+ * @param array $options {
	52	+ * @type string $name
	53	+ * @type string $title
	54	+ * @type string $tag
	55	+ * @type array $tags
	56	+ * @type string $description
	57	+ * @type string $release_status
	58	+ * @type string $default
	59	+ * @type callable $on_state_change
	60	+ * }
	61	+ *
62	62	* @return array|null
63		- *
64		- * @throws Dependency_Exception If can't change feature state.
	63	+ * @throws \Exception
65	64	*/
66	65	public function add_feature( array $options ) {
67	66	if ( isset( $this->features[ $options['name'] ] ) ) {
68	67	return null;
		@@ -67,14 +66,48 @@
67	66	if ( isset( $this->features[ $options['name'] ] ) ) {
68	67	return null;
69	68	}
70	69
71		- $experimental_data = $this->set_feature_initial_options( $options );
	70	+ $default_experimental_data = [
	71	+ 'tag' => '', // Deprecated, use 'tags' instead.
	72	+ 'tags' => [],
	73	+ 'description' => '',
	74	+ 'release_status' => self::RELEASE_STATUS_ALPHA,
	75	+ 'default' => self::STATE_INACTIVE,
	76	+ 'mutable' => true,
	77	+ static::TYPE_HIDDEN => false,
	78	+ 'new_site' => [
	79	+ 'always_active' => false,
	80	+ 'default_active' => false,
	81	+ 'default_inactive' => false,
	82	+ 'minimum_installation_version' => null,
	83	+ ],
	84	+ 'on_state_change' => null,
	85	+ 'generator_tag' => false,
	86	+ ];
72	87
	88	+ $allowed_options = [ 'name', 'title', 'tag', 'tags', 'description', 'release_status', 'default', 'mutable', static::TYPE_HIDDEN, 'new_site', 'on_state_change', 'dependencies', 'generator_tag', 'messages' ];
	89	+
	90	+ $experimental_data = $this->merge_properties( $default_experimental_data, $options, $allowed_options );
	91	+
	92	+ $experimental_data = $this->unify_feature_tags( $experimental_data );
	93	+
73	94	$new_site = $experimental_data['new_site'];
74	95
75	96	if ( $new_site['default_active'] || $new_site['always_active'] || $new_site['default_inactive'] ) {
76		- $experimental_data = $this->set_new_site_default_state( $new_site, $experimental_data );
	97	+ $is_new_installation = $this->install_compare( $new_site['minimum_installation_version'] );
	98	+
	99	+ if ( $is_new_installation ) {
	100	+ if ( $new_site['always_active'] ) {
	101	+ $experimental_data['state'] = self::STATE_ACTIVE;
	102	+
	103	+ $experimental_data['mutable'] = false;
	104	+ } elseif ( $new_site['default_active'] ) {
	105	+ $experimental_data['default'] = self::STATE_ACTIVE;
	106	+ } elseif ( $new_site['default_inactive'] ) {
	107	+ $experimental_data['default'] = self::STATE_INACTIVE;
	108	+ }
	109	+ }
77	110	}
78	111
79	112	if ( $experimental_data['mutable'] ) {
80	113	$experimental_data['state'] = $this->get_saved_feature_state( $options['name'] );
		@@ -84,9 +117,17 @@
84	117	$experimental_data['state'] = self::STATE_DEFAULT;
85	118	}
86	119
87	120	if ( ! empty( $experimental_data['dependencies'] ) ) {
88		- $experimental_data = $this->initialize_feature_dependencies( $experimental_data );
	121	+ foreach ( $experimental_data['dependencies'] as $key => $dependency ) {
	122	+ $feature = $this->get_features( $dependency );
	123	+
	124	+ if ( ! empty( $feature[ static::TYPE_HIDDEN ] ) ) {
	125	+ throw new Exceptions\Dependency_Exception( 'Depending on a hidden experiment is not allowed.' );
	126	+ }
	127	+
	128	+ $experimental_data['dependencies'][ $key ] = $this->create_dependency_class( $dependency, $feature );
	129	+ }
89	130	}
90	131
91	132	$this->features[ $options['name'] ] = $experimental_data;
92	133
		@@ -120,11 +161,9 @@
120	161	private function install_compare( $version ) {
121	162	$installs_history = Upgrade_Manager::get_installs_history();
122	163
123	164	if ( empty( $installs_history ) ) {
124		- // Fresh installation: upgrade manager hasn't written history yet on this first request.
125		- // Use the current plugin version as the effective first-install version.
126		- return version_compare( ELEMENTOR_VERSION, $version, '>=' );
	165	+ return false;
127	166	}
128	167
129	168	$cleaned_version = preg_replace( '/-(beta|cloud|dev)\d*$/', '', key( $installs_history ) );
130	169
		@@ -141,9 +180,9 @@
141	180	* @param array $experimental_data
142	181	*
143	182	* @return array
144	183	*/
145		- private function unify_feature_tags( array $experimental_data ): array {
	184	+ private function unify_feature_tags( array $experimental_data ) : array {
146	185	foreach ( [ 'tag', 'tags' ] as $key ) {
147	186	if ( empty( $experimental_data[ $key ] ) ) {
148	187	continue;
149	188	}
		@@ -160,21 +199,18 @@
160	199
161	200	/**
162	201	* Format feature tags into the right format.
163	202	*
164		- * If an array of tags provided, each tag has to provide the following information:
165		- * [
166		- * [
167		- * 'type' => string,
168		- * 'label' => string,
169		- * ]
170		- * ]
	203	+ * @param string|array[
	204	+ * [
	205	+ * 'type' => string,
	206	+ * 'label' => string
	207	+ * ]
	208	+ * ] $tag
171	209	*
172		- * @param string|array $tags A string of comma separated tags, or an array of tags.
173		- *
174	210	* @return array
175	211	*/
176		- private function format_feature_tags( $tags ): array {
	212	+ private function format_feature_tags( $tags ) : array {
177	213	if ( ! is_string( $tags ) && ! is_array( $tags ) ) {
178	214	return [];
179	215	}
180	216
		@@ -223,9 +259,9 @@
223	259	*
224	260	* @since 3.1.0
225	261	* @access public
226	262	*
227		- * @param string $feature_name Optional. Default is null.
	263	+ * @param string $feature_name Optional. Default is null
228	264	*
229	265	* @return array|null
230	266	*/
231	267	public function get_features( $feature_name = null ) {
		@@ -253,27 +289,16 @@
253	289	* @param string $feature_name
254	290	*
255	291	* @return bool
256	292	*/
257		- public function is_feature_active( $feature_name, $check_dependencies = false ) {
	293	+ public function is_feature_active( $feature_name ) {
258	294	$feature = $this->get_features( $feature_name );
259	295
260		- if ( ! $feature || self::STATE_ACTIVE !== $this->get_feature_actual_state( $feature ) ) {
	296	+ if ( ! $feature ) {
261	297	return false;
262	298	}
263	299
264		- if ( $check_dependencies && isset( $feature['dependencies'] ) && is_array( $feature['dependencies'] ) ) {
265		- foreach ( $feature['dependencies'] as $dependency ) {
266		- $dependent_feature = $this->get_features( $dependency->get_name() );
267		- $feature_state = self::STATE_ACTIVE === $this->get_feature_actual_state( $dependent_feature );
268		-
269		- if ( ! $feature_state ) {
270		- return false;
271		- }
272		- }
273		- }
274		-
275		- return true;
	300	+ return self::STATE_ACTIVE === $this->get_feature_actual_state( $feature );
276	301	}
277	302
278	303	/**
279	304	* Set Feature Default State
		@@ -309,8 +334,24 @@
309	334	}
310	335
311	336	private function add_default_features() {
312	337	$this->add_feature( [
	338	+ 'name' => 'e_optimized_css_loading',
	339	+ 'title' => esc_html__( 'Improved CSS Loading', 'elementor' ),
	340	+ 'tag' => esc_html__( 'Performance', 'elementor' ),
	341	+ 'description' => sprintf(
	342	+ '%1$s <a href="https://go.elementor.com/wp-dash-improved-css-loading/" target="_blank">%2$s</a>',
	343	+ esc_html__( 'Please Note! The “Improved CSS Loading” mode reduces the amount of CSS code that is loaded on the page by default. When activated, the CSS code will be loaded, rather inline or in a dedicated file, only when needed. Activating this experiment may cause conflicts with incompatible plugins.', 'elementor' ),
	344	+ esc_html__( 'Learn more', 'elementor' )
	345	+ ),
	346	+ 'release_status' => self::RELEASE_STATUS_STABLE,
	347	+ 'default' => self::STATE_INACTIVE,
	348	+ static::TYPE_HIDDEN => true,
	349	+ 'mutable' => false,
	350	+ 'generator_tag' => true,
	351	+ ] );
	352	+
	353	+ $this->add_feature( [
313	354	'name' => 'e_font_icon_svg',
314	355	'title' => esc_html__( 'Inline Font Icons', 'elementor' ),
315	356	'tag' => esc_html__( 'Performance', 'elementor' ),
316	357	'description' => sprintf(
		@@ -340,16 +381,18 @@
340	381	] );
341	382
342	383	$this->add_feature( [
343	384	'name' => 'container',
344		- 'title' => esc_html__( 'Container', 'elementor' ),
	385	+ 'title' => esc_html__( 'Flexbox Container', 'elementor' ),
345	386	'description' => sprintf(
346		- /* translators: 1: Link opening tag, 2: Link closing tag, 3: Link opening tag, 4: Link closing tag, 5: Link opening tag, 6: Link closing tag */
347		- esc_html__( 'Create advanced layouts and responsive designs with %1$sFlexbox%2$s and %3$sGrid%4$s container elements. Give it a try using the %5$sContainer playground%6$s.', 'elementor' ),
	387	+ esc_html__(
	388	+ 'Create advanced layouts and responsive designs with the new %1$sFlexbox Container element%2$s.
	389	+ This experiment replaces the current section/column structure, but you\'ll still keep your existing
	390	+ Sections, Inner Sections and Columns and be able to edit them. Ready to give it a try? Check out the %3$sFlexbox playground%4$s.',
	391	+ 'elementor'
	392	+ ),
348	393	'<a target="_blank" href="https://go.elementor.com/wp-dash-flex-container/">',
349	394	'</a>',
350		- '<a target="_blank" href="https://go.elementor.com/wp-dash-grid-container/">',
351		- '</a>',
352	395	'<a target="_blank" href="https://go.elementor.com/wp-dash-flex-container-playground/">',
353	396	'</a>'
354	397	),
355	398	'release_status' => self::RELEASE_STATUS_STABLE,
		@@ -367,19 +410,80 @@
367	410	],
368	411	] );
369	412
370	413	$this->add_feature( [
	414	+ 'name' => 'container_grid',
	415	+ 'title' => esc_html__( 'Grid Container', 'elementor' ),
	416	+ 'tag' => esc_html__( 'Feature', 'elementor' ),
	417	+ 'description' => sprintf(
	418	+ '%1$s <a target="_blank" href="https://go.elementor.com/wp-dash-grid-container/">%2$s</a>',
	419	+ esc_html__( 'Create pixel perfect layouts by placing elements in a customizable grid. Activate to add the CSS Grid option to container elements.', 'elementor' ),
	420	+ esc_html__( 'Learn more', 'elementor' ),
	421	+ ),
	422	+ 'release_status' => self::RELEASE_STATUS_STABLE,
	423	+ 'default' => self::STATE_ACTIVE,
	424	+ 'dependencies' => [
	425	+ 'container',
	426	+ ],
	427	+ ] );
	428	+
	429	+ $this->add_feature( [
	430	+ 'name' => 'e_swiper_latest',
	431	+ 'title' => esc_html__( 'Upgrade Swiper Library', 'elementor' ),
	432	+ 'description' => esc_html__( 'Prepare your website for future improvements to carousel features by upgrading the Swiper library integrated into your site from v5.36 to v8.45. This experiment includes markup changes so it might require updating custom code and cause compatibility issues with third party plugins.', 'elementor' ),
	433	+ 'release_status' => self::RELEASE_STATUS_STABLE,
	434	+ 'default' => self::STATE_ACTIVE,
	435	+ ] );
	436	+
	437	+ $this->add_feature( [
	438	+ 'name' => 'e_nested_atomic_repeaters',
	439	+ 'title' => esc_html__( 'Nested Elements Performance', 'elementor' ),
	440	+ 'tag' => esc_html__( 'Performance', 'elementor' ),
	441	+ 'description' => esc_html__( 'Improve the performance of the Nested widgets.', 'elementor' ),
	442	+ static::TYPE_HIDDEN => true,
	443	+ 'release_status' => self::RELEASE_STATUS_DEV,
	444	+ 'default' => self::STATE_ACTIVE,
	445	+ ] );
	446	+
	447	+ $this->add_feature( [
	448	+ 'name' => 'e_optimized_control_loading',
	449	+ 'title' => esc_html__( 'Optimized Control Loading', 'elementor' ),
	450	+ 'tag' => esc_html__( 'Performance', 'elementor' ),
	451	+ 'description' => esc_html__( 'Use this experiment to improve control loading. This experiment improves site performance by loading controls only when needed.', 'elementor' ),
	452	+ 'release_status' => self::RELEASE_STATUS_BETA,
	453	+ 'default' => self::STATE_INACTIVE,
	454	+ 'new_site' => [
	455	+ 'default_active' => true,
	456	+ 'minimum_installation_version' => '3.22.0',
	457	+ ],
	458	+ 'generator_tag' => true,
	459	+ ] );
	460	+
	461	+ $this->add_feature( [
371	462	'name' => 'e_optimized_markup',
372	463	'title' => esc_html__( 'Optimized Markup', 'elementor' ),
373	464	'tag' => esc_html__( 'Performance', 'elementor' ),
374	465	'description' => esc_html__( 'Reduce the DOM size by eliminating HTML tags in various elements and widgets. This experiment includes markup changes so it might require updating custom CSS/JS code and cause compatibility issues with third party plugins.', 'elementor' ),
375		- 'release_status' => self::RELEASE_STATUS_STABLE,
	466	+ static::TYPE_HIDDEN => true,
	467	+ 'release_status' => self::RELEASE_STATUS_DEV,
376	468	'default' => self::STATE_INACTIVE,
377		- 'new_site' => [
378		- 'default_active' => true,
379		- 'minimum_installation_version' => '3.30.0',
380		- ],
381	469	] );
	470	+
	471	+ $this->add_feature( [
	472	+ 'name' => 'e_swiper_css_conditional_loading',
	473	+ 'title' => esc_html__( 'Conditionally load Swiper CSS files', 'elementor' ),
	474	+ static::TYPE_HIDDEN => true,
	475	+ 'default' => self::STATE_INACTIVE,
	476	+ ] );
	477	+
	478	+ $this->add_feature( [
	479	+ 'name' => 'e_onboarding',
	480	+ 'title' => esc_html__( 'Plugin Onboarding', 'elementor' ),
	481	+ 'description' => esc_html__( 'New plugin onboarding.', 'elementor' ),
	482	+ static::TYPE_HIDDEN => true,
	483	+ 'release_status' => self::RELEASE_STATUS_ALPHA,
	484	+ 'default' => self::STATE_ACTIVE,
	485	+ ] );
382	486	}
383	487
384	488	/**
385	489	* Init States
		@@ -405,8 +509,9 @@
405	509	$this->release_statuses = [
406	510	self::RELEASE_STATUS_DEV => esc_html__( 'Development', 'elementor' ),
407	511	self::RELEASE_STATUS_ALPHA => esc_html__( 'Alpha', 'elementor' ),
408	512	self::RELEASE_STATUS_BETA => esc_html__( 'Beta', 'elementor' ),
	513	+ self::RELEASE_STATUS_RC => esc_html__( 'Release Candidate', 'elementor' ),
409	514	self::RELEASE_STATUS_STABLE => esc_html__( 'Stable', 'elementor' ),
410	515	];
411	516	}
412	517
		@@ -430,8 +535,9 @@
430	535	* @param Settings $settings
431	536	*
432	537	* @since 3.1.0
433	538	* @access private
	539	+ *
434	540	*/
435	541	private function register_settings_fields( Settings $settings ) {
436	542	$features = $this->get_features();
437	543
		@@ -519,9 +625,9 @@
519	625	<?php echo esc_html__( 'Experiments and Features', 'elementor' ); ?>
520	626	</h2>
521	627	<p class="e-experiment__description">
522	628	<?php
523		- printf(
	629	+ echo sprintf(
524	630	/* translators: %1$s Link open tag, %2$s: Link close tag. */
525	631	esc_html__( 'Personalize your Elementor experience by controlling which features and experiments are active on your site. Help make Elementor better by %1$ssharing your experience and feedback with us%2$s.', 'elementor' ),
526	632	'<a href="https://go.elementor.com/wp-dash-experiments-report-an-issue/" target="_blank">',
527	633	'</a>'
		@@ -529,9 +635,9 @@
529	635	?>
530	636	</p>
531	637	<p class="e-experiment__description">
532	638	<?php
533		- printf(
	639	+ echo sprintf(
534	640	'%1$s <a href="https://go.elementor.com/wp-dash-experiments/" target="_blank">%2$s</a>',
535	641	esc_html__( 'To use an experiment or feature on your site, simply click on the dropdown next to it and switch to Active. You can always deactivate them at any time.', 'elementor' ),
536	642	esc_html__( 'Learn more', 'elementor' ),
537	643	);
		@@ -623,13 +729,13 @@
623	729	->find( function ( $dependency ) {
624	730	return $dependency instanceof Non_Existing_Dependency;
625	731	} );
626	732
627		- return (bool) $non_existing_dep;
	733	+ return ! ! $non_existing_dep;
628	734	}
629	735
630	736	/**
631		- * Get Feature Settings Label HTML.
	737	+ * Get Feature Settings Label HTML
632	738	*
633	739	* @since 3.1.0
634	740	* @access private
635	741	*
		@@ -654,16 +760,10 @@
654	760	<div class="e-experiment__title">
655	761	<div class="<?php echo $indicator_classes; ?>" data-tooltip="<?php echo $indicator_tooltip; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>"></div>
656	762	<label class="e-experiment__title__label" for="e-experiment-<?php echo $feature['name']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>"><?php echo $feature['title']; ?></label>
657	763	<?php foreach ( $feature['tags'] as $tag ) { ?>
658		- <?php
659		- $tag_classes = 'e-experiment__title__tag e-experiment__title__tag__' . $tag['type'] . ' e-editor-one';
660		- ?>
661		- <span class="<?php echo esc_attr( $tag_classes ); ?>"><?php echo $tag['label']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></span>
	764	+ <span class="e-experiment__title__tag e-experiment__title__tag__<?php echo $tag['type']; ?>"><?php echo $tag['label']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></span>
662	765	<?php } ?>
663		- <?php if ( $feature['deprecated'] ) { ?>
664		- <span class="e-experiment__title__tag e-experiment__title__tag__deprecated"><?php echo esc_html__( 'Deprecated', 'elementor' ); ?></span>
665		- <?php } ?>
666	766	</div>
667	767	<?php
668	768
669	769	return ob_get_clean();
		@@ -727,11 +827,12 @@
727	827	*
728	828	* @since 3.1.0
729	829	* @access private
730	830	*
731		- * @param array $old_feature_data
	831	+ * @param array $old_feature_data
732	832	* @param string $new_state
733		- * @param string $old_state
	833	+ *
	834	+ * @throws \Elementor\Core\Experiments\Exceptions\Dependency_Exception
734	835	*/
735	836	private function on_feature_state_change( array $old_feature_data, $new_state, $old_state ) {
736	837	$new_feature_data = $this->get_features( $old_feature_data['name'] );
737	838	$this->validate_dependency( $new_feature_data, $new_state );
		@@ -748,9 +849,9 @@
748	849	do_action( 'elementor/experiments/feature-state-change/' . $old_feature_data['name'], $old_state, $new_state );
749	850	}
750	851
751	852	/**
752		- * @throws Exceptions\Dependency_Exception If the feature dependency is not available or not active.
	853	+ * @throws \Elementor\Core\Experiments\Exceptions\Dependency_Exception
753	854	*/
754	855	private function validate_dependency( array $feature, $new_state ) {
755	856	$rollback = function ( $feature_option_key, $state ) {
756	857	remove_all_actions( 'add_option_' . $feature_option_key );
		@@ -779,10 +880,10 @@
779	880
780	881	throw new Exceptions\Dependency_Exception(
781	882	sprintf(
782	883	'The feature `%s` has a dependency `%s` that is not available.',
783		- esc_html( $feature['name'] ),
784		- esc_html( $dependency->get_name() )
	884	+ $feature['name'],
	885	+ $dependency->get_name()
785	886	)
786	887	);
787	888	}
788	889
		@@ -794,10 +895,10 @@
794	895
795	896	throw new Exceptions\Dependency_Exception(
796	897	sprintf(
797	898	'To turn on `%1$s`, Experiment: `%2$s` activity is required!',
798		- esc_html( $feature['name'] ),
799		- esc_html( $dependency_feature['name'] )
	899	+ $feature['name'],
	900	+ $dependency_feature['name']
800	901	)
801	902	);
802	903	}
803	904	}
		@@ -842,9 +943,11 @@
842	943	* This behavior interferes with the experiments dependency mechanism because the data that's being sent can be in any order,
843	944	* while the dependencies mechanism expects it to be in a specific order (dependencies should be activated before their dependents can).
844	945	* In order to solve this issue, we sort the experiments in the POST data based on their dependencies tree.
845	946	*
846		- * @param array $allowed_options
	947	+ * @param $allowed_options
	948	+ *
	949	+ * @return mixed
847	950	*/
848	951	private function sort_allowed_options_by_dependencies( $allowed_options ) {
849	952	if ( ! isset( $allowed_options['elementor'] ) ) {
850	953	return $allowed_options;
		@@ -932,114 +1035,6 @@
932	1035	// Register CLI commands.
933	1036	if ( Utils::is_wp_cli() ) {
934	1037	\WP_CLI::add_command( 'elementor experiments', WP_CLI::class );
935	1038	}
936		- }
937		-
938		- /**
939		- * @param array $experimental_data
940		- * @return array
941		- *
942		- * @throws Exceptions\Dependency_Exception If the feature dependency is not initialized or depends on a hidden experiment.
943		- */
944		- private function initialize_feature_dependencies( array $experimental_data ): array {
945		- foreach ( $experimental_data['dependencies'] as $key => $dependency ) {
946		- $feature = $this->get_features( $dependency );
947		-
948		- if ( ! isset( $feature ) ) {
949		- // since we must validate the state of each dependency, we have to make sure that dependencies are initialized in the correct order, otherwise, error.
950		- throw new Exceptions\Dependency_Exception(
951		- sprintf(
952		- 'Feature %s cannot be initialized before dependency feature: %s.',
953		- esc_html( $experimental_data['name'] ),
954		- esc_html( $dependency )
955		- )
956		- );
957		- }
958		-
959		- if ( ! empty( $feature[ static::TYPE_HIDDEN ] ) ) {
960		- throw new Exceptions\Dependency_Exception( 'Depending on a hidden experiment is not allowed.' );
961		- }
962		-
963		- $experimental_data['dependencies'][ $key ] = $this->create_dependency_class( $dependency, $feature );
964		- $experimental_data = $this->set_feature_default_state_to_match_dependencies( $feature, $experimental_data );
965		- }
966		-
967		- return $experimental_data;
968		- }
969		-
970		- /**
971		- * @param array $feature
972		- * @param array $experimental_data
973		- * @return array
974		- *
975		- * we must validate the state:
976		- * * A user can set a dependant feature to inactive and in upgrade we don't change users settings.
977		- * * A developer can set the default state to be invalid (e.g. dependant feature is inactive).
978		- * if one of the dependencies is inactive, the main feature should be inactive as well.
979		- */
980		- private function set_feature_default_state_to_match_dependencies( array $feature, array $experimental_data ): array {
981		- if ( self::STATE_INACTIVE !== $this->get_feature_actual_state( $feature ) ) {
982		- return $experimental_data;
983		- }
984		-
985		- if ( self::STATE_ACTIVE === $experimental_data['state'] ) {
986		- $experimental_data['state'] = self::STATE_INACTIVE;
987		- } elseif ( self::STATE_DEFAULT === $experimental_data['state'] ) {
988		- $experimental_data['default'] = self::STATE_INACTIVE;
989		- }
990		-
991		- return $experimental_data;
992		- }
993		-
994		- /**
995		- * @param array $new_site
996		- * @param array $experimental_data
997		- * @return array
998		- */
999		- private function set_new_site_default_state( $new_site, array $experimental_data ): array {
1000		- if ( ! $this->install_compare( $new_site['minimum_installation_version'] ) ) {
1001		- return $experimental_data;
1002		- }
1003		-
1004		- if ( $new_site['always_active'] ) {
1005		- $experimental_data['state'] = self::STATE_ACTIVE;
1006		- $experimental_data['mutable'] = false;
1007		- } elseif ( $new_site['default_active'] ) {
1008		- $experimental_data['default'] = self::STATE_ACTIVE;
1009		- } elseif ( $new_site['default_inactive'] ) {
1010		- $experimental_data['default'] = self::STATE_INACTIVE;
1011		- }
1012		-
1013		- return $experimental_data;
1014		- }
1015		-
1016		- /**
1017		- * @param array $options
1018		- * @return array
1019		- */
1020		- private function set_feature_initial_options( array $options ): array {
1021		- $default_experimental_data = [
1022		- 'tag' => '', // Deprecated, use 'tags' instead.
1023		- 'tags' => [],
1024		- 'description' => '',
1025		- 'release_status' => self::RELEASE_STATUS_ALPHA,
1026		- 'default' => self::STATE_INACTIVE,
1027		- 'mutable' => true,
1028		- static::TYPE_HIDDEN => false,
1029		- 'new_site' => [
1030		- 'always_active' => false,
1031		- 'default_active' => false,
1032		- 'default_inactive' => false,
1033		- 'minimum_installation_version' => null,
1034		- ],
1035		- 'on_state_change' => null,
1036		- 'generator_tag' => false,
1037		- 'deprecated' => false,
1038		- ];
1039		-
1040		- $allowed_options = [ 'name', 'title', 'tag', 'tags', 'description', 'release_status', 'default', 'mutable', static::TYPE_HIDDEN, 'new_site', 'on_state_change', 'dependencies', 'generator_tag', 'messages', 'deprecated' ];
1041		- $experimental_data = $this->merge_properties( $default_experimental_data, $options, $allowed_options );
1042		-
1043		- return $this->unify_feature_tags( $experimental_data );
1044	1039	}
1045	1040	}