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

Share on facebook
Share on twitter
Share on linkedin

Author

Dor Shahar
Dor Shahar
Dor is a Product Manager in the Editor team. He enjoys a good meal, whisky and finds home automations really interesting.

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *