'Feature %1$s depends on hidden experiment %2$s.', esc_html( $experimental_data['name'] ), esc_html( $dependency ) ) ); } $experimental_data['dependencies'][ $key ] = $this->create_dependency_class( $dependency, $feature ); $experimental_data = $this->set_feature_default_state_to_match_dependencies( $feature, $experimental_data ); } return $experimental_data; } private function is_removed_or_hidden_dependency( $dependency_feature ): bool { if ( ! $dependency_feature ) { return true; } return ! empty( $dependency_feature[ static::TYPE_HIDDEN ] ); } /** * Re-resolve non existing dependency placeholders of dependants that were * registered before this feature existed. * * @param string $feature_name Newly registered feature name. * @param array $feature_data Newly registered feature data. */ private function resolve_registered_dependants( string $feature_name, array $feature_data ): void { foreach ( $this->features as $name => $registered_feature ) { if ( $name === $feature_name || empty( $registered_feature['dependencies'] ) || ! is_array( $registered_feature['dependencies'] ) ) { continue; } foreach ( $registered_feature['dependencies'] as $key => $dependency ) { if ( ! ( $dependency instanceof Non_Existing_Dependency ) || $dependency->get_name() !== $feature_name ) { continue; } $this->features[ $name ]['dependencies'][ $key ] = $this->create_dependency_class( $feature_name, $feature_data ); } } } private function warn_removed_or_hidden_dependency( string $message ): void { if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG ) { return; } // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Developer notice; message is escaped. _doing_it_wrong( __METHOD__, esc_html( $message ), ELEMENTOR_VERSION ); } /** * @param array $feature * @param array $experimental_data * @return array * * we must validate the state: * * A user can set a dependant feature to inactive and in upgrade we don't change users settings. * * A developer can set the default state to be invalid (e.g. dependant feature is inactive). * if one of the dependencies is inactive, the main feature should be inactive as well. */ private function set_feature_default_state_to_match_dependencies( array $feature, array $experimental_data ): array { if ( self::STATE_INACTIVE !== $this->get_feature_actual_state( $feature ) ) { return $experimental_data; } if ( self::STATE_ACTIVE === $experimental_data['state'] ) { $experimental_data['state'] = self::STATE_INACTIVE; } elseif ( self::STATE_DEFAULT === $experimental_data['state'] ) { $experimental_data['default'] = self::STATE_INACTIVE; } return $experimental_data; } /** * @param array $new_site * @param array $experimental_data * @return array */ private function set_new_site_default_state( $new_site, array $experimental_data ): array { if ( ! $this->install_compare( $new_site['minimum_installation_version'] ) ) { return $experimental_data; } if ( $new_site['always_active'] ) { $experimental_data['state'] = self::STATE_ACTIVE; $experimental_data['mutable'] = false; } elseif ( $new_site['default_active'] ) { $experimental_data['default'] = self::STATE_ACTIVE; } elseif ( $new_site['default_inactive'] ) { $experimental_data['default'] = self::STATE_INACTIVE; } return $experimental_data; } /** * @param array $options * @return array */ private function set_feature_initial_options( array $options ): array { $default_experimental_data = [ 'tag' => '', // Deprecated, use 'tags' instead. 'tags' => [], 'description' => '', 'release_status' => self::RELEASE_STATUS_ALPHA, 'default' => self::STATE_INACTIVE, 'mutable' => true, static::TYPE_HIDDEN => false, 'new_site' => [ 'always_active' => false, 'default_active' => false, 'default_inactive' => false, 'minimum_installation_version' => null, ], 'on_state_change' => null, 'generator_tag' => false, 'deprecated' => false, ]; $allowed_options = [ 'name', 'title', 'tag', 'tags', 'description', 'release_status', 'default', 'mutable', static::TYPE_HIDDEN, 'new_site', 'on_state_change', 'dependencies', 'generator_tag', 'messages', 'deprecated' ]; $experimental_data = $this->merge_properties( $default_experimental_data, $options, $allowed_options ); return $this->unify_feature_tags( $experimental_data ); } }