v3.4: Planned Deprecations

Shilo Eish Yemini
July 27, 2021
Deprecations
Elementor 3.4

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 Name	Changes 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 Name	Changes 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 name	Changes 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

File	Changes 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 Name	Changes 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 Name	Changes 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 Name	Changes 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_autocomplete	Changes 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 Name	Changes 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 Name	Changes 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 Name	Changes 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`

Developer Newsletter

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

Author

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.