%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
namespace Elementor\Core\Experiments;
use Elementor\Core\Base\Base_Object;
use Elementor\Core\Upgrade\Manager as Upgrade_Manager;
use Elementor\Modules\System_Info\Module as System_Info;
use Elementor\Plugin;
use Elementor\Settings;
use Elementor\Tracker;
use Elementor\Utils;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly
}
class Manager extends Base_Object {
const RELEASE_STATUS_DEV = 'dev';
const RELEASE_STATUS_ALPHA = 'alpha';
const RELEASE_STATUS_BETA = 'beta';
const RELEASE_STATUS_RC = 'rc';
const RELEASE_STATUS_STABLE = 'stable';
const STATE_DEFAULT = 'default';
const STATE_ACTIVE = 'active';
const STATE_INACTIVE = 'inactive';
private $states;
private $release_statuses;
private $features;
/**
* Add Feature
*
* @since 3.1.0
* @access public
*
* @param array $options {
* @type string $name
* @type string $title
* @type string $description
* @type string $release_status
* @type string $default
* @type callable $on_state_change
* }
*
* @return array|null
*/
public function add_feature( array $options ) {
if ( isset( $this->features[ $options['name'] ] ) ) {
return null;
}
$default_experimental_data = [
'description' => '',
'release_status' => self::RELEASE_STATUS_ALPHA,
'default' => self::STATE_INACTIVE,
'mutable' => true,
'new_site' => [
'default_active' => false,
'always_active' => false,
'minimum_installation_version' => null,
],
'on_state_change' => null,
];
$allowed_options = [ 'name', 'title', 'description', 'release_status', 'default', 'mutable', 'new_site', 'on_state_change' ];
$experimental_data = $this->merge_properties( $default_experimental_data, $options, $allowed_options );
$new_site = $experimental_data['new_site'];
if ( $new_site['default_active'] || $new_site['always_active'] ) {
$is_new_installation = Upgrade_Manager::install_compare( $new_site['minimum_installation_version'], '>=' );
if ( $is_new_installation ) {
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;
}
}
}
if ( $experimental_data['mutable'] ) {
$experimental_data['state'] = $this->get_saved_feature_state( $options['name'] );
}
if ( empty( $experimental_data['state'] ) ) {
$experimental_data['state'] = self::STATE_DEFAULT;
}
$this->features[ $options['name'] ] = $experimental_data;
if ( $experimental_data['mutable'] && is_admin() ) {
$feature_option_key = $this->get_feature_option_key( $options['name'] );
$on_state_change_callback = function( $old_state, $new_state ) use ( $experimental_data ) {
$this->on_feature_state_change( $experimental_data, $new_state );
};
add_action( 'add_option_' . $feature_option_key, $on_state_change_callback, 10, 2 );
add_action( 'update_option_' . $feature_option_key, $on_state_change_callback, 10, 2 );
}
do_action( 'elementor/experiments/feature-registered', $this, $experimental_data );
return $experimental_data;
}
/**
* Remove Feature
*
* @since 3.1.0
* @access public
*
* @param string $feature_name
*/
public function remove_feature( $feature_name ) {
unset( $this->features[ $feature_name ] );
}
/**
* Get Features
*
* @since 3.1.0
* @access public
*
* @param string $feature_name Optional. Default is null
*
* @return array|null
*/
public function get_features( $feature_name = null ) {
return self::get_items( $this->features, $feature_name );
}
/**
* Get Active Features
*
* @since 3.1.0
* @access public
*
* @return array
*/
public function get_active_features() {
return array_filter( $this->features, [ $this, 'is_feature_active' ], ARRAY_FILTER_USE_KEY );
}
/**
* Is Feature Active
*
* @since 3.1.0
* @access public
*
* @param string $feature_name
*
* @return bool
*/
public function is_feature_active( $feature_name ) {
$feature = $this->get_features( $feature_name );
if ( ! $feature ) {
return false;
}
return self::STATE_ACTIVE === $this->get_feature_actual_state( $feature );
}
/**
* Set Feature Default State
*
* @since 3.1.0
* @access public
*
* @param string $feature_name
* @param int $default_state
*/
public function set_feature_default_state( $feature_name, $default_state ) {
$feature = $this->get_features( $feature_name );
if ( ! $feature ) {
return;
}
$this->features[ $feature_name ]['default'] = $default_state;
}
/**
* Get Feature Option Key
*
* @since 3.1.0
* @access public
*
* @param string $feature_name
*
* @return string
*/
public function get_feature_option_key( $feature_name ) {
return 'elementor_experiment-' . $feature_name;
}
private function add_default_features() {
$this->add_feature( [
'name' => 'e_dom_optimization',
'title' => esc_html__( 'Optimized DOM Output', 'elementor' ),
'description' => esc_html__( 'Developers, Please Note! This experiment includes some markup changes. If you\'ve used custom code in Elementor, you might have experienced a snippet of code not running. Turning this experiment off allows you to keep prior Elementor markup output settings, and have that lovely code running again.', 'elementor' )
. ' <a href="https://go.elementor.com/wp-dash-legacy-optimized-dom" target="_blank">'
. esc_html__( 'Learn More', 'elementor' ) . '</a>',
'release_status' => self::RELEASE_STATUS_STABLE,
'new_site' => [
'default_active' => true,
'minimum_installation_version' => '3.1.0-beta',
],
] );
$this->add_feature( [
'name' => 'e_optimized_assets_loading',
'title' => esc_html__( 'Improved Asset Loading', 'elementor' ),
'description' => esc_html__( 'Please Note! The "Improved Asset Loading" mode reduces the amount of code that is loaded on the page by default. When activated, parts of the infrastructure code will be loaded dynamically, only when needed. Keep in mind that activating this experiment may cause conflicts with incompatible plugins.', 'elementor' )
. ' <a href="https://go.elementor.com/wp-dash-improved-asset-loading/" target="_blank">'
. esc_html__( 'Learn More', 'elementor' ) . '</a>',
'release_status' => self::RELEASE_STATUS_BETA,
'new_site' => [
'default_active' => true,
'minimum_installation_version' => '3.2.0-beta',
],
] );
$this->add_feature( [
'name' => 'e_optimized_css_loading',
'title' => esc_html__( 'Improved CSS Loading', 'elementor' ),
'description' => 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' )
. ' <a href="https://go.elementor.com/wp-dash-improved-css-loading/" target="_blank">'
. esc_html__( 'Learn More', 'elementor' ) . '</a>',
'release_status' => self::RELEASE_STATUS_BETA,
'new_site' => [
'default_active' => true,
'minimum_installation_version' => '3.3.0-beta',
],
] );
$this->add_feature( [
'name' => 'e_font_icon_svg',
'title' => esc_html__( 'Inline Font Icons', 'elementor' ),
'description' => esc_html__( 'The “Inline Font Icons” will render the icons as inline SVG without loading the Font-Awsome and the eicons libraries and its related CSS files and fonts. Learn More.', 'elementor' )
. ' <a href="https://go.elementor.com/wp-dash-inline-font-awesome/" target="_blank">'
. esc_html__( 'Learn More', 'elementor' ) . '</a>',
'release_status' => self::RELEASE_STATUS_ALPHA,
] );
$this->add_feature( [
'name' => 'a11y_improvements',
'title' => esc_html__( 'Accessibility Improvements', 'elementor' ),
'description' => esc_html__( 'An array of accessibility enhancements in Elementor pages.', 'elementor' )
. '<br><strong>' . esc_html__( 'Please note!', 'elementor' ) . '</strong> ' . esc_html__( 'These enhancements may include some markup changes to existing elementor widgets', 'elementor' )
. ' <a href="https://go.elementor.com/wp-dash-a11y-improvements" target="_blank">'
. esc_html__( 'Learn More', 'elementor' ) . '</a>',
'release_status' => self::RELEASE_STATUS_STABLE,
'new_site' => [
'default_active' => true,
'minimum_installation_version' => '3.1.0-beta',
],
] );
$this->add_feature( [
'name' => 'e_import_export',
'title' => esc_html__( 'Import Export Template Kit', 'elementor' ),
'description' => esc_html__( 'Design sites faster with a template kit that contains some or all components of a complete site, like templates, content & site settings.', 'elementor' )
. '<br>'
. esc_html__( 'You can import a kit and apply it to your site, or export the elements from this site to be used anywhere else.', 'elementor' ),
'release_status' => self::RELEASE_STATUS_STABLE,
'default' => self::STATE_ACTIVE,
'new_site' => [
'default_active' => true,
'minimum_installation_version' => '3.2.0-beta',
],
] );
$this->add_feature( [
'name' => 'additional_custom_breakpoints',
'title' => esc_html__( 'Additional Custom Breakpoints', 'elementor' ),
'description' => esc_html__( 'Get pixel-perfect design for every screen size. You can now add up to 6 customizable breakpoints beyond the default desktop setting: mobile, mobile extra, tablet, tablet extra, laptop, and widescreen.', 'elementor' )
. '<br /><strong>' . esc_html__( 'Please note! Conditioning controls on values of responsive controls is not supported when this mode is active.', 'elementor' ) . '</strong>'
. ' <a href="https://go.elementor.com/wp-dash-additional-custom-breakpoints/" target="_blank">'
. esc_html__( 'Learn More', 'elementor' ) . '</a>',
'release_status' => self::RELEASE_STATUS_BETA,
'new_site' => [
'default_active' => true,
'minimum_installation_version' => '3.4.0-beta',
],
] );
$this->add_feature( [
'name' => 'e_hidden_wordpress_widgets',
'title' => esc_html__( 'Hide native WordPress widgets from search results', 'elementor' ),
'description' => esc_html__( 'WordPress widgets will not be shown when searching in the editor panel. Instead, these widgets can be found in the “WordPress” dropdown at the bottom of the panel.', 'elementor' ),
'release_status' => self::RELEASE_STATUS_STABLE,
'default' => self::STATE_ACTIVE,
] );
$this->add_feature( [
'name' => 'admin_menu_rearrangement',
'mutable' => false,
] );
$this->add_feature( [
'name' => 'container',
'title' => esc_html__( 'Flexbox Container', 'elementor' ),
'description' => sprintf( esc_html__(
'Create advanced layouts and responsive designs with the new Flexbox Container element.
This experiment replaces the current section/column structure, but you\'ll still keep your existing
Sections, Inner Sections and Columns and be able to edit them. %1$sLearn More%2$s',
'elementor'
), '<a target="_blank" href="https://go.elementor.com/wp-dash-flex-container">', '</a>' ),
'release_status' => self::RELEASE_STATUS_ALPHA,
'default' => self::STATE_INACTIVE,
] );
}
/**
* Init States
*
* @since 3.1.0
* @access private
*/
private function init_states() {
$this->states = [
self::STATE_DEFAULT => esc_html__( 'Default', 'elementor' ),
self::STATE_ACTIVE => esc_html__( 'Active', 'elementor' ),
self::STATE_INACTIVE => esc_html__( 'Inactive', 'elementor' ),
];
}
/**
* Init Statuses
*
* @since 3.1.0
* @access private
*/
private function init_release_statuses() {
$this->release_statuses = [
self::RELEASE_STATUS_DEV => esc_html__( 'Development', 'elementor' ),
self::RELEASE_STATUS_ALPHA => esc_html__( 'Alpha', 'elementor' ),
self::RELEASE_STATUS_BETA => esc_html__( 'Beta', 'elementor' ),
self::RELEASE_STATUS_RC => esc_html__( 'Release Candidate', 'elementor' ),
self::RELEASE_STATUS_STABLE => esc_html__( 'Stable', 'elementor' ),
];
}
/**
* Init Features
*
* @since 3.1.0
* @access private
*/
private function init_features() {
$this->features = [];
$this->add_default_features();
do_action( 'elementor/experiments/default-features-registered', $this );
}
/**
* Register Settings Fields
*
* @param Settings $settings
*
* @since 3.1.0
* @access private
*
*/
private function register_settings_fields( Settings $settings ) {
$features = $this->get_features();
$fields = [];
foreach ( $features as $feature_name => $feature ) {
if ( ! $feature['mutable'] ) {
unset( $features[ $feature_name ] );
continue;
}
$feature_key = 'experiment-' . $feature_name;
$section = 'stable' === $feature['release_status'] ? 'stable' : 'ongoing';
$fields[ $section ][ $feature_key ]['label'] = $this->get_feature_settings_label_html( $feature );
$fields[ $section ][ $feature_key ]['field_args'] = $feature;
$fields[ $section ][ $feature_key ]['render'] = function( $feature ) {
$this->render_feature_settings_field( $feature );
};
}
foreach ( [ 'stable', 'ongoing' ] as $section ) {
if ( ! isset( $fields[ $section ] ) ) {
$fields[ $section ]['no_features'] = [
'label' => esc_html__( 'No available experiments', 'elementor' ),
'field_args' => [
'type' => 'raw_html',
'html' => esc_html__( 'The current version of Elementor doesn\'t have any experimental features . if you\'re feeling curious make sure to come back in future versions.', 'elementor' ),
],
];
}
if ( ! Tracker::is_allow_track() && 'stable' === $section ) {
$fields[ $section ] += $settings->get_usage_fields();
}
}
$settings->add_tab(
'experiments', [
'label' => esc_html__( 'Experiments', 'elementor' ),
'sections' => [
'ongoing_experiments' => [
'callback' => function() {
$this->render_settings_intro();
},
'fields' => $fields['ongoing'],
],
'stable_experiments' => [
'callback' => function() {
$this->render_stable_section_title();
},
'fields' => $fields['stable'],
],
],
]
);
}
private function render_stable_section_title() {
?>
<hr>
<h2>
<?php echo esc_html__( 'Stable Features', 'elementor' ); ?>
</h2>
<?php
}
/**
* Render Settings Intro
*
* @since 3.1.0
* @access private
*/
private function render_settings_intro() {
?>
<h2>
<?php echo esc_html__( 'Elementor Experiments', 'elementor' ); ?>
</h2>
<p class="e-experiment__description">
<?php
printf(
/* translators: %1$s Link open tag, %2$s: Link close tag. */
esc_html__( 'Access new and experimental features from Elementor before they\'re officially released. As these features are still in development, they are likely to change, evolve or even be removed altogether. %1$sLearn More.%2$s', 'elementor' ),
'<a href="https://go.elementor.com/wp-dash-experiments/" target="_blank">',
'</a>'
);
?>
</p>
<p class="e-experiment__description">
<?php echo esc_html__( 'To use an experiment on your site, simply click on the dropdown next to it and switch to Active. You can always deactivate them at any time.', 'elementor' ); ?>
</p>
<p class="e-experiment__description">
<?php
printf(
/* translators: %1$s Link open tag, %2$s: Link close tag. */
esc_html__( 'Your feedback is important - %1$shelp us%2$s improve these features by sharing your thoughts and inputs.', 'elementor' ),
'<a href="https://go.elementor.com/wp-dash-experiments-report-an-issue/" target="_blank">',
'</a>'
);
?>
</p>
<?php if ( $this->get_features() ) { ?>
<button type="button" class="button e-experiment__button" value="active">Activate All Experiments</button>
<button type="button" class="button e-experiment__button" value="inactive">Deactivate All Experiments</button>
<?php } ?>
<hr>
<h2 class="e-experiment__table-title">
<?php echo esc_html__( 'Ongoing Experiments', 'elementor' ); ?>
</h2>
<?php
}
/**
* Render Feature Settings Field
*
* @since 3.1.0
* @access private
*
* @param array $feature
*/
private function render_feature_settings_field( array $feature ) {
?>
<div class="e-experiment__content">
<select id="e-experiment-<?php echo $feature['name']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>" class="e-experiment__select" name="<?php echo $this->get_feature_option_key( $feature['name'] ); ?>">
<?php foreach ( $this->states as $state_key => $state_title ) { ?>
<option value="<?php echo $state_key; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>" <?php selected( $state_key, $feature['state'] ); ?>><?php echo $state_title; ?></option>
<?php } ?>
</select>
<p class="description"><?php echo $feature['description']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></p>
<?php if ( 'stable' !== $feature['release_status'] ) { ?>
<div class="e-experiment__status"><?php echo sprintf( esc_html__( 'Status: %s', 'elementor' ), $this->release_statuses[ $feature['release_status'] ] ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></div>
<?php } ?>
</div>
<?php
}
/**
* Get Feature Settings Label HTML
*
* @since 3.1.0
* @access private
*
* @param array $feature
*
* @return string
*/
private function get_feature_settings_label_html( array $feature ) {
ob_start();
$is_feature_active = $this->is_feature_active( $feature['name'] );
$indicator_classes = 'e-experiment__title__indicator';
if ( $is_feature_active ) {
$indicator_classes .= ' e-experiment__title__indicator--active';
}
$indicator_tooltip = $this->get_feature_state_label( $feature );
?>
<div class="e-experiment__title">
<div class="<?php echo $indicator_classes; ?>" data-tooltip="<?php echo $indicator_tooltip; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>"></div>
<label class="e-experiment__title__label" for="e-experiment-<?php echo $feature['name']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>"><?php echo $feature['title']; ?></label>
</div>
<?php
return ob_get_clean();
}
/**
* Get Feature State Label
*
* @param array $feature
*
* @return string
*/
public function get_feature_state_label( array $feature ) {
$is_feature_active = $this->is_feature_active( $feature['name'] );
if ( self::STATE_DEFAULT === $feature['state'] ) {
$label = $is_feature_active ? esc_html__( 'Active by default', 'elementor' ) :
esc_html__( 'Inactive by default', 'elementor' );
} else {
$label = self::STATE_ACTIVE === $feature['state'] ? esc_html__( 'Active', 'elementor' ) :
esc_html__( 'Inactive', 'elementor' );
}
return $label;
}
/**
* Get Feature Settings Label HTML
*
* @since 3.1.0
* @access private
*
* @param string $feature_name
*
* @return int
*/
private function get_saved_feature_state( $feature_name ) {
return get_option( $this->get_feature_option_key( $feature_name ) );
}
/**
* Get Feature Actual State
*
* @since 3.1.0
* @access private
*
* @param array $feature
*
* @return string
*/
private function get_feature_actual_state( array $feature ) {
if ( self::STATE_DEFAULT !== $feature['state'] ) {
return $feature['state'];
}
return $feature['default'];
}
/**
* On Feature State Change
*
* @since 3.1.0
* @access private
*
* @param array $old_feature_data
* @param string $new_state
*/
private function on_feature_state_change( array $old_feature_data, $new_state ) {
$this->features[ $old_feature_data['name'] ]['state'] = $new_state;
$new_feature_data = $this->get_features( $old_feature_data['name'] );
$actual_old_state = $this->get_feature_actual_state( $old_feature_data );
$actual_new_state = $this->get_feature_actual_state( $new_feature_data );
if ( $actual_old_state === $actual_new_state ) {
return;
}
Plugin::$instance->files_manager->clear_cache();
if ( $new_feature_data['on_state_change'] ) {
$new_feature_data['on_state_change']( $actual_old_state, $actual_new_state );
}
}
public function __construct() {
$this->init_states();
$this->init_release_statuses();
$this->init_features();
add_action( 'admin_init', function () {
System_Info::add_report(
'experiments', [
'file_name' => __DIR__ . '/experiments-reporter.php',
'class_name' => __NAMESPACE__ . '\Experiments_Reporter',
]
);
}, 79 /* Before log */ );
if ( is_admin() ) {
$page_id = Settings::PAGE_ID;
add_action( "elementor/admin/after_create_settings/{$page_id}", function( Settings $settings ) {
$this->register_settings_fields( $settings );
}, 11 );
}
// Register CLI commands.
if ( Utils::is_wp_cli() ) {
\WP_CLI::add_command( 'elementor experiments', WP_CLI::class );
}
}
}
Zerion Mini Shell 1.0