v3.0: Planned Deprecations

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

Elementor 3.0 will introduce many changes to the way our users build websites with Elementor, and the way Elementor operates.

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

Elementor 3.0 is a major release. We took the opportunity to introduce substantial changes and improvements to the infrastructure of Elementor.

Here are the planned deprecations (last update – 09/06/2020):

PHP

Functions & Methods

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::_register_controls()

Core Plugin
Replaced by: Controls_Stack::register_controls()

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
Controls_Stack::get_style_controls()

Core Plugin
Replaced by: None

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
Controls_Stack::get_active_controls()

Core Plugin
Replaced by: None

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
Controls_Stack::get_scheme_controls()

Core Plugin
Replaced by: None

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
Settings::update_css_print_method()

Core Plugin
Replaced by: None

Located in: includes/settings/settings.php

Hard deprecation Version: 3.4.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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0

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
Utils::is_ajax()

Core Plugin
Replaced by: wp_doing_ajax()

Located in: includes/utils.php

In Soft deprecation since: 2.6.0

Deletion version: 3.4.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

Deletion version: 3.4.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

Deletion version: 3.4.0
Core\Files\Assets\Svg\Svg_Handler::upload_mimes()

Core Plugin
Replaced by: None

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

Deletion version: 3.4.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

Deletion version: 3.4.0
Icons_Manager::register_ajax_actions()

Core Plugin
Replaced by: None

Located in: includes/managers/icons.php

Deletion version: 3.4.0
Icons_Manager::ajax_enable_svg_uploads()

Core Plugin
Replaced by: None

Located in: includes/managers/icons.php

Deletion version: 3.4.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

Deletion version: 3.4.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
Classes\Utils::get_the_archive_title()

Pro Plugin
Replaced by: Classes\Utils::get_page_title()

Located in: classes/utils.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
Controls_Stack::get_class_controls()

Core Plugin
Replaced by: None

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

In soft deprecation since: 2.1.0

In hard deprecation since: 2.6.0
Core\Base\Document::save_type()

Core Plugin
Replaced by: Core\Base\Document::save_template_type()

Located in: core/base/document.php

In soft deprecation since: 2.2.0

In hard deprecation since: 2.6.0
Core\Files\CSS\Base::get_css()

Core Plugin
Replaced by: Core\Files\CSS\Base::get_content()

Located in: core/files/css/base.php

In soft deprecation since: 2.1.0

In hard deprecation since: 2.6.0
Core\Settings\Page\Manager::is_cpt_custom_templates_supported()

Core Plugin
Replaced by: Utils::is_cpt_custom_templates_supported()

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

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
DB::_get_new_editor_from_wp_editor()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->convert_to_elementor()

Located in: includes/db.php

In soft deprecation since: 2.1.0

In hard deprecation since: 2.6.0
DB::get_newer_autosave()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->get_newer_autosave()

Located in: includes/db.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
DB::get_plain_editor()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->get_elements_data()

Located in: includes/db.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
DB::save_editor()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->save()

Located in: includes/db.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
Modules\ThemeBuilder\Classes\Conditions_Manager::get_theme_templates_by_location()

Pro Plugin
Replaced by: Modules\ThemeBuilder\Classes\Conditions_Manager::get_location_templates()

Located in: modules/theme-builder/classes/conditions-manager.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
Plugin::get_version()

Pro Plugin
Replaced by: ELEMENTOR_PRO_VERSION

Located in: plugin.php

In soft deprecation since: 1.1.0

In hard deprecation since: 2.6.0
Skin_Base::_content_template()

Core Plugin
Replaced by: None

Located in: includes/base/skin-base.php

In soft deprecation since: 1.7.6

In hard deprecation since: 2.6.0
Utils::get_edit_link()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->get_edit_url()

Located in: includes/utils.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
Utils::get_exit_to_dashboard_url()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->get_exit_to_dashboard_url()

Located in: includes/utils.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
Utils::get_last_edited()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->get_last_edited()

Located in: includes/utils.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
Utils::get_preview_url()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->get_preview_url()

Located in: includes/utils.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
Utils::get_wp_preview_url()

Core Plugin
Replaced by: Plugin::$instance->documents->get( $post_id )->get_wp_preview_url()

Located in: includes/utils.php

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0

PHP Classes

Soft Deprecation

Class NameChanges Made
Elementor\Core\Settings\General\Manager

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

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
Elementor\Core\Settings\General\Model

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

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0

PHP Files

Soft Deprecation

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

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

Hard deprecation Version: 3.4.0

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0

WP Options

Soft Deprecation

Option NameChanges Made
elementor_default_generic_fonts

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_container_width

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_space_between_widgets

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_stretched_section_container

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_page_title_selector

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_global_image_lightbox

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_enable_counter

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_enable_fullscreen

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_enable_zoom

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_enable_share

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_title_src

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_description_src

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_color

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_ui_color

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

Hard deprecation Version: 3.4.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' )

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
elementor_lightbox_text_color

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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
lightbox_icons_size

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

Hard deprecation Version: 3.4.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' )

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0

Actions and Filters

Hard Deprecation

Action / FilterChanges Made
elementor_pro/query_control/get_autocomplete/{$name}

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

Type: Filter

In soft deprecation since: 2.6.0

Deletion: 3.4.0
elementor_pro/query_control/get_value_titles/{$name}

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

Type: Filter

In soft deprecation since: 2.6.0

Deletion: 3.4.0

Deletion

Action / FilterChanges Made
elementor/{$settings_name}/settings/success_response_data

Core Plugin
Replaced by: elementor/settings/{$settings_name}/success_response_data

Type: Filter

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
elementor/utils/get_edit_link

Core Plugin
Replaced by: elementor/document/urls/edit

Type: Filter

In soft deprecation since: 2.0.0

In hard deprecation since:  2.6.0
elementor/utils/preview_url

Core Plugin
Replaced by: elementor/document/urls/preview

Type: Filter

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
elementor/utils/wp_preview_url

Core Plugin
Replaced by: elementor/document/urls/wp_preview

Type: Filter

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
elementor/{$name}-css-file/enqueue

Core Plugin
Replaced by: elementor/css-file/{$name}/enqueue

Type: Action

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0
elementor/{$name}-css-file/parse

Core Plugin
Replaced by: elementor/css-file/{$name}/parse

Type: Action

In soft deprecation since: 2.0.0

In hard deprecation since: 2.6.0

Class Aliases

Hard Deprecation

Class AliasChanges Made
Elementor\Editor

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

In soft deprecation since: 2.6.0

Deletion: 3.4.0

JavaScript

Functions & Methods

Soft Deprecation

Function / Method NameChanges Made
elementorFrontend.getGeneralSettings()

Core Plugin
Replaced by: elementorFrontend.getKitSettings()

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

Hard deprecation Version: 3.4.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

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0
onReady()

Core Plugin
Replaced by: None

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

Hard deprecation Version: 3.4.0

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

Core Plugin
Replaced by: container.addRepeaterItem

Located in: repeater.js

Hard deprecation Version: 3.4.0

Deletion version: 3.8.0

You can download the latest release of Elementor Core from WordPress repository, and the latest release of Elementor Pro from your Elementor dashboard.

If you spot any issues, please log them in detail on Github.

Beta version supposed to be published during July 2020.

Developer Newsletter

Stay up to date on the latest developer news, product updates, and best practices.

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.