v3.4: Planned Deprecations

Hey all! We are getting ready to release version 3.4.

If you are a developer who extends Elementor please review the below changes to keep your plugin up and running.

Here are the planned deprecations:

PHP

Functions & Methods

Hard Deprecation

When a function/method is on hard deprecation phase, it means that the function/method will still work while it’s in this phase, but will add a PHP notice if the website WP_DEBUG property is set to true.

Function / Method NameChanges made
Controls_Stack::_register_controls()

Core Plugin
Replaced by:
Controls_Stack::register_controls()

Located in: includes/base/controls-stack.php

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
Controls_Stack::get_style_controls()

Core Plugin
Replaced by: None

Located in: includes/base/controls-stack.php

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
Controls_Stack::get_active_controls()

Core Plugin
Replaced by: None

Located in: includes/base/controls-stack.php

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
Controls_Stack::get_scheme_controls()

Core Plugin
Replaced by: None

Located in: includes/base/controls-stack.php

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
Settings::update_css_print_method()

Core Plugin
Replaced by: None

Located in: includes/settings/settings.php

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
Skin_Base::render_date()

Pro Plugin
Replaced by:
Skin_Base::render_date_by_type()

Located in: modules/posts/skins/skin-base.php

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0

Deletion

When a function/method is on deletion phase, it means that the function/method will not work anymore, and will most likely throw a Fatal Error when it’s called.

Function / Method NameChanges made
Utils::is_ajax()

Core Plugin
Replaced by:
wp_doing_ajax()

Located in: includes/utils.php

Soft deprecation Version: 2.6.0

Hard deprecation Version: 3.0.0
Core\Files\Assets\Svg\Svg_Handler::svg_sanitizer_can_run()

Core Plugin
Replaced by:
Core\Files\Assets\Files_Upload_Handler::file_sanitizer_can_run()

Located in: core/files/assets/svg/svg-handler.php

Soft deprecation Version: 3.0.0

Hard deprecation Version: 3.0.0
Core\Files\Assets\Svg\Svg_Handler::is_svg_uploads_enabled()

Core Plugin
Replaced by:
Core\Files\Assets\Files_Upload_Handler::is_enabled()

Located in: core/files/assets/svg/svg-handler.php

Soft deprecation Version: 3.0.0

Hard deprecation Version: 3.0.0
Core\Files\Assets\Svg\Svg_Handler::upload_mimes()

Core Plugin
Replaced by: None

Located in: core/files/assets/svg/svg-handler.php

Soft deprecation Version: 3.0.0

Hard deprecation Version: 3.0.0
Core\Files\Assets\Svg\Svg_Handler::wp_handle_upload_prefilter()

Core Plugin
Replaced by: None

Located in: core/files/assets/svg/svg-handler.php

Soft deprecation Version: 3.0.0

Hard deprecation Version: 3.0.0
Icons_Manager::register_ajax_actions()

Core Plugin
Replaced by: None

Located in: includes/managers/icons.php

Soft deprecation Version: 3.0.0

Hard deprecation Version: 3.0.0
Icons_Manager::ajax_enable_svg_uploads()

Core Plugin
Replaced by: None

Located in: includes/managers/icons.php

Soft deprecation Version: 3.0.0

Hard deprecation Version: 3.0.0
Core\Files\CSS\Post_Preview::get_preview_id()

Core Plugin
Replaced by: Core\Files\CSS\Post_Preview::get_post_id_for_data()

Located in: core/files/css/post-preview.php

Soft deprecation Version: 3.0.0

Hard deprecation Version: 3.0.0

PHP Classes

Hard Deprecation

Class nameChanges Made
core/settings/general/manager.php

Core Plugin
Replaced by:
Use Kit document via Plugin::$instance->kits_manager->get_active_kit_for_frontend()

Located in: core/settings/general/manager.php

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
core/settings/general/model.php

Core Plugin
Replaced by:
Use Kit document via Plugin::$instance->kits_manager->get_active_kit_for_frontend()

Located in: core/settings/general/model.php

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0

PHP Files

Hard Deprecation

FileChanges Made
includes/libraries/wp-background-process/wp-async-request.php

Core Plugin
Replaced by:
\Elementor\Core\Base\BackgroundProcess\WP_Async_Request

Soft deprecation Version:3.0.7

Deletion Version: 3.8.0
includes/libraries/wp-background-process/wp-background-process.php

Core Plugin
Replaced by:
\Elementor\Core\Base\BackgroundProcess\WP_Background_Process

Soft deprecation Version:3.0.7

Deletion Version: 3.8.0

PHP Vars

Soft Deprecation

When a function/method is in the soft deprecation phase, it means that the function/method will still work while it’s in this phase, but a comment will be placed in the code mentioning the upcoming deprecation.

Function / Method NameChanges Made
Controls_Stack::RESPONSIVE_DESKTOP

Core Plugin
Replaced by:
Core\Breakpoints\Manager::BREAKPOINT_KEY_DESKTOP

Located in: includes\base\controls-stack.php

Hard deprecation Version: 3.8.0

Deletion version: 4.2.0
Controls_Stack::RESPONSIVE_TABLET

Core Plugin
Replaced by:
Core\Breakpoints\Manager::BREAKPOINT_KEY_TABLET

