v3.5: Planned Deprecations

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

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

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
register_widget_type()

Core Plugin
Replaced by: register()

Located in: includes/managers/widgets.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
unregister_widget_type()

Core Plugin
Replaced by: unregister()

Located in: includes/managers/widgets.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
register_control()

Core Plugin
Replaced by: register()

Located in: includes/managers/controls.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
unregister_control()

Core Plugin
Replaced by: unregister()

Located in: includes/managers/controls.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
register_tag()

Core Plugin
Replaced by: register()

Located in: core/dynamic-tags/manager.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
unregister_tag()

Core Plugin
Replaced by: unregister()

Located in: core/dynamic-tags/manager.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
add_category()

Core Plugin
Replaced by: register()

Located in:
core/common/modules/finder/categories-manager.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
add_form_action()

Pro Plugin
Replaced by: actions_manager->register()

Located in: modules/forms/module.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
get_form_actions()

Pro Plugin
Replaced by: actions_manager->get()

Located in: modules/forms/module.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.0
add_form_field_type()

Pro Plugin
Replaced by: actions_manager->register()

Located in: modules/forms/module.php

Hard deprecation Version: 3.9.0

Deletion version: 4.3.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
localize_settings()

Core Plugin
Replaced by: None

Located in:
core/common/modules/connect/module.php
core/dynamic-tags/manager.php
modules/history/module.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
admin_localize_settings()

Core Plugin
Replaced by: None

Located in: core/upgrade/elementor-3-re-migrate-globals.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
add_admin_strings()

Core Plugin
Replaced by: None

Located in: includes/managers/icons.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
editor_settings()

Core Plugin
Replaced by: None

Located in: modules/history/revisions-manager.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
localize_settings()

Pro Plugin
Replaced by: None

Located in:
modules/assets-manager/module.php
modules/custom-css/module.php
modules/forms/module.php
modules/library/module.php
modules/popup/module.php
modules/query-control/module.php
modules/table-of-contents/module.php
modules/theme-builder/module.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
_print_content()

Core Plugin
Replaced by: print_content()

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

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
_add_render_attributes()

Core Plugin
Replaced by: add_render_attributes()

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

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
_get_theme()

Core Plugin
Replaced by: get_themes()

Located in: modules/system-info/reporters/theme.phpincludes/base/element-base.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
_register_skins()

Core Plugin
Replaced by: register_skins()

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

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
_register_skins()

Core Plugin
Replaced by: register_skins()

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

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
get_builder()

Core Plugin
Replaced by: None

Located in: includes/db.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0
set_is_elementor_page()

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

Located in: includes/db.php

Soft deprecation Version: 3.1.0

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

Class nameChanges Made
TemplateLibrary\Manager::unregister_source()

Core Plugin
Replaced by: none

Located in: includes/template-library/manager.php

Soft deprecation Version: 2.7.0

Hard deprecation Version: 3.1.0
License\API::get_previous_package_url()

Pro Plugin
Replaced by: License\API::get_plugin_package_url()

Located in: license/admin.php

Soft deprecation Version: 2.7.0

Hard deprecation Version: 3.1.0

PHP Classes

Soft Deprecation

Class nameChanges Made
Elementor\Data

Core Plugin
Replaced by: Elementor\Data\V2

Located in: data/base/controller.php

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0

PHP Vars

Hard Deprecation

Var NameChanges Made
DB::STATUS_PUBLISH

Core Plugin
Replaced by: Document::STATUS_PUBLISH

Located in: includes/db.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0

DB::STATUS_DRAFT

Core Plugin
Replaced by: Document::STATUS_DRAFT

Located in: includes/db.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0

DB::STATUS_PRIVATE

Core Plugin
Replaced by: Document::STATUS_PRIVATE

Located in: includes/db.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0

DB::STATUS_AUTOSAVE

Core Plugin
Replaced by: Document::STATUS_AUTOSAVE

Located in: includes/db.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0

DB::STATUS_PENDING

Core Plugin
Replaced by: Document::STATUS_PENDING

Located in: includes/db.php

Soft deprecation Version: 3.1.0

Deletion version: 3.9.0

