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 Name | Changes 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 Name | Changes 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 Name | Changes 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 Name | Changes 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 Name | Changes 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 Name | Changes 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 / Filter | Changes 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 / Filter | Changes 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 Alias | Changes 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 Name | Changes 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.