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.phpHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
Controls_Stack::get_style_controls()Core Plugin | Replaced by: NoneLocated in: includes/base/controls-stack.phpHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
Controls_Stack::get_active_controls()Core Plugin | Replaced by: NoneLocated in: includes/base/controls-stack.phpHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
Controls_Stack::get_scheme_controls()Core Plugin | Replaced by: NoneLocated in: includes/base/controls-stack.phpHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
Settings::update_css_print_method()Core Plugin | Replaced by: NoneLocated in: includes/settings/settings.phpHard deprecation Version: 3.4.0Deletion 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.phpHard deprecation Version: 3.4.0Deletion 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.phpIn Soft deprecation since: 2.6.0Deletion 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.phpDeletion 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.phpDeletion version: 3.4.0 |
Core\Files\Assets\Svg\Svg_Handler::upload_mimes()Core Plugin | Replaced by: NoneLocated in: core/files/assets/svg/svg-handler.phpDeletion version: 3.4.0 |
Core\Files\Assets\Svg\Svg_Handler::wp_handle_upload_prefilter()Core Plugin | Replaced by: NoneLocated in: core/files/assets/svg/svg-handler.phpDeletion version: 3.4.0 |
Icons_Manager::register_ajax_actions()Core Plugin | Replaced by: NoneLocated in: includes/managers/icons.phpDeletion version: 3.4.0 |
Icons_Manager::ajax_enable_svg_uploads()Core Plugin | Replaced by: NoneLocated in: includes/managers/icons.phpDeletion 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.phpDeletion 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.phpIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
Controls_Stack::get_class_controls()Core Plugin | Replaced by: NoneLocated in: includes/base/controls-stack.phpIn soft deprecation since: 2.1.0In 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.phpIn soft deprecation since: 2.2.0In 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.phpIn soft deprecation since: 2.1.0In 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.phpIn soft deprecation since: 2.0.0In 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.phpIn soft deprecation since: 2.1.0In 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.phpIn soft deprecation since: 2.0.0In 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.phpIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
DB::save_editor()Core Plugin | Replaced by: Plugin::$instance->documents->get( $post_id )->save()Located in: includes/db.phpIn soft deprecation since: 2.0.0In 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.phpIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
Plugin::get_version()Pro Plugin | Replaced by: ELEMENTOR_PRO_VERSIONLocated in: plugin.phpIn soft deprecation since: 1.1.0In hard deprecation since: 2.6.0 |
Skin_Base::_content_template()Core Plugin | Replaced by: NoneLocated in: includes/base/skin-base.phpIn soft deprecation since: 1.7.6In 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.phpIn soft deprecation since: 2.0.0In 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.phpIn soft deprecation since: 2.0.0In 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.phpIn soft deprecation since: 2.0.0In 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.phpIn soft deprecation since: 2.0.0In 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.phpIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
PHP Classes
Soft Deprecation
| Class Name | Changes Made |
Elementor\Core\Settings\General\ManagerCore Plugin | Replaced by: Use Kit document via Plugin::$instance->kits_manager->get_active_kit_for_frontend()Located in: core/settings/general/manager.phpHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
Elementor\Core\Settings\General\ModelCore Plugin | Replaced by: Use Kit document via Plugin::$instance->kits_manager->get_active_kit_for_frontend()Located in: core/settings/general/model.phpHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
PHP Files
Soft Deprecation
| File Name | Changes Made |
includes/libraries/wp-background-process/wp-async-request.phpCore Plugin | Replaced by: \Elementor\Core\Base\BackgroundProcess\WP_Async_RequestHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
includes/libraries/wp-background-process/wp-background-process.phpCore Plugin | Replaced by: \Elementor\Core\Base\BackgroundProcess\WP_Background_ProcessHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
WP Options
Soft Deprecation
| Option Name | Changes Made |
elementor_default_generic_fontsCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'default_generic_fonts' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_container_widthCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'container_width' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_space_between_widgetsCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'space_between_widgets' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_stretched_section_containerCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'stretched_section_container' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_page_title_selectorCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'page_title_selector' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_global_image_lightboxCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'global_image_lightbox' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_enable_counterCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_enable_counter' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_enable_fullscreenCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_enable_fullscreen' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_enable_zoomCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_enable_zoom' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_enable_shareCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_enable_share' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_title_srcCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_title_src' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_description_srcCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_description_src' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_colorCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_color' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_ui_colorCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_ui_color' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_ui_color_hoverCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_ui_color_hover' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor_lightbox_text_colorCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_text_color' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
lightbox_icons_sizeCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_icons_size' )Hard deprecation Version: 3.4.0Deletion version: 3.8.0 |
lightbox_slider_icons_sizeCore Plugin | Replaced by: Plugin::$instance->kits_manager->get_current_settings( 'lightbox_slider_icons_size' )Hard deprecation Version: 3.4.0Deletion 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: FilterIn soft deprecation since: 2.6.0Deletion: 3.4.0 |
elementor_pro/query_control/get_value_titles/{$name}Pro Plugin | Replaced by: elementor/query/get_value_titles/{$name}Type: FilterIn soft deprecation since: 2.6.0Deletion: 3.4.0 |
Deletion
| Action / Filter | Changes Made |
elementor/{$settings_name}/settings/success_response_dataCore Plugin | Replaced by: elementor/settings/{$settings_name}/success_response_dataType: FilterIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
elementor/utils/get_edit_linkCore Plugin | Replaced by: elementor/document/urls/editType: FilterIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
elementor/utils/preview_urlCore Plugin | Replaced by: elementor/document/urls/previewType: FilterIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
elementor/utils/wp_preview_urlCore Plugin | Replaced by: elementor/document/urls/wp_previewType: FilterIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
elementor/{$name}-css-file/enqueueCore Plugin | Replaced by: elementor/css-file/{$name}/enqueueType: ActionIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
elementor/{$name}-css-file/parseCore Plugin | Replaced by: elementor/css-file/{$name}/parseType: ActionIn soft deprecation since: 2.0.0In hard deprecation since: 2.6.0 |
Class Aliases
Hard Deprecation
| Class Alias | Changes Made |
Elementor\EditorCore Plugin | Replaced by: Elementor\Core\Editor\EditorIn soft deprecation since: 2.6.0Deletion: 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.jsHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
elementor.helpers.getUniqueID()Core Plugin | Replaced by: elementorCommon.helpers.getUniqueId();Located in: assets/dev/js/editor/utils/helpers.jsHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
onReady()Core Plugin | Replaced by: NoneLocated in: assets/dev/js/editor/controls/select2.jsHard deprecation Version: 3.4.0Deletion version: 3.8.0 |
Repeater.collection.add / Repeater.updateContainerCore Plugin | Replaced by: container.addRepeaterItemLocated in: repeater.jsHard deprecation Version: 3.4.0Deletion 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.