Located in: includes\base\controls-stack.php

Hard deprecation Version: 3.8.0

Deletion version: 4.2.0
Controls_Stack::RESPONSIVE_MOBILE

Core Plugin
Replaced by:
Core\Breakpoints\Manager::BREAKPOINT_KEY_MOBILE

Located in: includes\base\controls-stack.php

Hard deprecation Version: 3.8.0

Deletion version: 4.2.0

Hard Deprecation

Function / Method NameChanges Made
$args['scheme']

Core Plugin
Replaced by:
$args['global']

Located in: /includes/base/controls-stack.php

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0

Note: The scheme property used in add_control. Schemes are replaced by Globals

WP Options

Hard Deprecation

Option NameChanges Made
elementor_default_generic_fonts

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'default_generic_fonts' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_container_width

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'container_width' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_space_between_widgets

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'space_between_widgets' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_stretched_section_container

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'stretched_section_container' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_page_title_selector

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'page_title_selector' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_global_image_lightbox

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'global_image_lightbox' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_enable_counter

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_enable_counter' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_enable_fullscreen

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_enable_fullscreen' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_enable_zoom

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_enable_zoom' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_enable_share

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_enable_share' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_title_src

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_title_src' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_description_src

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_description_src' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_color

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_color' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_ui_color

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_ui_color' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_ui_color_hover

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_ui_color_hover' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
elementor_lightbox_text_color

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_text_color' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
lightbox_icons_size

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_icons_size' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0
lightbox_slider_icons_size

Core Plugin
Replaced by:
Plugin::$instance->kits_manager->get_current_settings( 'lightbox_slider_icons_size' )

Soft deprecation Version: 3.0.0

Deletion version: 3.8.0

PHP Hooks

Deletion

elementor_pro/query_control/get_autocompleteChanges Made
elementor_pro/query_control/get_autocomplete/{$name}

Type: Filter

Pro Plugin
Replaced by:
elementor/query/get_autocomplete/{$name}

Soft deprecation Version: 2.6.0

Hard deprecation Version: 3.0.0
elementor_pro/query_control/get_value_titles/{$name}

Type: Filter

Pro Plugin
Replaced by:
elementor/query/get_value_titles/{$name}

Soft deprecation Version: 2.6.0

Hard deprecation Version: 3.0.0

Class Aliases

Deletion

Alias NameChanges Made
Elementor\Editor

Core Plugin
Replaced by:
Elementor\Core\Editor\Editor

Soft deprecation Version: 2.6.0

Hard deprecation Version: 3.0.0

JS

Functions & Methods

Soft Deprecation

Function / Method NameChanges Made
elementor.helpers.document.isValidChild

Core Plugin
Replaced by:
$e.components.get( 'document/elements' ).utils.isValidChild()

Located in: assets/dev/js/editor/document/helper.js

Hard deprecation Version:3.8.0

Deletion Version: 4.2.0
elementor.helpers.document.isValidGrandChild

Core Plugin
Replaced by:
$e.components.get( 'document/elements' ).utils.isValidGrandChild()

Located in: assets/dev/js/editor/document/helper.js

Hard deprecation Version:3.8.0

Deletion Version: 4.2.0
elementor.helpers.document.isSameElement

Core Plugin
Replaced by:
$e.components.get( 'document/elements' ).utils.isSameElement()

Located in: assets/dev/js/editor/document/helper.js

Hard deprecation Version:3.8.0

Deletion Version: 4.2.0
elementor.helpers.document.getPasteOptions

Core Plugin
Replaced by:
$e.components.get( 'document/elements' ).utils.getPasteOptions()

Located in: assets/dev/js/editor/document/helper.js

Hard deprecation Version:3.8.0

Deletion Version: 4.2.0
elementor.helpers.document.isPasteEnabled

Core Plugin
Replaced by:
$e.components.get( 'document/elements' ).utils.isPasteEnabled()
Located in: assets/dev/js/editor/document/helper.js

Hard deprecation Version:3.8.0

Deletion Version: 4.2.0

Hard Deprecation

Function / Method NameChanges Made
elementorFrontend.getGeneralSettings()

Core Plugin
Replaced by:
elementorFrontend.getKitSettings()

Located in: assets/dev/js/frontend/frontend.js

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
onReady()

Core Plugin
Replaced by: None

Located in: assets/dev/js/editor/controls/select2.js

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
elementor.helpers.getUniqueID()

Core Plugin
Replaced by:
elementorCommon.helpers.getUniqueId();

Located in: assets/dev/js/editor/utils/helpers.js

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
Repeater.collection.add ./ Repeater.updateContainer

Core Plugin
Replaced by:
e.run( 'document/repeater/insert' )

Located in: assets/dev/js/editor/controls/repeater.js

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0
Repeater.collection.reset / Repeater.resetContainer

Core Plugin
Replaced by:
e.run( 'document/repeater/remove' )

Located in: assets/dev/js/editor/controls/repeater.js

Soft deprecation Version:3.0.0

Deletion Version: 3.8.0

Author

Picture of Shilo Eish Yemini
Shilo Eish Yemini
Shilo is Elementor’s Editor Product Lead. He loves innovative products, pays attention to the small details, and is passionate about solving puzzles.