Deletion

Var NameChanges Made
Editor::EDITING_NONCE_KEY

Core Plugin
Replaced by: None

Located in: core\editor\editor.php

Soft deprecation Version: 2.3.0

Hard deprecation Version: 2.7.0
Plugin::$posts_css_manager

Core Plugin
Replaced by: None

Located in: includes/plugin.php

Soft deprecation Version: 2.1.0

Hard deprecation Version: 2.5.0
Plugin::$debugger

Core Plugin
Replaced by: None

Located in: includes/plugin.php

Soft deprecation Version: 2.1.2

Hard deprecation Version: 2.5.2
Plugin::$ajax

Core Plugin
Replaced by: None

Located in: includes/plugin.php

Soft deprecation Version: 2.3.0

Hard deprecation Version: 2.7.0

PHP Hooks

Soft Deprecation

Hook NameChanges Made
elementor/widgets/widgets_registered

Type: Action

Core Plugin
Replaced by: elementor/widgets/register

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
elementor/controls/controls_registered

Type: Action

Core Plugin
Replaced by: elementor/controls/register

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
elementor/dynamic_tags/register_tags

Type: Action

Core Plugin
Replaced by: elementor/dynamic_tags/register

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
elementor/finder/categories/init

Type: Action

Core Plugin
Replaced by: elementor/finder/categories/register

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
elementor_pro/forms/register_action

Type: Action

Pro Plugin
Replaced by: elementor_pro/forms/actions/register

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0

Deletion

JS

Functions & Methods

Soft Deprecation

Function / Method NameChanges Made
elementorPro.modules.globalWidget.getGlobalModels( id )

Pro Plugin
Replaced by:
$e.data.getCache( `document/global/global-widget/templates/${ id }` )

Located in: modules/global-widget/assets/js/editor/module.js

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
elementorPro.modules.globalWidget.saveTemplates()

Pro Plugin
Replaced by:
$e.internal( 'document/global/save-templates' )

Located in: modules/global-widget/assets/js/editor/module.js

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
elementorPro.modules.globalWidget.requestGlobalModelSettings()

Pro Plugin
Replaced by:
$e.data.get( 'document/global/templates' )

Located in: modules/global-widget/assets/js/editor/module.js

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
container.findChildrenRecursive

Core Plugin
Replaced by:
container.children.findRecursive

Located in: assets/dev/js/editor/container/container.js

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
container.forEachChildrenRecursive

Core Plugin
Replaced by:
container.children.forEachRecursive

Located in: assets/dev/js/editor/container/container.js

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0

Hard Deprecation

Function / Method NameChanges Made
hasThumbs()

Pro Plugin
Replaced by: None

Located in: modules/carousel/assets/js/frontend/handlers/media-carousel.js

Soft deprecation Version: 3.1.0

Deletion Version: 3.9.0

Modules

Hard Deprecation

Module NameChanges Made
Scroll

Pro Plugin
Replaced by: assets/dev/js/modules/imports/utils/scroll.js

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

Soft deprecation Version: 3.1.0

Deletion Version: 3.9.0

Info: Moved from pro to core.

Events

Soft Deprecation

Class nameChanges Made
elementorFrontend -> elementor/modules/init:before

Core Plugin
Replaced by: elementorFrontend -> elementor/modules/init/before

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
window -> elementor:init-components

Core Plugin
Replaced by: window -> elementor/init-components

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
window -> elementor:loaded

Core Plugin
Replaced by: window -> elementor/loaded

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0
window -> elementor:init

Core Plugin
Replaced by: window -> elementor/init

Hard deprecation Version: 3.9.0

Deletion Version: 4.3.0

Assets

Deletion

Alias NameChanges Made
jquery-slick

Core Plugin
Replaced by: swiper

Located in: assets/lib

Soft deprecation Version: 2.7.0

Hard deprecation Version: 3.1.0

Author

Picture of Rami Yushuvaev
Rami Yushuvaev
Head of Elementor Developers Experience. Fullstack developer. Open source projects contributor. Creator of ChartsCSS.org, GenerateWP.com, DisplayWP.com and many other projects.